mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-16 21:36:35 +00:00
manual: Explain what happens if upstream elements are removed from the pipeline without draining them first
https://bugzilla.gnome.org/show_bug.cgi?id=762302
This commit is contained in:
parent
93e006bd66
commit
e6f0095750
1 changed files with 10 additions and 0 deletions
|
@ -1195,6 +1195,16 @@ main (int argc, char **argv)
|
|||
to flush any queued data in the element by sending an EOS event
|
||||
down the element sink pad(s) and by waiting that the EOS leaves
|
||||
the elements (with an event probe).
|
||||
</para>
|
||||
If you do not do this, you will lose the data which is buffered
|
||||
by the unlinked element. This can result in a simple frame loss
|
||||
(one or more video frames, several milliseconds of audio). However
|
||||
if you remove a muxer (and in some cases an encoder or similar elements)
|
||||
from the pipeline, you risk getting a corrupted file which could not be
|
||||
played properly, as some relevant metadata (header, seek/index tables, internal
|
||||
sync tags) will not be stored or updated properly.
|
||||
<para>
|
||||
|
||||
See also <xref linkend="section-dynamic-changing"/>.
|
||||
</para>
|
||||
</listitem>
|
||||
|
|
Loading…
Reference in a new issue