/****************************************************************************** * * Copyright (C) 2015 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ***************************************************************************** * Originally developed and contributed by Ittiam Systems Pvt. Ltd, Bangalore */ /** ****************************************************************************** * @file * ih264e_trace.h * * @brief * This file contains extern declarations of routines that could be helpful * for debugging purposes. * * @author * ittiam * * @remarks * None * ******************************************************************************* */ #ifndef IH264E_TRACE_H_ #define IH264E_TRACE_H_ #if ENABLE_TRACE /*****************************************************************************/ /* Structures */ /*****************************************************************************/ /** ****************************************************************************** * @brief Data for the trace functionality ****************************************************************************** */ typedef struct { /** * fp */ FILE *fp; }enc_trace_t; /*****************************************************************************/ /* Extern variable declarations */ /*****************************************************************************/ extern enc_trace_t g_enc_trace; /*****************************************************************************/ /* Constant Macros */ /*****************************************************************************/ /** ****************************************************************************** * @brief defines flag used for enabling trace ****************************************************************************** */ /*****************************************************************************/ /* Function Macros */ /*****************************************************************************/ /** ****************************************************************************** * @brief Macro to print trace messages ****************************************************************************** */ #define ENTROPY_TRACE(syntax_string, value) \ { \ if(g_enc_trace.fp) \ { \ fprintf( g_enc_trace.fp, "%-40s : %d\n", syntax_string, value ); \ fflush ( g_enc_trace.fp); \ } \ } /** ****************************************************************************** * @brief Macro to print CABAC trace messages ****************************************************************************** */ #define AEV_TRACE(string, value, range) \ if(range && g_enc_trace.fp) \ { \ fprintf( g_enc_trace.fp, "%-40s:%8d R:%d\n", string, value, range); \ fflush ( g_enc_trace.fp); \ } #else /* Dummy macros when trace is disabled */ #define ENTROPY_TRACE(syntax_string, value) #define AEV_TRACE(string, value, range) #endif /*****************************************************************************/ /* Extern Function Declarations */ /*****************************************************************************/ /** ****************************************************************************** * * @brief Dummy trace init when trace is disabled in encoder * * @par Description * This routine needs to be called at start of trace * * @param[in] pu1_file_name * Name of file where trace outputs need to be stores (handle) * * @return success or failure error code * ****************************************************************************** */ extern WORD32 ih264e_trace_init ( const char *pu1_file_name ); /** ****************************************************************************** * * @brief Dummy trace de-init function when trace is disabled * * @par Description * This routine needs to be called at end of trace * * @return success or failure error code * ****************************************************************************** */ extern WORD32 ih264e_trace_deinit ( void ); #endif // IH264E_TRACE_H_