How to generate a GStreamer pipeline diagram: Difference between revisions
(Created page with '= Introduction = This page will allow you to create a useful diagram of your pipeline, as described in http://docs.gstreamer.com/display/GstSDK/Basic+tutorial+11%3A+Debugging+to...') |
m (Adding reference to the main Gstreamer Debugging page.) |
||
Line 42: | Line 42: | ||
$ eog pipeline.png | $ eog pipeline.png | ||
= See Also = | |||
[[GStreamer_Debugging|Gstreamer Debugging]] | |||
= References = | = References = | ||
Line 51: | Line 55: | ||
[http://www.graphviz.org/ Graph Visualization Software] | [http://www.graphviz.org/ Graph Visualization Software] | ||
[[Category:HowTo]] | [[Category:HowTo]] [[Category:GStreamer]] |
Revision as of 20:46, 29 November 2012
Introduction
This page will allow you to create a useful diagram of your pipeline, as described in http://docs.gstreamer.com/display/GstSDK/Basic+tutorial+11%3A+Debugging+tools.
Steps
1. Install dot:
sudo apt-get install graphviz
The "dot" command is available in the "graphviz" package.
2. In the target, run:
# export GST_DEBUG_DUMP_DOT_DIR=/tmp/
This will place the .dot generated files in your /tmp/ directory, you can change that directory if you need to.
3. Run your pipeline, for example:
# gst-launch audiotestsrc num-buffers=1000 ! fakesink sync=false
After the pipeline is over, you can see the .dot generated files, and the "*PLAYING_PAUSED*" one is typically used to generate the diagram.
# ls /tmp 0.00.00.972540004-gst-launch.NULL_READY.dot 0.00.01.051387461-gst-launch.READY_PAUSED.dot 0.00.01.074729712-gst-launch.PAUSED_PLAYING.dot 0.00.12.187852589-gst-launch.PLAYING_PAUSED.dot 0.00.12.201485839-gst-launch.PAUSED_READY.dot psplash_fifo
4. In your host machine, generate the diagram from the dot file
This step implies you know how to transfer the .dot file from your target to your host machine. Once you've done that, you can generate the .png image using the "dot" command in your host:
$ dot -Tpng 0.00.24.846778049-gst-launch.PLAYING_PAUSED.dot > pipeline.png
5. Open up your image
Once the image has been created, you can open it with your favorite image viewer, for example:
$ eog pipeline.png
See Also
References
Gstreamer Debugging Tools Tutorial. Section "Getting pipeline graphs".