FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Modules | Macros | Functions
Logging Facility
Common utility functions

Modules

 Logging Constants
 

Macros

#define av_dlog(pctx,...)   do { if (0) av_log(pctx, AV_LOG_DEBUG, __VA_ARGS__); } while (0)
 av_dlog macros Useful to print debug messages that shouldn't get compiled in normally.
 
#define AV_LOG_SKIP_REPEATED   1
 Skip repeated messages, this requires the user app to use av_log() instead of (f)printf as the 2 would otherwise interfere and lead to "Last message repeated x times" messages below (f)printf messages with some bad luck.
 

Functions

void av_log (void *avcl, int level, const char *fmt,...) av_printf_format(3
 Send the specified message to the log if the level is less than or equal to the current av_log_level.
 
void void av_vlog (void *avcl, int level, const char *fmt, va_list vl)
 Send the specified message to the log if the level is less than or equal to the current av_log_level.
 
int av_log_get_level (void)
 Get the current log level.
 
void av_log_set_level (int level)
 Set the log level.
 
void av_log_set_callback (void(*callback)(void *, int, const char *, va_list))
 Set the logging callback.
 
void av_log_default_callback (void *ptr, int level, const char *fmt, va_list vl)
 Default logging callback.
 
const char * av_default_item_name (void *ctx)
 Return the context name.
 
AVClassCategory av_default_get_category (void *ptr)
 
void av_log_format_line (void *ptr, int level, const char *fmt, va_list vl, char *line, int line_size, int *print_prefix)
 Format a line of log the same way as the default callback.
 
void av_log_set_flags (int arg)
 

Detailed Description

Macro Definition Documentation

#define av_dlog (   pctx,
  ... 
)    do { if (0) av_log(pctx, AV_LOG_DEBUG, __VA_ARGS__); } while (0)

av_dlog macros Useful to print debug messages that shouldn't get compiled in normally.

Definition at line 295 of file log.h.

#define AV_LOG_SKIP_REPEATED   1

Skip repeated messages, this requires the user app to use av_log() instead of (f)printf as the 2 would otherwise interfere and lead to "Last message repeated x times" messages below (f)printf messages with some bad luck.

Also to receive the last, "last repeated" line if any, the user app must call av_log(NULL, AV_LOG_QUIET, "%s", ""); at the end

Definition at line 306 of file log.h.

Referenced by av_log_default_callback(), main(), and opt_loglevel().

Function Documentation

void av_log ( void avcl,
int  level,
const char *  fmt,
  ... 
)

Send the specified message to the log if the level is less than or equal to the current av_log_level.

By default, all logging messages are sent to stderr. This behavior can be altered by setting a different logging callback function.

See Also
av_log_set_callback
Parameters
avclA pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct.
levelThe importance level of the message expressed using a Logging Constant.
fmtThe format string (printf-compatible) that specifies how subsequent arguments are converted to output.
void void av_vlog ( void avcl,
int  level,
const char *  fmt,
va_list  vl 
)

Send the specified message to the log if the level is less than or equal to the current av_log_level.

By default, all logging messages are sent to stderr. This behavior can be altered by setting a different logging callback function.

See Also
av_log_set_callback
Parameters
avclA pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct.
levelThe importance level of the message expressed using a Logging Constant.
fmtThe format string (printf-compatible) that specifies how subsequent arguments are converted to output.
vlThe arguments referenced by the format string.

Definition at line 284 of file log.c.

Referenced by ass_log(), av_log(), ff_mp_msg(), missing_feature_sample(), rtmp_log(), vs_2_av_log_wrapper(), X264_log(), and XAVS_log().

int av_log_get_level ( void  )

Get the current log level.

See Also
Logging Constants
Returns
Current log level

Definition at line 291 of file log.c.

Referenced by avcodec_string(), check_keyboard_interaction(), filter_frame(), hex_log(), http_av_log(), init(), print_report(), and rtmp_open().

void av_log_set_level ( int  level)

Set the log level.

See Also
Logging Constants
Parameters
levelLogging level

Definition at line 296 of file log.c.

Referenced by check_keyboard_interaction(), main(), opt_default(), and opt_loglevel().

void av_log_set_callback ( void(*)(void *, int, const char *, va_list)  callback)

Set the logging callback.

Note
The callback must be thread safe, even if the application does not use threads itself as some codecs are multithreaded.
See Also
av_log_default_callback
Parameters
callbackA logging function with a compatible signature.

Definition at line 306 of file log.c.

Referenced by init_report(), main(), show_help(), show_help_default(), and show_version().

void av_log_default_callback ( void ptr,
int  level,
const char *  fmt,
va_list  vl 
)

Default logging callback.

It prints the message to stderr, optionally colorizing it.

Parameters
avclA pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct.
levelThe importance level of the message expressed using a Logging Constant.
fmtThe format string (printf-compatible) that specifies how subsequent arguments are converted to output.
apThe arguments referenced by the format string.

Definition at line 220 of file log.c.

Referenced by log_callback_report().

const char* av_default_item_name ( void ctx)

Return the context name.

Parameters
ctxThe AVClass context
Returns
The AVClass class_name

Definition at line 148 of file log.c.

Referenced by av_parse_cpu_caps(), av_parse_cpu_flags(), and vs_2_av_log_wrapper().

AVClassCategory av_default_get_category ( void ptr)

Definition at line 153 of file log.c.

void av_log_format_line ( void ptr,
int  level,
const char *  fmt,
va_list  vl,
char *  line,
int  line_size,
int *  print_prefix 
)

Format a line of log the same way as the default callback.

Parameters
linebuffer to receive the formated line
line_sizesize of the buffer
print_prefixused to store whether the prefix must be printed; must point to a persistent integer initially set to 1

Definition at line 211 of file log.c.

Referenced by log_callback_report().

void av_log_set_flags ( int  arg)

Definition at line 301 of file log.c.

Referenced by main(), and opt_loglevel().