[html5] r2495 - [gow] (2) Clarify the requirements around HAVE_METADATA.
whatwg at whatwg.org
whatwg at whatwg.org
Mon Dec 1 03:25:07 PST 2008
Author: ianh
Date: 2008-12-01 03:25:06 -0800 (Mon, 01 Dec 2008)
New Revision: 2495
Modified:
index
source
Log:
[gow] (2) Clarify the requirements around HAVE_METADATA.
Modified: index
===================================================================
--- index 2008-12-01 10:43:56 UTC (rev 2494)
+++ index 2008-12-01 11:25:06 UTC (rev 2495)
@@ -16566,7 +16566,7 @@
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
@@ -17444,9 +17444,10 @@
</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>
@@ -17459,13 +17460,20 @@
<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
element.</li>
@@ -17770,11 +17778,12 @@
<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>
@@ -18530,7 +18539,7 @@
<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>
Modified: source
===================================================================
--- source 2008-12-01 10:43:56 UTC (rev 2494)
+++ source 2008-12-01 11:25:06 UTC (rev 2495)
@@ -17772,7 +17772,9 @@
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
@@ -18779,9 +18781,10 @@
</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>
@@ -18798,18 +18801,24 @@
<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
title="event-loadedmetadata">loadedmetadata</code> at the
@@ -19186,11 +19195,12 @@
<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>
@@ -20109,7 +20119,7 @@
<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>
More information about the Commit-Watchers
mailing list