docs: clarify clocks docs in manual

After a question on the mailing list, mention that *flushing* seeks reset the
running time.
This commit is contained in:
Stefan Kost 2011-07-18 17:22:41 +02:00
parent 43f5624334
commit 70b95be8f0

View file

@ -12,14 +12,16 @@
</para>
<para>
&GStreamer; derives several times from the clock and the playback state.
&GStreamer; derives several <emphasis>time value</emphasis> from the clock
and the playback state.
It is important to note, that a <emphasis>clock-time</emphasis> is
monotonically rising, but the value itself is not meaningful.
Subtracting the <emphasis>base-time</emphasis> yields the
<emphasis>running-time</emphasis>. It is the same as the
<emphasis>stream-time</emphasis> if one plays from start to end at original
rate. The <emphasis>stream-time</emphasis> indicates the position in the
media.
media. The <emphasis>running-time</emphasis> is (re-)set to 0 when the
pipeline starts to play and also after <emphasis>flushing</emphasis> seeks.
</para>
<figure float="1" id="chapter-clock-img">