mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-04-26 06:54:49 +00:00
Code Issues 1 Projects Releases Wiki Activity

faq: using: improve command line section

Browse source 
Group and reorder examples logically and add a short on note
about auto sinks. Rework text as needed.
This commit is contained in:
Reynaldo H. Verdejo Pinochet 2017-08-15 15:12:44 -07:00
parent 53ec57d6be
commit 42cf3fbe80
1 changed files with 46 additions and 33 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

79
markdown/frequently-asked-questions/using.md
View file

@ -114,49 +114,62 @@ provide us with the necessary gdb output. See
## How do I use the GStreamer command line interface? ## How do I use the GStreamer command line interface?
You access the GStreamer command line interface using the command You access the GStreamer command line interface using the command
`gst-launch-1.0`. To play a file you could just use `gst-launch-1.0`. For example, to play a file you could just use
```
gst-launch-1.0 playbin uri=file:///path/to/song.mp3
```
gst-play-1.0 song.mp3 You can also use `gst-play`:
or ```
gst-play-1.0 song.mp3
```
gst-launch-1.0 playbin uri=file:///path/to/song.mp3 To decode an mp3 audio file and play it through Pulseaudio, you could use:
To decode an mp3 audio file and play it through Pulseaudio, you could also use ```
gst-launch-1.0 filesrc location=thesong.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink
```
gst-launch-1.0 filesrc location=thesong.mp3 ! decodebin ! audioconvert ! pulsesink To automatically detect and select the right decoder for a given encoded stream
in a pipeline, try any of the following:
or ```
gst-launch-1.0 filesrc location=thesong.mp3 ! decodebin ! audioconvert ! pulsesink
```
```
gst-launch-1.0 filesrc location=my-random-media-file.mpeg ! decodebin ! pulsesink
```
```
gst-launch-1.0 filesrc location=my-random-media-file.mpeg ! decodebin ! videoconvert ! xvimagesink
```
gst-launch-1.0 filesrc location=thesong.mp3 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink Or even something more complicated like:
. More examples can be found in the gst-launch man page. ```
gst-launch-1.0 filesrc location=my-random-media-file.mpeg !decodebin name=decoder \
To automatically detect the right codec in a pipeline, decoder. ! queue ! videoconvert ! xvimagesink \
try
gst-launch-1.0 filesrc location=my-random-media-file.mpeg ! decodebin !
pulsesink
.
or
gst-launch-1.0 filesrc location=my-random-media-file.mpeg ! decodebin !
videoconvert ! xvimagesink
Something more
complicated:
gst-launch-1.0 filesrc location=my-random-media-file.mpeg ! decodebin name=decoder
decoder. ! queue ! videoconvert ! xvimagesink
decoder. ! queue ! audioconvert ! pulsesink decoder. ! queue ! audioconvert ! pulsesink
```
We also have a basic media playing plugin that will take care of most Building from the previous example, you can let GStreamer select an appropriate
things for you. This plugin is called playbin. Try set of default sinks by replacing the specific output elements with these automatic
this: alternatives:
gst-launch-1.0 playbin uri=file:///home/joe/my-random-media-file.mpeg ```
gst-launch-1.0 filesrc location=my-random-media-file.mpeg !decodebin name=decoder \
decoder. ! queue ! videoconvert ! autovideosink \
decoder. ! queue ! audioconvert ! autoaudiosink
```
This should play the file if the format is supported, ie. you have all GStreamer also provides `playbin`, a basic media-playback plugin that
the necessary demuxing and decoding and some output plugins installed. automatically takes care of most playback details. The following example shows
how to play any file as long as its format is supported, ie. you have the
necessary demuxing and decoding plugins installed:
```
gst-launch-1.0 playbin uri=file:///home/joe/my-random-media-file.mpeg
```
Additional examples can be found in the `gst-launch` manual page.