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
@format:
@args...:
Print out debugging information.
@cat: the GST_CAT_... the debug falls within
@format: printf-style format string
@args...: printf arguments
@ptr:
@ptr:
@pad:
@id:
@cat:
@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
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
@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:
@category:
@incore:
@file:
@function:
@line:
@debug_string:
@element:
@string:
@file:
@function:
@line:
@debug_string:
@element:
@object:
@string: