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: @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: Set the debug string for the current function, typically containing the arguments to the current function, i.e. "('element')" @format: printf-style format string @args...: printf arguments 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 Combine #GST_DEBUG_ENTER and #GST_DEBUG_SET_STRING. @format: @args...: @cat: @format: @args...: Print out debugging information. @cat: the GST_CAT_... the debug falls within @format: printf-style format string @args...: printf arguments @ptr: @format: @args...: @ptr: @pad: 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 @file: @function: @line: @debug_string: @element: @object: @string: @category: @file: @function: @line: @debug_string: @element: @string: @file: @function: @line: @debug_string: @element: @object: @string: