[html5] r6178 - [e] (0) More notes about video.readyState.
whatwg at whatwg.org
whatwg at whatwg.org
Thu Jun 2 16:59:25 PDT 2011
Author: ianh
Date: 2011-06-02 16:59:24 -0700 (Thu, 02 Jun 2011)
New Revision: 6178
Modified:
complete.html
index
source
Log:
[e] (0) More notes about video.readyState.
Modified: complete.html
===================================================================
--- complete.html 2011-06-02 23:53:44 UTC (rev 6177)
+++ complete.html 2011-06-02 23:59:24 UTC (rev 6178)
@@ -27792,7 +27792,7 @@
<td>Hints to the user agent that either the author does not expect the user to need the media resource, or that the server wants to minimise unnecessary traffic.
<tr><td><dfn id=attr-media-preload-metadata title=attr-media-preload-metadata><code>metadata</code></dfn>
<td><dfn id=attr-media-preload-metadata-state title=attr-media-preload-metadata-state>Metadata</dfn>
- <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable.
+ <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable. If the user agent precisely fetches no more than the metadata, then the <a href=#media-element>media element</a> will end up with its <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> attribute set to <code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code>; typically though, some frames will be obtained as well and it will be <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> or <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code>.
<tr><td><dfn id=attr-media-preload-auto title=attr-media-preload-auto><code>auto</code></dfn>
<td><dfn id=attr-media-preload-auto-state title=attr-media-preload-auto-state>Automatic</dfn>
<td>Hints to the user agent that the user agent can put the user's needs first without risk to the server, up to and including optimistically downloading the entire resource.
@@ -28200,7 +28200,12 @@
negligible. Really the only time the difference is relevant is when
painting a <code><a href=#the-video-element>video</a></code> element onto a <code><a href=#the-canvas-element>canvas</a></code>,
where it distinguishes the case where something will be drawn (<code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> or
- greater) from the case where nothing is drawn (<code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or less).</p>
+ greater) from the case where nothing is drawn (<code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or less).
+ Similarly, the difference between <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> (only
+ the current frame) and <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code> (at least
+ this frame and the next) can be negligible (in the extreme, only one
+ frame). The only time that distinction really matters is when a page
+ provides an interface for "frame-by-frame" navigation.</p>
<div class=impl>
Modified: index
===================================================================
--- index 2011-06-02 23:53:44 UTC (rev 6177)
+++ index 2011-06-02 23:59:24 UTC (rev 6178)
@@ -27781,7 +27781,7 @@
<td>Hints to the user agent that either the author does not expect the user to need the media resource, or that the server wants to minimise unnecessary traffic.
<tr><td><dfn id=attr-media-preload-metadata title=attr-media-preload-metadata><code>metadata</code></dfn>
<td><dfn id=attr-media-preload-metadata-state title=attr-media-preload-metadata-state>Metadata</dfn>
- <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable.
+ <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable. If the user agent precisely fetches no more than the metadata, then the <a href=#media-element>media element</a> will end up with its <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> attribute set to <code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code>; typically though, some frames will be obtained as well and it will be <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> or <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code>.
<tr><td><dfn id=attr-media-preload-auto title=attr-media-preload-auto><code>auto</code></dfn>
<td><dfn id=attr-media-preload-auto-state title=attr-media-preload-auto-state>Automatic</dfn>
<td>Hints to the user agent that the user agent can put the user's needs first without risk to the server, up to and including optimistically downloading the entire resource.
@@ -28189,7 +28189,12 @@
negligible. Really the only time the difference is relevant is when
painting a <code><a href=#the-video-element>video</a></code> element onto a <code><a href=#the-canvas-element>canvas</a></code>,
where it distinguishes the case where something will be drawn (<code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> or
- greater) from the case where nothing is drawn (<code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or less).</p>
+ greater) from the case where nothing is drawn (<code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or less).
+ Similarly, the difference between <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> (only
+ the current frame) and <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code> (at least
+ this frame and the next) can be negligible (in the extreme, only one
+ frame). The only time that distinction really matters is when a page
+ provides an interface for "frame-by-frame" navigation.</p>
<div class=impl>
Modified: source
===================================================================
--- source 2011-06-02 23:53:44 UTC (rev 6177)
+++ source 2011-06-02 23:59:24 UTC (rev 6178)
@@ -30283,7 +30283,7 @@
<tr>
<td><dfn title="attr-media-preload-metadata"><code>metadata</code></dfn>
<td><dfn title="attr-media-preload-metadata-state">Metadata</dfn>
- <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable.
+ <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable. If the user agent precisely fetches no more than the metadata, then the <span>media element</span> will end up with its <code title="dom-media-readyState">readyState</code> attribute set to <code title="dom-media-HAVE_METADATA">HAVE_METADATA</code>; typically though, some frames will be obtained as well and it will be <code title="dom-media-HAVE_CURRENT_DATA">HAVE_CURRENT_DATA</code> or <code title="dom-media-HAVE_FUTURE_DATA">HAVE_FUTURE_DATA</code>.
<tr>
<td><dfn title="attr-media-preload-auto"><code>auto</code></dfn>
<td><dfn title="attr-media-preload-auto-state">Automatic</dfn>
@@ -30746,7 +30746,14 @@
where it distinguishes the case where something will be drawn (<code
title="dom-media-HAVE_CURRENT_DATA">HAVE_CURRENT_DATA</code> or
greater) from the case where nothing is drawn (<code
- title="dom-media-HAVE_METADATA">HAVE_METADATA</code> or less).</p>
+ title="dom-media-HAVE_METADATA">HAVE_METADATA</code> or less).
+ Similarly, the difference between <code
+ title="dom-media-HAVE_CURRENT_DATA">HAVE_CURRENT_DATA</code> (only
+ the current frame) and <code
+ title="dom-media-HAVE_FUTURE_DATA">HAVE_FUTURE_DATA</code> (at least
+ this frame and the next) can be negligible (in the extreme, only one
+ frame). The only time that distinction really matters is when a page
+ provides an interface for "frame-by-frame" navigation.</p>
<div class="impl">
More information about the Commit-Watchers
mailing list