GStreamer Library Reference Manual (Core) | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gst/gst.h> const |
gstinfo.c contains a number of debuggins subsystems.
The INFO subsystem is used to provide informative printouts to application and plugin developers. These messages can be enabled and disabled via a category system, which is a bitmask enabling you to turn on and off any subset of categories.
The DEBUG subsystem is similar, but is intended for core developers and those writing more complex pipelines or filters. It uses the same category system, but must be enabled at configure time else it's not compiled into the library. autogen.sh automatically enables the DEBUG subsystem.
The ERROR subsystem doesn't use categories, but will print out a more verbose message, and attempt to print out a stack trace of the error before aborting the application.
void gst_info_set_categories ( |
Enable the output of INFO categories based on the given bitmask. The bit for any given category is (1 << GST_CAT_...).
void gst_info_enable_category ( |
Enables the given GST_CAT_... INFO category.
void gst_info_disable_category ( |
Disables the given GST_CAT_... INFO category.
void gst_default_info_handler ( |
Prints out the INFO mesage in a variant of the following form:
INFO:gst_function:542(args): [elementname] something neat happened
category : | category of the INFO message |
file : | the file the INFO occurs in |
function : | the function the INFO occurs in |
line : | the line number in the file |
debug_string : | the current debug_string in the function, if any |
element : | pointer to the GstElement in question |
string : | the actual INFO string |
#define GST_INFO(cat,format,args...) |
Print out any information usable at run-time by application developers.
#define GST_INFO_ELEMENT(cat,element,format,args...) |
Print out information like GST_INFO, but with an element pointer to clarify things.
cat : | the GST_CAT_... category for the information |
element : | pointer to the GstElement in question |
format : | printf-style format string |
args... : | printf arguments |
void gst_debug_set_categories ( |
Enable the output of DEBUG categories based on the given bitmask. The bit for any given category is (1 << GST_CAT_...).
void gst_debug_enable_category ( |
Enables the given GST_CAT_... DEBUG category.
void gst_debug_disable_category ( |
Disables the given GST_CAT_... DEBUG category.
#define GST_DEBUG_SET_STRING(format, args...) |
Set the debug string for the current function, typically containing the arguments to the current function, i.e. "('element')"
#define GST_DEBUG_ENTER(format, args...) |
Called at the beginning of a function, it simply prints out a DEBUG string of "entering" in addition to the given string.
#define GST_DEBUG_ENTER_STRING |
Combine GST_DEBUG_ENTER and GST_DEBUG_SET_STRING.
#define GST_ERROR(element,format,args...) |
Print out an error condition and abort the application.
element : | the GstElement in question |
format : | printf-style format string |
args... : | printf arguments |
#define GST_ERROR_OBJECT(element,object,format,args...) |
Print out an error condition and abort the application.
element : | the GstElement in question |
object : | pointer to a 'contributing' object |
format : | printf-style format string |
args... : | printf arguments |
void gst_default_error_handler ( |
Prints out the given ERROR string in a variant of the following format:
***** GStreamer ERROR ***** in file gstsomething.c at gst_function:399(arg) Element: /pipeline/thread/element.src Error: peer is null! ***** attempting to stack trace.... *****
At the end, it attempts to print the stack trace via GDB.
file : | the file the ERROR occurs in |
function : | the function the INFO occurs in |
line : | the line number in the file |
debug_string : | the current debug_string in the function, if any |
element : | pointer to the GstElement in question |
object : | pointer to a related object |
string : | the actual ERROR string |
void (*GstInfoHandler) ( |