mmore updates
[platform/upstream/gstreamer.git] / tools / gst-xmllaunch.1
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 "OPTIONS"
28 .l
29 \fIgst\-xmllaunch\fP accepts the following options:
30 .TP 8
31 .B  \-\-help
32 Print help synopsis and available FLAGS
33 .TP 8
34 .B  \-\-gst\-info\-mask=FLAGS
35 \fIGStreamer\fP info flags to set (list with \-\-help)
36 .TP 8
37 .B  \-\-gst\-debug\-mask=FLAGS
38 \fIGStreamer\fP debugging flags to set (list with \-\-help)
39 .TP 8
40 .B  \-\-gst\-mask=FLAGS
41 \fIGStreamer\fP info and debugging flags to set (list with \-\-help)
42 .TP 8
43 .B  \-\-gst\-plugin\-spew
44 \fIGStreamer\fP info flags to set
45 Enable printout of errors while loading \fIGStreamer\fP plugins
46 .TP 8
47 .B  \-\-gst\-plugin\-path=PATH
48 Add directories separated with ':' to the plugin search path
49 .SH "SEE ALSO"
50 .BR gst\-guilaunch (1),
51 .BR gst\-launch (1),
52 .BR gst\-register (1),
53 .BR gst\-inspect (1),
54 .SH "AUTHOR"
55 The GStreamer team at http://gstreamer.net/