Debugging utilities

gst_debug_bin_to_dot_data

gchar *
gst_debug_bin_to_dot_data (GstBin * 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 a dot file. This data can be processed with graphviz to get an image.

gst_debug_bin_to_dot_file

gst_debug_bin_to_dot_file (GstBin * bin,
                           GstDebugGraphDetails details,
                           const gchar * file_name)

To aid debugging applications one can use this method to write out the whole network of gstreamer elements that form the pipeline into a dot file. This file can be processed with graphviz to get an image.

 dot -Tpng -oimage.png graph_lowlevel.dot

gst_debug_bin_to_dot_file_with_ts

gst_debug_bin_to_dot_file_with_ts (GstBin * bin,
                                   GstDebugGraphDetails details,
                                   const gchar * file_name)

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.

GST_DEBUG_BIN_TO_DOT_FILE

#define GST_DEBUG_BIN_TO_DOT_FILE(bin, details, file_name) gst_debug_bin_to_dot_file (bin, details, file_name)

To aid debugging applications one can use this method to write out the whole network of gstreamer elements that form the pipeline into a dot file. This file can be processed with graphviz to get an image, like this:

dot -Tpng -oimage.png graph_lowlevel.dot

There is also a utility called xdot which allows you to view the dot file directly without converting it first.

The macro is only active if the environment variable GST_DEBUG_DUMP_DOT_DIR is set to a basepath (e.g. /tmp), and the GStreamer debugging subsystem is enabled (i.e., no use of ./configure --disable-gst-debug)

GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS

#define GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS(bin, details, file_name) gst_debug_bin_to_dot_file_with_ts (bin, details, file_name)

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.

GstDebugGraphDetails

Available details for pipeline graphs produced by GST_DEBUG_BIN_TO_DOT_FILE and GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS.