[giow] (1) Better definition of media.played.

Affected topics: Video and Audio git-svn-id: http://svn.whatwg.org/webapps@7131 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jun 13, 2012 · 6bd1fc2 · 6bd1fc2
1 parent ffa731d
commit 6bd1fc2
Show file tree

Hide file tree

Showing 3 changed files with 49 additions and 25 deletions.
diff --git a/complete.html b/complete.html
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 11 June 2012</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 13 June 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -30663,8 +30663,10 @@ <h5 id=playing-the-media-resource><span class=secno>4.8.10.8 </span>Playing the
   <hr><p>The <dfn id=dom-media-played title=dom-media-played><code>played</code></dfn>
   attribute must return a new static <a href=#normalized-timeranges-object>normalized
   <code>TimeRanges</code> object</a> that represents the ranges of
-  the <a href=#media-resource>media resource</a>, if any, that the user agent has so
-  far rendered, at the time the attribute is evaluated.</p>
+  points on the <a href=#media-timeline>media timeline</a> of the <a href=#media-resource>media
+  resource</a> reached through the usual monotonic increase of the
+  <a href=#current-playback-position>current playback position</a> during normal playback, if
+  any, at the time the attribute is evaluated.</p>
 
   <hr><p>When the <dfn id=dom-media-play title=dom-media-play><code>play()</code></dfn>
   method on a <a href=#media-element>media element</a> is invoked, the user agent
@@ -30791,8 +30793,11 @@ <h5 id=playing-the-media-resource><span class=secno>4.8.10.8 </span>Playing the
   <a href=#potentially-playing>potentially playing</a> and its <code><a href=#document>Document</a></code> is a
   <a href=#fully-active>fully active</a> <code><a href=#document>Document</a></code>, its <a href=#current-playback-position>current
   playback position</a> must increase monotonically at
-  <a href=#effective-playback-rate>effective playback rate</a> units of media time per unit time
-  of the <a href=#media-timeline>media timeline</a>'s clock.</p>
+  <a href=#effective-playback-rate>effective playback rate</a> units of media time per unit
+  time of the <a href=#media-timeline>media timeline</a>'s clock. (This specification
+  always refers to this as an <i>increase</i>, but that increase could
+  actually be a <em>de</em>crease if the <a href=#effective-playback-rate>effective playback
+  rate</a> is negative.)</p>
 
   <p class=note>The <a href=#effective-playback-rate>effective playback rate</a> can be 0.0,
   in which case the <a href=#current-playback-position>current playback position</a> doesn't
@@ -32138,10 +32143,13 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
   <p>The <dfn id=dom-mediacontroller-played title=dom-MediaController-played><code>played</code></dfn>
   attribute must return a new static <a href=#normalized-timeranges-object>normalized
   <code>TimeRanges</code> object</a> that represents the union of
-  the ranges of the <a href=#media-resource title="media resource">media
+  the ranges of points on the <a href=#media-timeline title="media timeline">media
+  timelines</a> of the <a href=#media-resource title="media resource">media
   resources</a> of the <a href=#slaved-media-elements>slaved media elements</a> that the
-  user agent has so far rendered, at the time the attribute is
-  evaluated.</p>
+  user agent has so far reached through the usual monotonic increase
+  of their <a href=#current-playback-position title="current playback position">current playback
+  positions</a> during normal playback, at the time the attribute
+  is evaluated.</p>
 
   <hr><p>A <code><a href=#mediacontroller>MediaController</a></code> has a <dfn id=media-controller-default-playback-rate>media controller
   default playback rate</dfn> and a <dfn id=media-controller-playback-rate>media controller playback
@@ -36499,7 +36507,7 @@ <h6 id=text-styles><span class=secno>4.8.11.1.4 </span>Text styles</h6>
 
   <!-- this is filler to make sure the TCP packet boundary doesn't fall in the middle of one of the NCRs below -->
   <!-- (because otherwise the parser in anolis screws it up) -->
