mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-26 19:51:11 +00:00
Code Issues 1 Projects Releases Wiki Activity

manual: add some text about bin state change order

Browse source
This commit is contained in:
Wim Taymans 2012-10-11 17:07:39 +02:00
parent fa14d42a1e
commit d2ad127dcd
1 changed files with 10 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
docs/manual/basics-bins.xml
View file

@ -162,9 +162,18 @@ main (int argc,
to this state. This means it's usually only necessary to set the state
of the top-level pipeline to start up the pipeline or shut it down.
</para>
<para>
The bin will perform the state changes on all its children from the
sink element to the source element. This ensures that the downstream
element is ready to receive data when the upstream element is brought
to PAUSED or PLAYING. Similarly when shutting down, the sink elements
will be set to READY or NULL first, which will cause the upstream
elements to receive a FLUSHING error and stop the streaming threads
before the elements are set to the READY or NULL state.
</para>
<para>
Note, however, that if elements are added to a bin or pipeline that's
already running, , e.g. from within a "pad-added" or "new-decoded-pad"
already running, , e.g. from within a "pad-added"
signal callback, its state will not automatically be brought in line with
the current state or target state of the bin or pipeline it was added to.
Instead, you have to need to set it to the desired target state yourself