- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 15 Jun 2012 22:59:46 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv4074
Modified Files:
Overview.html media-elements.html spec.html
spec.preprocessed.html
Log Message:
Allow UAs that have downloaded at least two frames of video to go into the canplaythrough mode if they aren't going to bother getting any more however long the app and user wait. (whatwg r7138)
[updated by splitter]
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/Overview.html,v
retrieving revision 1.1812
retrieving revision 1.1813
diff -u -d -r1.1812 -r1.1813
--- Overview.html 15 Jun 2012 22:00:10 -0000 1.1812
+++ Overview.html 15 Jun 2012 22:59:37 -0000 1.1813
@@ -365,7 +365,7 @@
<dt>Editor:</dt>
<dd><a href="mailto:ian@hixie.ch">Ian Hickson</a>, Google, Inc.</dd>
</dl><p>This specification is available in the following formats: <a href="spec.html">single page HTML</a>, <a href="Overview.html">multipage HTML</a>, <a href="http://dev.w3.org/html5/spec/">full specification</a>.
- This is revision 1.5689.</p>
+ This is revision 1.5690.</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2012 <a href="http://www.w3.org/"><abbr title="World Wide
Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.html,v
retrieving revision 1.1958
retrieving revision 1.1959
diff -u -d -r1.1958 -r1.1959
--- spec.html 15 Jun 2012 22:00:10 -0000 1.1958
+++ spec.html 15 Jun 2012 22:59:37 -0000 1.1959
@@ -367,7 +367,7 @@
<dt>Editor:</dt>
<dd><a href="mailto:ian@hixie.ch">Ian Hickson</a>, Google, Inc.</dd>
</dl><p>This specification is available in the following formats: <a href="spec.html">single page HTML</a>, <a href="Overview.html">multipage HTML</a>, <a href="http://dev.w3.org/html5/spec/">full specification</a>.
- This is revision 1.5689.</p>
+ This is revision 1.5690.</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2012 <a href="http://www.w3.org/"><abbr title="World Wide
Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts
@@ -16804,26 +16804,26 @@
</dl><dl><dt><dfn aria-haspopup="true" id="dom-media-have_nothing" role="button" tabindex="0"><code>HAVE_NOTHING</code></dfn> (numeric value 0)</dt>
- <dd>No information regarding the <a href="#media-resource" id="media-resource_31">media resource</a> is
+ <dd><p>No information regarding the <a href="#media-resource" id="media-resource_31">media resource</a> is
available. No data for the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
is available. <a href="#media-element" id="media-element_22" title="media element">Media elements</a>
whose <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code>
attribute are set to <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty" id="network_empty">NETWORK_EMPTY</a></code> are always in
the <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing" id="have_nothing">HAVE_NOTHING</a></code>
- state.</dd>
+ state.</p></dd>
<dt><dfn aria-haspopup="true" id="dom-media-have_metadata" role="button" tabindex="0"><code>HAVE_METADATA</code></dfn> (numeric value 1)</dt>
- <dd>Enough of the resource has been obtained that the duration of
+ <dd><p>Enough of the resource has been obtained that the duration of
the resource is available. In the case of a <code><a href="#the-video-element" id="video_33">video</a></code>
element, the dimensions of the video are also available. The API
will no longer throw an exception when seeking. No <a href="#media-data" id="media-data_2">media
data</a> is available for the immediate <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback
- position</a>.</dd>
+ position</a>.</p></dd>
<dt><dfn aria-haspopup="true" id="dom-media-have_current_data" role="button" tabindex="0"><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>
- <dd>Data for the immediate <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
+ <dd><p>Data for the immediate <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
is available, but either not enough data is available that the user
agent could successfully advance the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback
position</a> in the <a href="http://dev.w3.org/html5/spec/media-elements.html#direction-of-playback" class="full-spec-link" title='Read about this "direction of playback" reference in the full HTML5 spec.'>direction of playback</a> at all
@@ -16832,11 +16832,11 @@
playback</a>. For example, in video this corresponds to the user
agent having data from the current frame, but not the next frame,
when the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a> is at the end of
- the current frame; and to when <a href="http://dev.w3.org/html5/spec/media-elements.html#ended-playback" title='Read about this "playback has ended" reference in the full HTML5 spec.' class="full-spec-link">playback has ended</a>.</dd>
+ the current frame; and to when <a href="http://dev.w3.org/html5/spec/media-elements.html#ended-playback" title='Read about this "playback has ended" reference in the full HTML5 spec.' class="full-spec-link">playback has ended</a>.</p></dd>
<dt><dfn aria-haspopup="true" id="dom-media-have_future_data" role="button" tabindex="0"><code>HAVE_FUTURE_DATA</code></dfn> (numeric value 3)</dt>
- <dd>Data for the immediate <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
+ <dd><p>Data for the immediate <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
is available, as well as enough data for the user agent to advance
the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a> in the <a href="http://dev.w3.org/html5/spec/media-elements.html#direction-of-playback" class="full-spec-link" title='Read about this "direction of playback" reference in the full HTML5 spec.'>direction
of playback</a> at least a little without immediately reverting
@@ -16849,16 +16849,28 @@
frame and audio data to keep playing at least a little when the
<a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a> is in the middle of a frame.
The user agent cannot be in this state if <a href="http://dev.w3.org/html5/spec/media-elements.html#ended-playback" title='Read about this "playback has ended" reference in the full HTML5 spec.' class="full-spec-link">playback has ended</a>, as the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback
- position</a> can never advance in this case.</dd>
+ position</a> can never advance in this case.</p></dd>
<dt><dfn aria-haspopup="true" id="dom-media-have_enough_data" role="button" tabindex="0"><code>HAVE_ENOUGH_DATA</code></dfn> (numeric value 4)</dt>
- <dd>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data" id="have_future_data_0">HAVE_FUTURE_DATA</a></code> state
- are met, and, in addition, the user agent estimates that data is
- being fetched at a rate where the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback
- position</a>, if it were to advance at the <a href="http://dev.w3.org/html5/spec/media-elements.html#effective-playback-rate" class="full-spec-link" title='Read about this "effective playback rate" reference in the full HTML5 spec.'>effective
- playback rate</a>, would not overtake the available data before
- playback reaches the end of the <a href="#media-resource" id="media-resource_32">media resource</a>.</dd>
+ <dd>
+
+ <p>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data" id="have_future_data_0">HAVE_FUTURE_DATA</a></code> state
+ are met, and, in addition, either of the following conditions is
+ also true:</p>
+
+ <ul><li>The user agent estimates that data is being fetched at a rate
+ where the <a href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" class="full-spec-link" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>, if it were to
+ advance at the <a href="http://dev.w3.org/html5/spec/media-elements.html#effective-playback-rate" class="full-spec-link" title='Read about this "effective playback rate" reference in the full HTML5 spec.'>effective playback rate</a>, would not
+ overtake the available data before playback reaches the end of
+ the <a href="#media-resource" id="media-resource_32">media resource</a>.</li>
+
+ <li>The user agent has entered a state where waiting longer will
+ not result in further data being obtained, and therefore nothing
+ would be gained by delaying playback any further. (For example,
+ the buffer might be full.)</li>
+
+ </ul></dd>
</dl><p class="note">In practice, the difference between <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata" id="have_metadata_2">HAVE_METADATA</a></code> and <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data" id="have_current_data_0">HAVE_CURRENT_DATA</a></code> is
negligible. Really the only time the difference is relevant is when
Index: media-elements.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/media-elements.html,v
retrieving revision 1.75
retrieving revision 1.76
diff -u -d -r1.75 -r1.76
--- media-elements.html 11 Jun 2012 23:59:09 -0000 1.75
+++ media-elements.html 15 Jun 2012 22:59:37 -0000 1.76
@@ -803,7 +803,7 @@
</dl><dl><dt><dfn aria-haspopup="true" id="dom-media-have_nothing" role="button" tabindex="0"><code>HAVE_NOTHING</code></dfn> (numeric value 0)</dt>
- <dd>No information regarding the <a href="#media-resource" id="media-resource_31">media resource</a> is
+ <dd><p>No information regarding the <a href="#media-resource" id="media-resource_31">media resource</a> is
available. No data for the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
is available. <a href="#media-element" id="media-element_22" title="media element">Media elements</a>
whose <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code>
@@ -813,7 +813,7 @@
<dt><dfn aria-haspopup="true" id="dom-media-have_metadata" role="button" tabindex="0"><code>HAVE_METADATA</code></dfn> (numeric value 1)</dt>
- <dd>Enough of the resource has been obtained that the duration of
+ <dd><p>Enough of the resource has been obtained that the duration of
the resource is available. In the case of a <code><a href="the-video-element.html#the-video-element" id="video_33">video</a></code>
element, the dimensions of the video are also available. The API
will no longer throw an exception when seeking. No <a href="#media-data" id="media-data_2">media
@@ -822,7 +822,7 @@
<dt><dfn aria-haspopup="true" id="dom-media-have_current_data" role="button" tabindex="0"><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>
- <dd>Data for the immediate <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
+ <dd><p>Data for the immediate <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
is available, but either not enough data is available that the user
agent could successfully advance the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback
position</a> in the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#direction-of-playback" title='Read about this "direction of playback" reference in the full HTML5 spec.'>direction of playback</a> at all
@@ -835,7 +835,7 @@
<dt><dfn aria-haspopup="true" id="dom-media-have_future_data" role="button" tabindex="0"><code>HAVE_FUTURE_DATA</code></dfn> (numeric value 3)</dt>
- <dd>Data for the immediate <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
+ <dd><p>Data for the immediate <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>
is available, as well as enough data for the user agent to advance
the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a> in the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#direction-of-playback" title='Read about this "direction of playback" reference in the full HTML5 spec.'>direction
of playback</a> at least a little without immediately reverting
@@ -852,12 +852,24 @@
<dt><dfn aria-haspopup="true" id="dom-media-have_enough_data" role="button" tabindex="0"><code>HAVE_ENOUGH_DATA</code></dfn> (numeric value 4)</dt>
- <dd>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data" id="have_future_data_0">HAVE_FUTURE_DATA</a></code> state
- are met, and, in addition, the user agent estimates that data is
- being fetched at a rate where the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback
- position</a>, if it were to advance at the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#effective-playback-rate" title='Read about this "effective playback rate" reference in the full HTML5 spec.'>effective
- playback rate</a>, would not overtake the available data before
- playback reaches the end of the <a href="#media-resource" id="media-resource_32">media resource</a>.</dd>
+ <dd>
+
+ <p>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data" id="have_future_data_0">HAVE_FUTURE_DATA</a></code> state
+ are met, and, in addition, either of the following conditions is
+ also true:</p>
+
+ <ul><li>The user agent estimates that data is being fetched at a rate
+ where the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#current-playback-position" title='Read about this "current playback position" reference in the full HTML5 spec.'>current playback position</a>, if it were to
+ advance at the <a class="full-spec-link" href="http://dev.w3.org/html5/spec/media-elements.html#effective-playback-rate" title='Read about this "effective playback rate" reference in the full HTML5 spec.'>effective playback rate</a>, would not
+ overtake the available data before playback reaches the end of
+ the <a href="#media-resource" id="media-resource_32">media resource</a>.</li>
+
+ <li>The user agent has entered a state where waiting longer will
+ not result in further data being obtained, and therefore nothing
+ would be gained by delaying playback any further. (For example,
+ the buffer might be full.)</li>
+
+ </ul></dd>
</dl><p class="note">In practice, the difference between <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata" id="have_metadata_2">HAVE_METADATA</a></code> and <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data" id="have_current_data_0">HAVE_CURRENT_DATA</a></code> is
negligible. Really the only time the difference is relevant is when
Index: spec.preprocessed.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.preprocessed.html,v
retrieving revision 1.794
retrieving revision 1.795
diff -u -d -r1.794 -r1.795
--- spec.preprocessed.html 15 Jun 2012 22:00:22 -0000 1.794
+++ spec.preprocessed.html 15 Jun 2012 22:59:43 -0000 1.795
@@ -383,7 +383,7 @@
<dt>Editor:</dt>
<dd><a href="mailto:ian@hixie.ch">Ian Hickson</a>, Google, Inc.</dd>
</dl><p>This specification is available in the following formats: <a href="spec.html">single page HTML</a>, <a href="Overview.html">multipage HTML</a>, <a href="http://dev.w3.org/html5/spec/">full specification</a>.
- This is revision 1.5689.</p>
+ This is revision 1.5690.</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2012 <a href="http://www.w3.org/"><abbr title="World Wide
Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts
@@ -16644,26 +16644,26 @@
<dl><dt><dfn id="dom-media-have_nothing" role="button" tabindex="0" aria-haspopup="true"><code>HAVE_NOTHING</code></dfn> (numeric value 0)</dt>
- <dd>No information regarding the <a href="#media-resource">media resource</a> is
+ <dd><p>No information regarding the <a href="#media-resource">media resource</a> is
available. No data for the <a href="#current-playback-position">current playback position</a>
is available. <a href="#media-element" title="media element">Media elements</a>
whose <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code>
attribute are set to <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> are always in
the <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>
- state.</dd>
+ state.</p></dd>
<dt><dfn id="dom-media-have_metadata" role="button" tabindex="0" aria-haspopup="true"><code>HAVE_METADATA</code></dfn> (numeric value 1)</dt>
- <dd>Enough of the resource has been obtained that the duration of
+ <dd><p>Enough of the resource has been obtained that the duration of
the resource is available. In the case of a <code><a href="#the-video-element">video</a></code>
element, the dimensions of the video are also available. The API
will no longer throw an exception when seeking. No <a href="#media-data">media
data</a> is available for the immediate <a href="#current-playback-position">current playback
- position</a>.</dd>
+ position</a>.</p></dd>
<dt><dfn id="dom-media-have_current_data" role="button" tabindex="0" aria-haspopup="true"><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>
- <dd>Data for the immediate <a href="#current-playback-position">current playback position</a>
+ <dd><p>Data for the immediate <a href="#current-playback-position">current playback position</a>
is available, but either not enough data is available that the user
agent could successfully advance the <a href="#current-playback-position">current playback
position</a> in the <a href="#direction-of-playback">direction of playback</a> at all
@@ -16673,11 +16673,11 @@
agent having data from the current frame, but not the next frame,
when the <a href="#current-playback-position">current playback position</a> is at the end of
the current frame; and to when <a href="#ended-playback" title="ended
- playback">playback has ended</a>.</dd>
+ playback">playback has ended</a>.</p></dd>
<dt><dfn id="dom-media-have_future_data" role="button" tabindex="0" aria-haspopup="true"><code>HAVE_FUTURE_DATA</code></dfn> (numeric value 3)</dt>
- <dd>Data for the immediate <a href="#current-playback-position">current playback position</a>
+ <dd><p>Data for the immediate <a href="#current-playback-position">current playback position</a>
is available, as well as enough data for the user agent to advance
the <a href="#current-playback-position">current playback position</a> in the <a href="#direction-of-playback">direction
of playback</a> at least a little without immediately reverting
@@ -16691,16 +16691,28 @@
<a href="#current-playback-position">current playback position</a> is in the middle of a frame.
The user agent cannot be in this state if <a href="#ended-playback" title="ended
playback">playback has ended</a>, as the <a href="#current-playback-position">current playback
- position</a> can never advance in this case.</dd>
+ position</a> can never advance in this case.</p></dd>
<dt><dfn id="dom-media-have_enough_data" role="button" tabindex="0" aria-haspopup="true"><code>HAVE_ENOUGH_DATA</code></dfn> (numeric value 4)</dt>
- <dd>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> state
- are met, and, in addition, the user agent estimates that data is
- being fetched at a rate where the <a href="#current-playback-position">current playback
- position</a>, if it were to advance at the <a href="#effective-playback-rate">effective
- playback rate</a>, would not overtake the available data before
- playback reaches the end of the <a href="#media-resource">media resource</a>.</dd>
+ <dd>
+
+ <p>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> state
+ are met, and, in addition, either of the following conditions is
+ also true:</p>
+
+ <ul><li>The user agent estimates that data is being fetched at a rate
+ where the <a href="#current-playback-position">current playback position</a>, if it were to
+ advance at the <a href="#effective-playback-rate">effective playback rate</a>, would not
+ overtake the available data before playback reaches the end of
+ the <a href="#media-resource">media resource</a>.</li>
+
+ <li>The user agent has entered a state where waiting longer will
+ not result in further data being obtained, and therefore nothing
+ would be gained by delaying playback any further. (For example,
+ the buffer might be full.)</li>
+
+ </ul></dd>
</dl><p class="note">In practice, the difference between <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> and <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> is
negligible. Really the only time the difference is relevant is when
Received on Friday, 15 June 2012 22:59:50 UTC