-  <p><img alt="The top of the em square is roughly at the top of the glyphs in a font, the hanging baseline is where some glyphs like &#2310; are anchored, the middle is half-way between the top of the em square and the bottom of the em square, the alphabetic baseline is where characters like &Aacute;, &yuml;, f, and &Omega; are anchored, the ideographic baseline is where glyphs like &#31169; and &#36948; are anchored, and the bottom of the em square is roughly at the bottom of the glyphs in a font. The top and bottom of the bounding box can be far from these baselines, due to glyphs extending far outside the em square." height=300 src=http://images.whatwg.org/baselines.png width=738></p>
+  <p><img alt="The top of the em square is roughly at the top of the glyphs in a font, the hanging baseline is where some glyphs like &#2310; are anchored, the middle is half-way between the top of the em square and the bottom of the em square, the alphabetic baseline is where characters like " height=300 src=http://images.whatwg.org/baselines.png width=738>x00C1;, &yuml;, f, and &Omega; are anchored, the ideographic baseline is where glyphs like &#31169; and &#36948; are anchored, and the bottom of the em square is roughly at the bottom of the glyphs in a font. The top and bottom of the bounding box can be far from these baselines, due to glyphs extending far outside the em square."&gt;</p>
 
   <p>The keywords map to these alignment points as follows:</p>
 

diff --git a/index b/index
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 11 June 2012</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 13 June 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -30663,8 +30663,10 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
   <hr><p>The <dfn id=dom-media-played title=dom-media-played><code>played</code></dfn>
   attribute must return a new static <a href=#normalized-timeranges-object>normalized
   <code>TimeRanges</code> object</a> that represents the ranges of
-  the <a href=#media-resource>media resource</a>, if any, that the user agent has so
-  far rendered, at the time the attribute is evaluated.</p>
+  points on the <a href=#media-timeline>media timeline</a> of the <a href=#media-resource>media
+  resource</a> reached through the usual monotonic increase of the
+  <a href=#current-playback-position>current playback position</a> during normal playback, if
+  any, at the time the attribute is evaluated.</p>
 
   <hr><p>When the <dfn id=dom-media-play title=dom-media-play><code>play()</code></dfn>
   method on a <a href=#media-element>media element</a> is invoked, the user agent
@@ -30791,8 +30793,11 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
   <a href=#potentially-playing>potentially playing</a> and its <code><a href=#document>Document</a></code> is a
   <a href=#fully-active>fully active</a> <code><a href=#document>Document</a></code>, its <a href=#current-playback-position>current
   playback position</a> must increase monotonically at
-  <a href=#effective-playback-rate>effective playback rate</a> units of media time per unit time
-  of the <a href=#media-timeline>media timeline</a>'s clock.</p>
+  <a href=#effective-playback-rate>effective playback rate</a> units of media time per unit
+  time of the <a href=#media-timeline>media timeline</a>'s clock. (This specification
+  always refers to this as an <i>increase</i>, but that increase could
+  actually be a <em>de</em>crease if the <a href=#effective-playback-rate>effective playback
+  rate</a> is negative.)</p>
 
   <p class=note>The <a href=#effective-playback-rate>effective playback rate</a> can be 0.0,
   in which case the <a href=#current-playback-position>current playback position</a> doesn't
