gst-launch: Add a '--types' option to filter elements by types to print
[platform/upstream/gstreamer.git] / tools / gst-inspect-1.0.1
1 .TH GStreamer 1 "December 2005"
2 .SH "NAME"
3 gst\-inspect\-1.0 \- print info about a GStreamer plugin or element
4 .SH "SYNOPSIS"
5 .B  gst\-inspect\-1.0 [OPTION...] [PLUGIN|ELEMENT]
6 .SH "DESCRIPTION"
7 .PP
8 \fIgst\-inspect\-1.0\fP is a tool that prints out information on
9 available \fIGStreamer\fP plugins, information about a particular
10 plugin, or information about a particular element.  When executed
11 with no PLUGIN or ELEMENT argument, \fIgst\-inspect\-1.0\fP will print
12 a list of all plugins and elements together with a summary.
13 When executed with a PLUGIN or ELEMENT argument,
14 \fIgst\-inspect\-1.0\fP will print information about that plug-in or
15 element.
16 .
17 .SH "OPTIONS"
18 .l
19 \fIgst\-inspect\-1.0\fP accepts the following arguments and options:
20 .TP 8
21 .B  PLUGIN
22 Name of a plugin
23 .TP 8
24 .B  ELEMENT
25 Name of an element
26 .TP 8
27 .B  \-\-help
28 Print help synopsis and available FLAGS
29 .TP 8
30 .B  \-\-gst\-info\-mask=FLAGS
31 \fIGStreamer\fP info flags to set (list with \-\-help)
32 .TP 8
33 .B  \-a, \-\-print\-all
34 Print all plugins and elements
35 .TP 8
36 .B  \-\-types=Element/Types
37 Allow inspecting only elements that match all the element types filtered
38 in this slash (\'/\') separated list of element types. Those types correspond to
39 what is also called \'klass\' which is a string describing the type of
40 element, like \'Decoder\', \'Audio\', \'Encoder\' etc... This options
41 implies that only elements will be printed (not typefind functions or
42 tracers).
43 .TP 8
44 .B  \-\-print\-plugin\-auto\-install\-info
45 Print a machine-parsable list of features the specified plugin provides.
46 Useful in connection with external automatic plugin installation mechanisms.
47 .TP 8
48 .B  \-\-gst\-debug\-mask=FLAGS
49 \fIGStreamer\fP debugging flags to set (list with \-\-help)
50 .TP 8
51 .B  \-\-gst\-mask=FLAGS
52 \fIGStreamer\fP info and debugging flags to set (list with \-\-help)
53 .TP 8
54 .B  \-\-gst\-plugin\-spew
55 \fIGStreamer\fP info flags to set
56 Enable printout of errors while loading \fIGStreamer\fP plugins
57 .TP 8
58 .B  \-\-gst\-plugin\-path=PATH
59 Add directories separated with ':' to the plugin search path
60 .
61 .SH "SEE ALSO"
62 .BR gst\-launch\-1.0 (1),
63 .BR gst\-typefind\-1.0 (1)
64 .SH "AUTHOR"
65 The GStreamer team at http://gstreamer.freedesktop.org/