Skip to content

Commit

Permalink
[gow] (2) Clarify the requirements around HAVE_METADATA.
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@2495 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Dec 1, 2008
1 parent 9073e74 commit 846a401
Show file tree
Hide file tree
Showing 2 changed files with 54 additions and 35 deletions.
39 changes: 24 additions & 15 deletions index
View file
Expand Up @@ -16566,7 +16566,7 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
attribute must return the <a href=#concept-video-intrinsic-width title=concept-video-intrinsic-width>intrinsic width</a> of the
video in CSS pixels. The <dfn id=dom-video-videoheight title=dom-video-videoHeight><code>videoHeight</code></dfn> DOM
attribute must return the <a href=#concept-video-intrinsic-height title=concept-video-intrinsic-height>intrinsic height</a> of
the video in CSS pixels. If no video data is available, then the
the video in CSS pixels. If the element's <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> attribute is <code title=dom-media-HAVE_NOTHING><a href=#dom-media-have_nothing>HAVE_NOTHING</a></code>, then the
attributes must return 0.</p>

<p>The <code><a href=#video>video</a></code> element supports <a href=#dimension-attributes>dimension
Expand Down Expand Up @@ -17444,9 +17444,10 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
</ol></dd>


<dt>Once enough of the <a href=#media-data>media data</a> has been fetched
to determine the duration of the <a href=#media-resource>media resource</a>, its
dimensions, and other metadata</dt>
<dt id=getting-media-metadata>Once enough of the <a href=#media-data>media
data</a> has been fetched to determine the duration of the
<a href=#media-resource>media resource</a>, its dimensions, and other
metadata</dt>

<dd>

Expand All @@ -17459,12 +17460,19 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<li><p>Set the <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> attribute to
<code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code>.</li>

<li><p class=note>A number of attributes, including <code title=dom-media-duration><a href=#dom-media-duration>duration</a></code>, <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code>, and <code title=dom-media-played><a href=#dom-media-played>played</a></code>, become
available.</li>
<li><p>For <code><a href=#video>video</a></code> elements, set the <code title=dom-video-videoWidth><a href=#dom-video-videowidth>videoWidth</a></code> and <code title=dom-video-videoHeight><a href=#dom-video-videoheight>videoHeight</a></code>
attributes.</li>

<li><p class=note>The user agent <a href=#durationChange>will</a> <a href=#queue-a-task>queue a task</a> to
<a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-durationchange><a href=#event-durationchange>durationchange</a></code> at the
element at this point.</li>
<li>

<p>Set the <code title=dom-media-duration><a href=#dom-media-duration>duration</a></code>
attribute to the duration of the resource.</p>

<p class=note>The user agent <a href=#durationChange>will</a> <a href=#queue-a-task>queue a task</a> to
<a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-durationchange><a href=#event-durationchange>durationchange</a></code> at the
element at this point.</p>

</li>

<li id=fire-loadedmetadata><p><a href=#queue-a-task>Queue a task</a> to
<a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-loadedmetadata><a href=#event-loadedmetadata>loadedmetadata</a></code> at the
Expand Down Expand Up @@ -17770,11 +17778,12 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael

<dt><dfn id=dom-media-have_metadata title=dom-media-HAVE_METADATA><code>HAVE_METADATA</code></dfn> (numeric value 1)</dt>

<dd>Enough of the resource has been obtained that the metadata
attributes are initialized (e.g. the length is known). The API will
no longer raise an exception when seeking. No video data is
available for the immediate <a href=#current-playback-position>current playback position</a>,
</dd>
<dd>Enough of the resource has been obtained that the duration of
the resource is available. In the case of a <code><a href=#video>video</a></code>
element, the dimensions of the video are also available. The API
will no longer raise 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>

<dt><dfn id=dom-media-have_current_data title=dom-media-HAVE_CURRENT_DATA><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>

Expand Down Expand Up @@ -18530,7 +18539,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael

