From bc5c199bc507222a62d1d6ba0584b8b8d5c05b23 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Tim-Philipp=20M=C3=BCller?= Date: Fri, 16 Oct 2015 15:59:49 +0100 Subject: [PATCH] docs: mention xdot utility to view .dot files directly --- docs/gst/running.xml | 5 +++++ gst/gstdebugutils.h | 4 +++- tools/gst-launch.1.in | 3 ++- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/gst/running.xml b/docs/gst/running.xml index 103aebb..b034e6a 100644 --- a/docs/gst/running.xml +++ b/docs/gst/running.xml @@ -361,6 +361,11 @@ from the graphviz set of tools, like this: dot foo.dot -Tpng -o foo.png or dot foo.dot -Tjpg -o foo.jpg. + +There is also a utility called xdot which allows you to +view the dot file directly without converting it first. + + diff --git a/gst/gstdebugutils.h b/gst/gstdebugutils.h index 06618f9..8363e2d 100644 --- a/gst/gstdebugutils.h +++ b/gst/gstdebugutils.h @@ -73,10 +73,12 @@ void gst_debug_bin_to_dot_file_with_ts (GstBin *bin, GstDebugGraphDetails detail * * 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. + * 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 gstreamer is configured with * "--gst-enable-gst-debug" and the environment variable diff --git a/tools/gst-launch.1.in b/tools/gst-launch.1.in index c04ddc6..409727f 100644 --- a/tools/gst-launch.1.in +++ b/tools/gst-launch.1.in @@ -429,7 +429,8 @@ When this environment variable is set, coloured debug output is disabled. When set to a filesystem path, store 'dot' files of pipeline graphs there. These can then later be converted into an image using the 'dot' utility from the graphviz set of tools, like this: dot foo.dot -Tsvg -o foo.svg (png or jpg -are also possible as output format) +are also possible as output format). There is also a utility called 'xdot' +which allows you to view the .dot file directly without converting it first. .TP \fBGST_REGISTRY\fR Path of the plugin registry file. Default is -- 2.7.4