mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-06-05 06:58:56 +00:00
Code Issues 1 Projects Releases Wiki Activity

design: gstbin: assorted improvements

Browse source 
Formatting, gramar & missing-markup fixes.
This commit is contained in:
Reynaldo H. Verdejo Pinochet 2017-04-21 16:04:52 -07:00
parent 2f6ab807f7
commit 9369a740fb
1 changed files with 7 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
markdown/design/gstbin.md
View file

@ -1,11 +1,11 @@
# GstBin # GstBin
`GstBin` is a container element for other `GstElements`. This makes it `GstBin` is a container element for other `GstElements`. It makes
possible to group elements together so that they can be treated as one possible to group elements together so that they can be treated as one
single `GstElement`. A `GstBin` provides a `GstBus` for the children and single `GstElement`. A `GstBin` provides a `GstBus` for the children and
collates messages from them. collates messages from them.
## Add/removing elements ## Adding/removing elements
The basic functionality of a bin is to add and remove `GstElement` The basic functionality of a bin is to add and remove `GstElement`
to/from it. `gst_bin_add()` and `gst_bin_remove()` perform these to/from it. `gst_bin_add()` and `gst_bin_remove()` perform these
@ -22,10 +22,11 @@ from itself. A few examples of the provided functions:
* `gst_bin_get_by_name()` retrieves an element by name. * `gst_bin_get_by_name()` retrieves an element by name.
* `gst_bin_iterate_elements()` returns an iterator to all the children. * `gst_bin_iterate_elements()` returns an iterator to all the children.
## element management ## Element management
The most important function of the `GstBin` is to distribute all The most important function of the `GstBin` is to distribute all
`GstElement` operations on itself to all of its children. This includes: `GstElement` operations on itself to all of its children. These
operations include:
- state changes - state changes
@ -54,7 +55,7 @@ trigger a recalculation of the current state of the bin, as described in
The application can retrieve the external `GstBus` and integrate it in the The application can retrieve the external `GstBus` and integrate it in the
mainloop or it can just `pop()` messages off in its own thread. mainloop or it can just `pop()` messages off in its own thread.
When a bin goes to READY it will clear all cached messages. When a bin goes to `READY` it will clear all cached messages.
## EOS ## EOS
@ -80,7 +81,7 @@ The cached `SEGMENT_START`/`STOP` messages are cleared when going to `READY`.
## DURATION ## DURATION
When a DURATION query is performed on a bin, it will forward the query When a `DURATION` query is performed on a bin, it will forward the query
to all its sink elements. The bin will calculate the total duration as to all its sink elements. The bin will calculate the total duration as
the MAX of all returned durations and will then cache the result so that the MAX of all returned durations and will then cache the result so that
any further queries can use the cached version. The reason for caching the any further queries can use the cached version. The reason for caching the