@@ -32138,10 +32143,13 @@ interface <dfn id=mediacontroller>MediaController</dfn> {
   <p>The <dfn id=dom-mediacontroller-played title=dom-MediaController-played><code>played</code></dfn>
   attribute must return a new static <a href=#normalized-timeranges-object>normalized
   <code>TimeRanges</code> object</a> that represents the union of
-  the ranges of the <a href=#media-resource title="media resource">media
+  the ranges of points on the <a href=#media-timeline title="media timeline">media
+  timelines</a> of the <a href=#media-resource title="media resource">media
   resources</a> of the <a href=#slaved-media-elements>slaved media elements</a> that the
-  user agent has so far rendered, at the time the attribute is
-  evaluated.</p>
+  user agent has so far reached through the usual monotonic increase
+  of their <a href=#current-playback-position title="current playback position">current playback
+  positions</a> during normal playback, at the time the attribute
+  is evaluated.</p>
 
   <hr><p>A <code><a href=#mediacontroller>MediaController</a></code> has a <dfn id=media-controller-default-playback-rate>media controller
   default playback rate</dfn> and a <dfn id=media-controller-playback-rate>media controller playback
@@ -36499,7 +36507,7 @@ hairline width with transform. ack Shaun Morris.  --></div>
 
   <!-- this is filler to make sure the TCP packet boundary doesn't fall in the middle of one of the NCRs below -->
   <!-- (because otherwise the parser in anolis screws it up) -->
-  <p><img alt="The top of the em square is roughly at the top of the glyphs in a font, the hanging baseline is where some glyphs like &#2310; are anchored, the middle is half-way between the top of the em square and the bottom of the em square, the alphabetic baseline is where characters like &Aacute;, &yuml;, f, and &Omega; are anchored, the ideographic baseline is where glyphs like &#31169; and &#36948; are anchored, and the bottom of the em square is roughly at the bottom of the glyphs in a font. The top and bottom of the bounding box can be far from these baselines, due to glyphs extending far outside the em square." height=300 src=http://images.whatwg.org/baselines.png width=738></p>
+  <p><img alt="The top of the em square is roughly at the top of the glyphs in a font, the hanging baseline is where some glyphs like &#2310; are anchored, the middle is half-way between the top of the em square and the bottom of the em square, the alphabetic baseline is where characters like " height=300 src=http://images.whatwg.org/baselines.png width=738>x00C1;, &yuml;, f, and &Omega; are anchored, the ideographic baseline is where glyphs like &#31169; and &#36948; are anchored, and the bottom of the em square is roughly at the bottom of the glyphs in a font. The top and bottom of the bounding box can be far from these baselines, due to glyphs extending far outside the em square."&gt;</p>
 
   <p>The keywords map to these alignment points as follows:</p>
 

diff --git a/source b/source
@@ -33395,8 +33395,10 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
   <p>The <dfn title="dom-media-played"><code>played</code></dfn>
   attribute must return a new static <span>normalized
   <code>TimeRanges</code> object</span> that represents the ranges of
-  the <span>media resource</span>, if any, that the user agent has so
-  far rendered, at the time the attribute is evaluated.</p>
+  points on the <span>media timeline</span> of the <span>media
+  resource</span> reached through the usual monotonic increase of the
+  <span>current playback position</span> during normal playback, if
+  any, at the time the attribute is evaluated.</p>
 
   <hr>
 
@@ -33563,8 +33565,11 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
   <span>potentially playing</span> and its <code>Document</code> is a
   <span>fully active</span> <code>Document</code>, its <span>current
   playback position</span> must increase monotonically at
-  <span>effective playback rate</span> units of media time per unit time
-  of the <span>media timeline</span>'s clock.</p>
+  <span>effective playback rate</span> units of media time per unit
+  time of the <span>media timeline</span>'s clock. (This specification
+  always refers to this as an <i>increase</i>, but that increase could
+  actually be a <em>de</em>crease if the <span>effective playback
+  rate</span> is negative.)</p>
 
   <p class="note">The <span>effective playback rate</span> can be 0.0,
   in which case the <span>current playback position</span> doesn't
@@ -35096,10 +35101,13 @@ interface <dfn>MediaController</dfn> {
   title="dom-MediaController-played"><code>played</code></dfn>
   attribute must return a new static <span>normalized
   <code>TimeRanges</code> object</span> that represents the union of
-  the ranges of the <span title="media resource">media
+  the ranges of points on the <span title="media timeline">media
+  timelines</span> of the <span title="media resource">media
   resources</span> of the <span>slaved media elements</span> that the
-  user agent has so far rendered, at the time the attribute is
-  evaluated.</p>
+  user agent has so far reached through the usual monotonic increase
+  of their <span title="current playback position">current playback
+  positions</span> during normal playback, at the time the attribute
+  is evaluated.</p>
 
   <hr>