Clarify timestamps.
authorSilvia Pfeiffer
Mon, 17 Jun 2013 14:44:53 +1000
changeset 100 57bfbc727b1e
parent 99 65c8e7918606
child 101 159eddd1b648
Clarify timestamps.
webvtt/webvtt.html
--- a/webvtt/webvtt.html	Mon Jun 17 14:16:44 2013 +1000
+++ b/webvtt/webvtt.html	Mon Jun 17 14:44:53 2013 +1000
@@ -899,42 +899,21 @@
   and end offsets of the <a>WebVTT cue</a>. Different cues can
   overlap. Cues are always listed ordered by their start time.</p>
 
-  <p>A <dfn>WebVTT timestamp</dfn> representing a time in seconds and
-  fractions of a second is a <a>WebVTT timestamp</a>
-  representing hours <var
+  <p>A <dfn>WebVTT timestamp</dfn> can be either a
+  <a title="complete WebVTT timestamp">WebVTT timestamp representing
+  hours, minutes, seconds and thousandths of a second</a> or a
+  <a title="partial WebVTT timestamp">WebVTT timestamp representing
+  a time in seconds and fractions of a second</a>.</p>
+
+  <p class="note">A <a>WebVTT timestamp</a> is always interpreted
+  relative to the <a>current playback position</a> of the media data
+  that the WebVTT file is to be synchronised with, which always starts
+  at 0.</p>
+
+  <p>A <dfn title="complete WebVTT timestamp">WebVTT timestamp representing hours <var
   title="">hours</var>, minutes <var title="">minutes</var>, seconds
   <var title="">seconds</var>, and thousandths of a second <var
-  title="">seconds-frac</var>, calculated as follows:</p>
-
-  <ol>
-
-   <li><p>Let <var title="">seconds</var> be the integer part of the
-   time.</p></li>
-
-   <li><p>Let <var title="">seconds-frac</var> be the fractional
-   component of the time, expressed as the digits of the decimal
-   fraction given to three decimal digits.</p></li>
-
-   <li><p>If <var title="">seconds</var> is greater than 59, then let
-   <var title="">minutes</var> be the integer component of <var
-   title="">seconds</var> divided by sixty, and then let <var
-   title="">seconds</var> be the remainder of dividing <var
-   title="">seconds</var> divided by sixty. Otherwise, let <var
-   title="">minutes</var> be zero.</p></li>
-
-   <li><p>If <var title="">minutes</var> is greater than 59, then let
-   <var title="">hours</var> be the integer component of <var
-   title="">minutes</var> divided by sixty, and then let <var
-   title="">minutes</var> be the remainder of dividing <var
-   title="">minutes</var> divided by sixty. Otherwise, let <var
-   title="">hours</var> be zero.</p></li>
-
-  </ol>
-
-  <p>A <a>WebVTT timestamp</a> representing hours <var
-  title="">hours</var>, minutes <var title="">minutes</var>, seconds
-  <var title="">seconds</var>, and thousandths of a second <var
-  title="">seconds-frac</var>, consists of the following components,
+  title="">seconds-frac</var></dfn>, consists of the following components,
   in the given order:</p>
 
   <ol>
@@ -967,6 +946,37 @@
 
   </ol>
 
+  <p>A <dfn title="partial WebVTT timestamp">WebVTT timestamp representing a time
+  in seconds and fractions of a second</dfn> is a <a>WebVTT timestamp</a>
+  representing hours <var title="">hours</var>, minutes <var title="">minutes</var>, seconds
+  <var title="">seconds</var>, and thousandths of a second <var
+  title="">seconds-frac</var>, calculated as follows:</p>
+
+  <ol>
+
+   <li><p>Let <var title="">seconds</var> be the integer part of the
+   time.</p></li>
+
+   <li><p>Let <var title="">seconds-frac</var> be the fractional
+   component of the time, expressed as the digits of the decimal
+   fraction given to three decimal digits.</p></li>
+
+   <li><p>If <var title="">seconds</var> is greater than 59, then let
+   <var title="">minutes</var> be the integer component of <var
+   title="">seconds</var> divided by sixty, and then let <var
+   title="">seconds</var> be the remainder of dividing <var
+   title="">seconds</var> divided by sixty. Otherwise, let <var
+   title="">minutes</var> be zero.</p></li>
+
+   <li><p>If <var title="">minutes</var> is greater than 59, then let
+   <var title="">hours</var> be the integer component of <var
+   title="">minutes</var> divided by sixty, and then let <var
+   title="">minutes</var> be the remainder of dividing <var
+   title="">minutes</var> divided by sixty. Otherwise, let <var
+   title="">hours</var> be zero.</p></li>
+
+  </ol>
+
   <p>A <dfn>WebVTT cue settings list</dfn> consist of a sequence of zero or more
   <dfn>WebVTT cue settings</dfn> in any order, separated from each other
   by one or more U+0020 SPACE characters or U+0009 CHARACTER TABULATION (tab) characters.