[gst-cvs] ensonic gstreamer: gstreamer/ gstreamer/docs/manual/

[<en...@ke...>]

CVS Root:       /cvs/gstreamer
Module:         gstreamer
Changes by:     ensonic
Date:           Thu Aug 14 2008  14:26:34 UTC

Log message:
	patch by: Luc Pionchon <luc...@no...>
	* docs/manual/advanced-clocks.xml:
	* docs/manual/clocks.png:
	* docs/manual/diagrams-clocks.svg:
	  Add one more image showing different times together with a describing
	  paragraph. Fixes #547729.

Modified files:
    .               : ChangeLog
    docs/manual     : advanced-clocks.xml
Added files:
    docs/manual     : clocks.png diagrams-clocks.svg

Links:
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/ChangeLog.diff?r1=1.4023&r2=1.4024
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/manual/advanced-clocks.xml.diff?r1=1.6&r2=1.7
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/manual/clocks.png?rev=1.1&content-type=text/vnd.viewcvs-markup
http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/manual/diagrams-clocks.svg?rev=1.1&content-type=text/vnd.viewcvs-markup

====Begin Diffs====
Index: ChangeLog
===================================================================
RCS file: /cvs/gstreamer/gstreamer/ChangeLog,v
retrieving revision 1.4023
retrieving revision 1.4024
diff -u -d -r1.4023 -r1.4024
--- ChangeLog	14 Aug 2008 14:04:51 -0000	1.4023
+++ ChangeLog	14 Aug 2008 14:26:18 -0000	1.4024
@@ -1,3 +1,13 @@
+2008-08-14  Stefan Kost  <en...@us...>
+
+	patch by: Luc Pionchon <luc...@no...>
+	* docs/manual/advanced-clocks.xml:
+	* docs/manual/clocks.png:
+	* docs/manual/diagrams-clocks.svg:
+	  Add one more image showing different times together with a describing
+	  paragraph. Fixes #547729.
 2008-08-14  Wim Taymans  <wim...@co...>
 
 	* win32/common/libgstbase.def:
Index: advanced-clocks.xml
RCS file: /cvs/gstreamer/gstreamer/docs/manual/advanced-clocks.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- advanced-clocks.xml	29 Jun 2005 09:25:51 -0000	1.6
+++ advanced-clocks.xml	14 Aug 2008 14:26:20 -0000	1.7
@@ -10,6 +10,26 @@
     rate. If no clock provider is available in a pipeline, the system clock
     is used instead.
   </para>
+  
+  <para>
+    &GStreamer; derives several times 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.
+  </para>
+  <figure float="1" id="chapter-clock-img">
+    <title>&GStreamer; clock and various times</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata scale="75" fileref="images/clocks.&image;" format="&IMAGE;" />
+      </imageobject>
+    </mediaobject>  
+  </figure>
   <sect1 id="section-clocks-providers">
     <title>Clock providers</title>
--- NEW FILE: clocks.png ---
‰PNG