mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-25 09:40:37 +00:00
Code Issues 1 Projects Releases Wiki Activity

Update gst-launch.md: add link, fix/improve formatting.

Browse source
This commit is contained in:
R Kh 2019-01-24 01:30:00 +00:00
parent 182f4ed973
commit 7a913b4629
1 changed files with 20 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
markdown/tools/gst-launch.md
View file

@ -24,7 +24,7 @@ by exclamation marks (!). Properties may be appended to elements in the
form `property=value`. form `property=value`.
For a more complete description of possible PIPELINE-DESCRIPTIONS see the For a more complete description of possible PIPELINE-DESCRIPTIONS see the
section *pipeline description* below or consult the GStreamer documentation. section [Pipeline Description](#pipeline-description) below or consult the GStreamer documentation.
Please note that `gst-launch-1.0` is primarily a debugging tool. You should Please note that `gst-launch-1.0` is primarily a debugging tool. You should
not build applications on top of it. For applications, use the not build applications on top of it. For applications, use the
@ -68,15 +68,15 @@ Do not install a fault handler
Print memory allocation traces. The feature must be enabled at compile Print memory allocation traces. The feature must be enabled at compile
time to work. time to work.
## Gstreamer Options ## GStreamer Options
`gst-launch-1.0` also accepts the following options that are common to `gst-launch-1.0` also accepts the following options that are common to
all GStreamer applications: all GStreamer applications:
## Pipeline Description ## Pipeline Description
A pipeline consists *elements* and *links*. *elements* can be put A pipeline consists of *elements* and *links*. *Elements* can be put
into *bins* of different sorts. *elements*, *links* and *bins* can be into *bins* of different sorts. *Elements*, *links*, and *bins* can be
specified in a pipeline description in any order. specified in a pipeline description in any order.
### Elements ### Elements
@ -107,7 +107,7 @@ Specifies that a bin of type `BINTYPE` is created and the given properties
are set. Every element between the braces is put into the bin. Please are set. Every element between the braces is put into the bin. Please
note the dot that has to be used after the `BINTYPE`. You will almost note the dot that has to be used after the `BINTYPE`. You will almost
never need this functionality, it is only really useful for applications never need this functionality, it is only really useful for applications
using the `gst_parse_launch()` API with 'bin' as bintype. That way it is using the `gst_parse_launch()` API with `bin` as bintype. That way it is
possible to build partial pipelines instead of a full-fledged top-level possible to build partial pipelines instead of a full-fledged top-level
pipeline. pipeline.
@ -154,17 +154,20 @@ NAME=[(TYPE)] VALUE in lists and ranges: [(TYPE)] VALUE
Sets the requested property in capabilities. The name is an alphanumeric Sets the requested property in capabilities. The name is an alphanumeric
value and the type can have the following case-insensitive values: value and the type can have the following case-insensitive values:
- **i** or **int** for integer values or ranges - **f** or **float** for - `i` or `int` for integer values or ranges;
float values or ranges - **4** or **fourcc** for FOURCC values - `f` or `float` for float values or ranges;
- **b**, **bool** or **boolean** for boolean values - `4` or `fourcc` for FOURCC values;
- **s**, **str** or **string** for strings - **fraction** for fractions - `b`, `bool`, or `boolean` for boolean values;
(framerate, pixel-aspect-ratio) - `s`, `str`, or `string` for strings;
- **l** or **list** for lists If no type was given, the following order is - `fraction` for fractions (framerate, pixel-aspect-ratio);
- `l` or `list` for lists.
If no type was given, the following order is
tried: integer, float, boolean, string. Integer values must be parsable by tried: integer, float, boolean, string. Integer values must be parsable by
**strtol()**, floats by **strtod()**. FOURCC values may either be integers or `strtol()`, floats by `strtod()`. FOURCC values may either be integers or
strings. Boolean values are (case insensitive) *yes*, *no*, *true* or *false* strings. Boolean values are (case insensitive) `yes`, `no`, `true` or `false`
and may like strings be escaped with `"` or `'`. Ranges are in this format: `[ and may like strings be escaped with `"` or `'`. Ranges are in this format: `[
VALUE, VALUE] Lists use this format: (VALUE [, VALUE ...])` VALUE, VALUE]`; lists use this format: `(VALUE [, VALUE ...])`.
## Pipeline Control ## Pipeline Control
@ -274,10 +277,10 @@ gst-launch-1.0 cdparanoiasrc track=5 ! audioconvert ! lame ! id3v2mux
``` ```
Using `gst-inspect-1.0`, it is possible to discover settings like Using `gst-inspect-1.0`, it is possible to discover settings like
the above for cdparanoiasrc that will tell it to rip the entire CD or the above for "cdparanoiasrc" that will tell it to rip the entire CD or
only tracks of it. Alternatively, you can use an URI and `gst-launch-1.0` only tracks of it. Alternatively, you can use an URI and `gst-launch-1.0`
will find an element (such as cdparanoia) that supports that protocol will find an element (such as cdparanoia) that supports that protocol
for you, e.g.:  for you, e.g.:
``` ```
gst-launch-1.0 [cdda://5] ! lame vbr=new vbr-quality=6 ! gst-launch-1.0 [cdda://5] ! lame vbr=new vbr-quality=6 !
@ -384,7 +387,7 @@ gst-launch-1.0 videotestsrc ! ximagesink
### Automatic linking ### Automatic linking
You can use the decodebin element to automatically select the right You can use the "decodebin" element to automatically select the right
elements to get a working pipeline. elements to get a working pipeline.
Play any supported audio format: Play any supported audio format: