GstInfo
info/debugging/error handling
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.
@category:
@Returns:
@Returns:
@categories:
@category:
@category:
@category:
@incore:
@file:
@function:
@line:
@debug_string:
@element:
@string:
When defined, INFO printouts are compiled into the library.
Print out any information usable at run-time by application developers.
@cat: the GST_CAT_... category for the information
@...:
@format: printf-style format string
@args...: printf arguments
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
@Returns:
@categories:
@category:
@category:
Called at the beginning of a function, it simply prints out a DEBUG string of "entering"
in addition to the given string.
@...:
@format: printf-style format string
@args...: printf arguments
Called at the end of a function, it simply prints out a DEBUG string of "leaving"
in addition to the given string.
@...:
@format: printf-stype format string
@args...: printf arguments
Print out debugging information.
@cat: the GST_CAT_... the debug falls within
@...:
@format: printf-style format string
@args...: printf arguments
Add a function to the global function pointer table used for debugging.
@ptr: The pointer to add to the function table.
Get the name of the given function pointer by looking up its name in the global
function table.
@ptr: The pointer to look up.
Print out debugging statements for a pad.
@pad: The pad to debug.
Part of the colorized debug functions for threads
@id: The thread id.
Part of the colorized debug functions for threads
Print out usefull debugging info of an element.
@cat: The category of this debugging statement.
@element: The element to debug.
@...:
@format: A printf-like string.
@args...: The argument for the printf-like string.
Print out an error condition and abort the application.
@element: the #GstElement in question
@...:
@format: printf-style format string
@args...: printf arguments
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
The debug handler
@category:
@core:
@file:
@function:
@line:
@debug_string:
@element:
@string:
@category:
@incore:
@file:
@function:
@line:
@debug_string:
@element:
@string:
@file:
@function:
@line:
@debug_string:
@element:
@object:
@string:
The info handler
@category:
@incore:
@file:
@function:
@line:
@debug_string:
@element:
@string:
The error handler
@file:
@function:
@line:
@debug_string:
@element:
@object:
@string: