html5/spec Overview.html,1.1665,1.1666

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv2776

Modified Files:
	Overview.html 
Log Message:
Clarify the requirements around HAVE_METADATA. (whatwg r2495)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1665
retrieving revision 1.1666
diff -u -d -r1.1665 -r1.1666
--- Overview.html	1 Dec 2008 10:44:00 -0000	1.1665
+++ Overview.html	1 Dec 2008 11:25:10 -0000	1.1666
@@ -13503,7 +13503,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>The <code><a href=#video>video</a></code> element supports <a href=#dimension-attributes>dimension
   attributes</a>.<p>Video content should be rendered inside the element's playback
   area such that the video content is shown centered in the playback
@@ -14226,9 +14226,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>
 
@@ -14241,12 +14242,19 @@
          <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
@@ -14508,11 +14516,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>
 
@@ -15127,7 +15136,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>

Received on Monday, 1 December 2008 11:25:23 UTC