Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[e] (0) Add a note about HAVE_METADATA vs HAVE_CURRENT_DATA
git-svn-id: http://svn.whatwg.org/webapps@6177 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jun 2, 2011
1 parent 295c89a commit 47029ca
Show file tree
Hide file tree
Showing 3 changed files with 24 additions and 2 deletions.
8 changes: 7 additions & 1 deletion complete.html
Expand Up @@ -28196,7 +28196,13 @@ <h5 id=the-ready-states><span class=secno>4.8.10.7 </span>The ready states</h5>
playback rate</a>, would not overtake the available data before
playback reaches the end of the <a href=#media-resource>media resource</a>.</dd>

</dl><div class=impl>
</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
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>

<div class=impl>

<p>When the ready state of a <a href=#media-element>media element</a> whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> is not <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> changes, the
user agent must follow the steps given below:</p>
Expand Down
8 changes: 7 additions & 1 deletion index
Expand Up @@ -28185,7 +28185,13 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
playback rate</a>, would not overtake the available data before
playback reaches the end of the <a href=#media-resource>media resource</a>.</dd>

</dl><div class=impl>
</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
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>

<div class=impl>

<p>When the ready state of a <a href=#media-element>media element</a> whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> is not <code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code> changes, the
user agent must follow the steps given below:</p>
Expand Down
10 changes: 10 additions & 0 deletions source
Expand Up @@ -30738,6 +30738,16 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>

</dl>

<p class="note">In practice, the difference between <code
title="dom-media-HAVE_METADATA">HAVE_METADATA</code> and <code
title="dom-media-HAVE_CURRENT_DATA">HAVE_CURRENT_DATA</code> is
negligible. Really the only time the difference is relevant is when
painting a <code>video</code> element onto a <code>canvas</code>,
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>

<div class="impl">

<p>When the ready state of a <span>media element</span> whose <code
Expand Down

0 comments on commit 47029ca

Please sign in to comment.