<tbody><tr><td><dfn id=event-loadedmetadata title=event-loadedmetadata><code>loadedmetadata</code></dfn>
<td><code>Event</code>
<td>The user agent has just received the metadata, such as duration or dimensions, for the <a href=#media-resource>media resource</a>.
<td>The user agent has just determined the the duration and dimensions of the <a href=#media-resource>media resource</a>.
<td><code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is newly equal to <code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or greater for the first time.
<tr><td><dfn id=event-loadeddata title=event-loadeddata><code>loadeddata</code></dfn>
<td><code>Event</code>
Expand Down
50 changes: 30 additions & 20 deletions source
View file
Expand Up @@ -17772,7 +17772,9 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
title="dom-video-videoHeight"><code>videoHeight</code></dfn> DOM
attribute must return the <span
title="concept-video-intrinsic-height">intrinsic height</span> of
the video in CSS pixels. If no video data is available, then the
the video in CSS pixels. If the element's <code
title="dom-media-readyState">readyState</code> attribute is <code
title="dom-media-HAVE_NOTHING">HAVE_NOTHING</code>, then the
attributes must return 0.</p>

<p>The <code>video</code> element supports <span>dimension
Expand Down Expand Up @@ -18779,9 +18781,10 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
</dd>


<dt>Once enough of the <span>media data</span> has been fetched
to determine the duration of the <span>media resource</span>, its
dimensions, and other metadata</dt>
<dt id="getting-media-metadata">Once enough of the <span>media
data</span> has been fetched to determine the duration of the
<span>media resource</span>, its dimensions, and other
metadata</dt>

<dd>

Expand All @@ -18798,17 +18801,23 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
<code
title="dom-media-HAVE_METADATA">HAVE_METADATA</code>.</p></li>

<li><p class="note">A number of attributes, including <code
title="dom-media-duration">duration</code>, <code
title="dom-media-buffered">buffered</code>, and <code
title="dom-media-played">played</code>, become
available.</p></li>
<li><p>For <code>video</code> elements, set the <code
title="dom-video-videoWidth">videoWidth</code> and <code
title="dom-video-videoHeight">videoHeight</code>
attributes.</p></li>

<li><p class="note">The user agent <a
href="#durationChange">will</a> <span>queue a task</span> to
<span>fire a simple event</span> called <code
title="event-durationchange">durationchange</code> at the
element at this point.</li>
<li>

<p>Set the <code title="dom-media-duration">duration</code>
attribute to the duration of the resource.</p>

<p class="note">The user agent <a
href="#durationChange">will</a> <span>queue a task</span> to
<span>fire a simple event</span> called <code
title="event-durationchange">durationchange</code> at the
element at this point.</p>

</li>

<li id="fire-loadedmetadata"><p><span>Queue a task</span> to
<span>fire a simple event</span> called <code
Expand Down Expand Up @@ -19186,11 +19195,12 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {

<dt><dfn title="dom-media-HAVE_METADATA"><code>HAVE_METADATA</code></dfn> (numeric value 1)</dt>

<dd>Enough of the resource has been obtained that the metadata
attributes are initialized (e.g. the length is known). The API will
no longer raise an exception when seeking. No video data is
available for the immediate <span>current playback position</span>,
</dd>
<dd>Enough of the resource has been obtained that the duration of
the resource is available. In the case of a <code>video</code>
element, the dimensions of the video are also available. The API
will no longer raise an exception when seeking. No <span>media
data</span> is available for the immediate <span>current playback
position</span>.</dd>

<dt><dfn title="dom-media-HAVE_CURRENT_DATA"><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>

Expand Down Expand Up @@ -20109,7 +20119,7 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
<tr>
<td><dfn title="event-loadedmetadata"><code>loadedmetadata</code></dfn>
<td><code>Event</code>
<td>The user agent has just received the metadata, such as duration or dimensions, for the <span>media resource</span>.
<td>The user agent has just determined the the duration and dimensions of the <span>media resource</span>.
<td><code title="dom-media-readyState">readyState</code> is newly equal to <code title="dom-media-HAVE_METADATA">HAVE_METADATA</code> or greater for the first time.
<tr>
<td><dfn title="event-loadeddata"><code>loadeddata</code></dfn>
Expand Down

0 comments on commit 846a401

Please sign in to comment.