From 647c17b752bfd9a72c590ab56149b1f8e8a322a9 Mon Sep 17 00:00:00 2001 From: Thibault Saunier Date: Fri, 27 May 2016 00:00:56 -0400 Subject: [PATCH] WIP: Review and fix Playback+tutorial+1+Playbin2+usage.html --- Playback+tutorial+1+Playbin2+usage.markdown | 157 ++++++++++++-------- 1 file changed, 92 insertions(+), 65 deletions(-) diff --git a/Playback+tutorial+1+Playbin2+usage.markdown b/Playback+tutorial+1+Playbin2+usage.markdown index 93495a35c2..797b68731c 100644 --- a/Playback+tutorial+1+Playbin2+usage.markdown +++ b/Playback+tutorial+1+Playbin2+usage.markdown @@ -1,6 +1,4 @@ -# Playback tutorial 1: Playbin2 usage - -This page last changed on Jun 26, 2012 by xartigas. +# Playback tutorial 1: Playbin usage # Goal @@ -43,15 +41,14 @@ Finally, multiple video streams can also be found in a single file, for example, in DVD with multiple angles of the same scene, but they are somewhat rare. - - - - - - - -

Embedding multiple streams inside a single file is called “multiplexing” or “muxing”, and such file is then known as a “container”. Common container formats are Matroska (.mkv), Quicktime (.qt, .mov, .mp4), Ogg (.ogg) or Webm (.webm).

-

Retrieving the individual streams from within the container is called “demultiplexing” or “demuxing”.

+> ![](images/icons/emoticons/information.png) Embedding multiple streams +> inside a single file is called “multiplexing” or “muxing”, and such file +> is then known as a “container”. Common container formats are Matroska +> (.mkv), Quicktime (.qt, .mov, .mp4), Ogg (.ogg) or Webm (.webm). +> +> +> Retrieving the individual streams from within the container is called +> “demultiplexing” or “demuxing”. The following code recovers the amount of streams in the file, their associated metadata, and allows switching the audio stream while the @@ -285,31 +282,52 @@ static gboolean handle_keyboard (GIOChannel *source, GIOCondition cond, CustomDa } ``` - - - - - +> ![](images/icons/emoticons/information.png) If you need help to compile this code, refer to the **Building the +> tutorials** section for your platform: [Mac](Installing+on+Mac+OS+X.markdown) or [Windows](Installing+on+Windows) +> or use this specific command on Linux: +> ```gcc playback-tutorial-1.c -o playback-tutorial-1 `pkg-config --cflags --libs gstreamer-1.0` ``` + +If you need help to run this code, refer to the **Running the +tutorials** section for your platform: +[Mac OS X](Installing+on+Mac+OS+X.markdown#building-the-tutorials), +[Windows](Installing+on+Windows.markdown#running-the-tutorials), for +[iOS](Installing+for+iOS+development.markdown#building-the-tutorials) or for +[android](Installing+for+Android+development.markdown#building-the-tutorials). + +This tutorial opens a window and displays a movie, with accompanying +audio. The media is fetched from the Internet, so the window might take +a few seconds to appear, depending on your connection speed. The number +of audio streams is shown in the terminal, and the user can switch from +one to another by entering a number and pressing enter. A small delay is +to be expected. + +

+ +

+ +Bear in mind that there is no latency management (buffering), so on slow +connections, the movie might stop after a few seconds. See +how Tutorial +12: Live streaming solves this issue. + +

+ +

+ +

+ +

+ +Required libraries: gstreamer-0.10 + +

+ + + + +
-
-Need help? (Click to expand) -
-
-

If you need help to compile this code, refer to the Building the tutorials section for your platform: Linux, Mac OS X or Windows, or use this specific command on Linux:

-
-
-

gcc playback-tutorial-1.c -o playback-tutorial-1 `pkg-config --cflags --libs gstreamer-0.10`

-
-
-

If you need help to run this code, refer to the Running the tutorials section for your platform: Linux, Mac OS X or Windows

-

-

This tutorial opens a window and displays a movie, with accompanying audio. The media is fetched from the Internet, so the window might take a few seconds to appear, depending on your connection speed. The number of audio streams is shown in the terminal, and the user can switch from one to another by entering a number and pressing enter. A small delay is to be expected.

-

Bear in mind that there is no latency management (buffering), so on slow connections, the movie might stop after a few seconds. See how Tutorial 12: Live streaming solves this issue.

-

-

Required libraries: gstreamer-0.10

-
-
# Walkthrough @@ -387,31 +405,15 @@ g_object_set (data.playbin2, "flags", flags, NULL); can have any combination of `GstPlayFlags`. The most interesting values are: - - - - - - - - - - - - - - - - - - - - - - - - -

GST_PLAY_FLAG_VIDEO

GST_PLAY_FLAG_AUDIO

GST_PLAY_FLAG_TEXT

GST_PLAY_FLAG_VIS

GST_PLAY_FLAG_DOWNLOAD

GST_PLAY_FLAG_BUFFERING

GST_PLAY_FLAG_DEINTERLACE

+| | | +|---------------------------|------------------------------------------------------------------------------------------------------------------------------------| +| GST_PLAY_FLAG_VIDEO | Enable video rendering. If this flag is not set, there will be no video output. | +| GST_PLAY_FLAG_AUDIO | Enable audio rendering. If this flag is not set, there will be no audio output. | +| GST_PLAY_FLAG_TEXT | Enable subtitle rendering. If this flag is not set, subtitles will not be shown in the video output. | +| GST_PLAY_FLAG_VIS | Enable rendering of visualisations when there is no video stream. Playback tutorial 6: Audio visualization goes into more details. | +| GST_PLAY_FLAG_DOWNLOAD | See Basic tutorial 12: Streaming and Playback tutorial 4: Progressive streaming. | +| GST_PLAY_FLAG_BUFFERING | See Basic tutorial 12: Streaming and Playback tutorial 4: Progressive streaming. | +| GST_PLAY_FLAG_DEINTERLACE | If the video content was interlaced, this flag instructs playbin2 to deinterlace it before displaying it. | In our case, for demonstration purposes, we are enabling audio and video and disabling subtitles, leaving the rest of flags to their default @@ -515,15 +517,42 @@ stored as tags in a `GstTagList` structure, which is a list of data pieces identified by a name. The `GstTagList` associated with a stream can be recovered with `g_signal_emit_by_name()`, and then individual tags are extracted with the `gst_tag_list_get_*` functions -like `gst_tag_list_get_string()` for example. +like `gst_tag_list_get_string()` for +example. + + - - + + + + + + +

This rather unintuitive way of retrieving the tag list is called an Action Signal. Action signals are emitted by the application to a specific element, which then performs an action and returns a result. They behave like a dynamic function call, in which methods of a class are identified by their name (the signal's name) instead of their memory address. These signals are listed In the documentation along with the regular signals, and are tagged “Action”. See playbin2, for example.

 + + + + + +

+ +This rather unintuitive way of retrieving the tag list is called an +Action Signal. Action signals are emitted by the application to a +specific element, which then performs an action and returns a result. +They behave like a dynamic function call, in which methods of a class +are identified by their name (the signal's name) instead of their memory +address. These signals are listed In the documentation along with the +regular signals, and are tagged “Action”. See playbin2, for +example. + +

+ +
`playbin2` defines 3 action signals to retrieve @@ -611,5 +640,3 @@ Remember that attached to this page you should find the complete source code of the tutorial and any accessory files needed to build it. It has been a pleasure having you here, and see you soon\! - -Document generated by Confluence on Oct 08, 2015 10:27