gst-launch: add -c, --toc to print the toc
[platform/upstream/gstreamer.git] / tools / gst-xmllaunch.1.in
1 .TH "GStreamer" "1" "March 2001"
2 .SH "NAME"
3 gst\-xmllaunch \- build and run a GStreamer pipeline from an XML serialization
4 .SH "SYNOPSIS"
5 \fBgst\-xmllaunch\fR \fI[OPTION...]\fR XML\-FILE [ ELEMENT.PROPERTY=VALUE ... ]
6 .SH "DESCRIPTION"
7 .LP 
8 \fIgst\-xmllaunch\fP is a tool that is used to build and run a basic
9 \fIGStreamer\fP pipeline, loading it from an XML description. You can
10 produce the XML description using gst-launch(1) with the -o option or by
11 calling gst_xml_write_file() in your own app.
12
13 A simple commandline looks like:
14
15  gst\-xmllaunch my\-pipeline.xml filesrc0.location=music.mp3
16
17 This sets the location property of the element named filesrc0 to the value
18 "music.mp3". See gst\-launch(1) for syntax on setting element names, and
19 gst\-inspect to see what properties various elements have.
20
21 You can pass "-" as the XML\-FILE to read from stdin.
22
23 XML\-FILE can be a URI as well, thanks to the wizardry of libxml. I'm not really
24 sure what all is supported, it seems http works just fine though.
25
26 .
27 .SH "WARNING"
28 \fIgst\-xmllaunch\fP is deprecated and broken for all but the most simple
29 pipelines. It will most likely be removed in future. Don't use it.
30 .
31 .SH "OPTIONS"
32 .l
33 \fIgst\-xmllaunch\fP accepts the following options:
34 .TP 8
35 .B  \-\-help
36 Print help synopsis and available FLAGS
37 .TP 8
38 .B  \-\-silent
39 Do not output status information
40 .TP 8
41 .B  \-\-exclude=TYPE, \-XTYPE
42 Do not output status information of TYPE
43 .TP 8
44 .B  \-\-output=FILE, \-oFILE
45 Save XML representation of pipeline to FILE and exit
46 .TP 8
47 .B  \-\-gst\-info\-mask=FLAGS
48 \fIGStreamer\fP info flags to set (list with \-\-help)
49 .TP 8
50 .B  \-\-gst\-debug\-mask=FLAGS
51 \fIGStreamer\fP debugging flags to set (list with \-\-help)
52 .TP 8
53 .B  \-\-gst\-mask=FLAGS
54 \fIGStreamer\fP info and debugging flags to set (list with \-\-help)
55 .TP 8
56 .B  \-\-gst\-plugin\-spew
57 \fIGStreamer\fP info flags to set
58 Enable printout of errors while loading \fIGStreamer\fP plugins
59 .TP 8
60 .B  \-\-gst\-plugin\-path=PATH
61 Add directories separated with ':' to the plugin search path
62 .
63 .SH "SEE ALSO"
64 .BR gst\-feedback (1),
65 .BR gst\-inspect (1),
66 .BR gst\-launch (1),
67 .BR gst\-typefind (1)
68 .SH "AUTHOR"
69 The GStreamer team at http://gstreamer.freedesktop.org/