Debug

struct Debug {

static void logDefault(DebugCategory category, GstDebugLevel level, string file, string function_, int line, ObjectG object, GstDebugMessage* message, void* userData);

static void logValist(DebugCategory category, GstDebugLevel level, string file, string function_, int line, ObjectG object, string format, void* args);

static void printStackTrace();

static uint removeLogFunction(GstLogFunction func);

static uint removeLogFunctionByData(void* data);

static void setActive(bool active);

static void setColorMode(GstDebugColorMode mode);

static void setColorModeFromString(string mode);

static void setColored(bool colored);

static void setDefaultThreshold(GstDebugLevel level);

static void setThresholdForName(string name, GstDebugLevel level);

static void setThresholdFromString(string list, bool reset);

static void unsetThresholdForName(string name);

}

Members

Static functions

addLogFunction void addLogFunction(GstLogFunction func, void* userData, GDestroyNotify notify): Adds the logging function to the list of logging functions. Be sure to use G_GNUC_NO_INSTRUMENT on that function, it is needed.
binToDotData string binToDotData(Bin bin, GstDebugGraphDetails details): To aid debugging applications one can use this method to obtain the whole network of gstreamer elements that form the pipeline into an dot file. This data can be processed with graphviz to get an image.
binToDotFile void binToDotFile(Bin bin, GstDebugGraphDetails details, string fileName): To aid debugging applications one can use this method to write out the whole network of gstreamer elements that form the pipeline into an dot file. This file can be processed with graphviz to get an image. <informalexample><programlisting> dot -Tpng -oimage.png graph_lowlevel.dot </programlisting></informalexample>
binToDotFileWithTs void binToDotFileWithTs(Bin bin, GstDebugGraphDetails details, string fileName): This works like gst_debug_bin_to_dot_file(), but adds the current timestamp to the filename, so that it can be used to take multiple snapshots.
constructTermColor string constructTermColor(uint colorinfo): Constructs a string that can be used for getting the desired color in color terminals. You need to free the string after use.
constructWinColor int constructWinColor(uint colorinfo): Constructs an integer that can be used for getting the desired color in windows' terminals (cmd.exe). As there is no mean to underline, we simply ignore this attribute.
getAllCategories ListSG getAllCategories(): Returns a snapshot of a all categories that are currently in use . This list may change anytime. The caller has to free the list after use.
getColorMode GstDebugColorMode getColorMode(): Changes the coloring mode for debug output.
getDefaultThreshold GstDebugLevel getDefaultThreshold(): Returns the default threshold that is used for new categories.
isActive bool isActive(): Checks if debugging output is activated.
isColored bool isColored(): Checks if the debugging output should be colored.
levelGetName string levelGetName(GstDebugLevel level): Get the string representation of a debugging level
logDefault void logDefault(DebugCategory category, GstDebugLevel level, string file, string function_, int line, ObjectG object, GstDebugMessage* message, void* userData): The default logging handler used by GStreamer. Logging functions get called whenever a macro like GST_DEBUG or similar is used. By default this function is setup to output the message and additional info to stderr (or the log file specified via the GST_DEBUG_FILE environment variable) as received via user_data.
logValist void logValist(DebugCategory category, GstDebugLevel level, string file, string function_, int line, ObjectG object, string format, void* args): Logs the given message using the currently registered debugging handlers.
printStackTrace void printStackTrace(): If libunwind, glibc backtrace or DbgHelp are present a stack trace is printed.
removeLogFunction uint removeLogFunction(GstLogFunction func): Removes all registered instances of the given logging functions.
removeLogFunctionByData uint removeLogFunctionByData(void* data): Removes all registered instances of log functions with the given user data.
setActive void setActive(bool active): If activated, debugging messages are sent to the debugging handlers. It makes sense to deactivate it for speed issues. > This function is not threadsafe. It makes sense to only call it during initialization.
setColorMode void setColorMode(GstDebugColorMode mode): Changes the coloring mode for debug output.
setColorModeFromString void setColorModeFromString(string mode): Changes the coloring mode for debug output.
setColored void setColored(bool colored): Sets or unsets the use of coloured debugging output. Same as gst_debug_set_color_mode () with the argument being being GST_DEBUG_COLOR_MODE_ON or GST_DEBUG_COLOR_MODE_OFF.
setDefaultThreshold void setDefaultThreshold(GstDebugLevel level): Sets the default threshold to the given level and updates all categories to use this threshold.
setThresholdForName void setThresholdForName(string name, GstDebugLevel level): Sets all categories which match the given glob style pattern to the given level.
setThresholdFromString void setThresholdFromString(string list, bool reset): Sets the debug logging wanted in the same form as with the GST_DEBUG environment variable. You can use wildcards such as '*', but note that the order matters when you use wild cards, e.g. "foosrc:6,*src:3,*:2" sets everything to log level 2.
unsetThresholdForName void unsetThresholdForName(string name): Resets all categories with the given name back to the default level.

gstreamer Debug structs

Debug