[html5] r1850 - [gow] (2) Define handling of poster frame on <video> in more detail.

whatwg at whatwg.org whatwg at whatwg.org
Tue Jul 8 15:58:46 PDT 2008


Author: ianh
Date: 2008-07-08 15:58:43 -0700 (Tue, 08 Jul 2008)
New Revision: 1850

Modified:
   index
   source
Log:
[gow] (2) Define handling of poster frame on <video> in more detail.

Modified: index
===================================================================
--- index	2008-07-07 09:17:51 UTC (rev 1849)
+++ index	2008-07-08 22:58:43 UTC (rev 1850)
@@ -25,7 +25,7 @@
 
    <h1 id=html-5>HTML 5</h1>
 
-   <h2 class="no-num no-toc" id=draft>Draft Recommendation — 7 July
+   <h2 class="no-num no-toc" id=draft>Draft Recommendation — 8 July
     2008</h2>
 
    <p>You can take part in this work. <a
@@ -16735,7 +16735,7 @@
            attribute long <a href="#height4" title=dom-dim-height>height</a>;
   readonly attribute unsigned long <a href="#videowidth" title=dom-video-videoWidth>videoWidth</a>;
   readonly attribute unsigned long <a href="#videoheight" title=dom-video-videoHeight>videoHeight</a>;
-           attribute DOMString <a href="#poster0" title=dom-video-poster>poster</a>;
+           attribute DOMString <a href="#poster1" title=dom-video-poster>poster</a>;
 };</pre>
   </dl>
 
@@ -16781,16 +16781,18 @@
    a <a href="#valid">valid URL</a>. If the specified resource is to be used,
    it must be fetched when the element is created or when the <code
    title=attr-video-poster><a href="#poster">poster</a></code> attribute is
-   set.</p>
-  <!-- So that it is unaffected by changes to the base URL.
-  -->
+   set. The <dfn id=poster0>poster frame</dfn> is then the image obtained
+   from that resource, if any.</p>
+  <!-- So that it is unaffected by changes
+  to the base URL.  -->
 
   <p class=note>The image given by the <code title=attr-video-poster><a
-   href="#poster">poster</a></code> attribute is intended to be a <i>poster
-   frame</i>, a representative frame of the video (typically one of the first
-   non-blank frames) that gives the user an idea of what the video is like.
+   href="#poster">poster</a></code> attribute, the <i><a
+   href="#poster0">poster frame</a></i>, is intended to be a representative
+   frame of the video (typically one of the first non-blank frames) that
+   gives the user an idea of what the video is like.
 
-  <p>The <dfn id=poster0 title=dom-video-poster><code>poster</code></dfn> DOM
+  <p>The <dfn id=poster1 title=dom-video-poster><code>poster</code></dfn> DOM
    attribute must <a href="#reflect">reflect</a> the <code
    title=attr-video-poster><a href="#poster">poster</a></code> content
    attribute.
@@ -16805,6 +16807,8 @@
    the video corresponds to one CSS pixel. If no video data is available,
    then the attributes must return 0.
 
+  <hr>
+
   <p>When no video data is available (the element's <code
    title=dom-media-networkState><a
    href="#networkstate">networkState</a></code> attribute is either <code
@@ -16812,31 +16816,21 @@
    title=dom-media-LOADING><a href="#loading0">LOADING</a></code>, or <code
    title=dom-media-LOADED_METADATA><a
    href="#loadedmetadata">LOADED_METADATA</a></code>), <code><a
-   href="#video1">video</a></code> elements represent either the image given
-   by the <code title=attr-video-poster><a href="#poster">poster</a></code>
-   attribute, or nothing.
+   href="#video1">video</a></code> elements represent either the <a
+   href="#poster0">poster frame</a>, or nothing.
 
   <p>When a <code><a href="#video1">video</a></code> element is <a
-   href="#actively">actively playing</a>, it represents the frame of video at
-   the continuously increasing <a href="#current0" title="current playback
-   position">"current" position</a>. When the <a href="#current0">current
-   playback position</a> changes such that the last frame rendered is no
-   longer the frame corresponding to the <a href="#current0">current playback
-   position</a> in the video, the new frame must be rendered. Similarly, any
-   audio associated with the video must, if played, be played synchronized
-   with the <a href="#current0">current playback position</a>, at the
-   specified <a href="#volume" title=dom-media-volume>volume</a> with the
-   specified <a href="#muted" title=dom-media-muted>mute state</a>.
-
-  <p>When a <code><a href="#video1">video</a></code> element is <a
    href="#paused" title=dom-media-paused>paused</a> and the <a
    href="#current0" title="current playback position">current playback
    position</a> is the first frame of video, the element represents either
    the frame of video corresponding to the <a href="#current0" title="current
-   playback position">current playback position</a> or the image given by the
-   <code title=attr-video-poster><a href="#poster">poster</a></code>
-   attribute, at the discretion of the user agent.
+   playback position">current playback position</a> or the <a
+   href="#poster0">poster frame</a>, at the discretion of the user agent.
 
+  <p>Notwithstanding the above, the <a href="#poster0">poster frame</a>
+   should be preferred over nothing, but the <a href="#poster0">poster
+   frame</a> should not be shown again after a frame of video has been shown.
+
   <p>When a <code><a href="#video1">video</a></code> element is <a
    href="#paused" title=dom-media-paused>paused</a> at any other position,
    the element represents the frame of video corresponding to the <a
@@ -16844,6 +16838,18 @@
    position</a>, or, if that is not yet available (e.g. because the video is
    seeking or buffering), the last frame of the video to have been rendered.
 
+  <p>When a <code><a href="#video1">video</a></code> element is <a
+   href="#actively">actively playing</a>, it represents the frame of video at
+   the continuously increasing <a href="#current0" title="current playback
+   position">"current" position</a>. When the <a href="#current0">current
+   playback position</a> changes such that the last frame rendered is no
+   longer the frame corresponding to the <a href="#current0">current playback
+   position</a> in the video, the new frame must be rendered. Similarly, any
+   audio associated with the video must, if played, be played synchronized
+   with the <a href="#current0">current playback position</a>, at the
+   specified <a href="#volume" title=dom-media-volume>volume</a> with the
+   specified <a href="#muted" title=dom-media-muted>mute state</a>.
+
   <p>When a <code><a href="#video1">video</a></code> element is neither <a
    href="#actively">actively playing</a> nor <a href="#paused"
    title=dom-media-paused>paused</a> (e.g. when seeking or stalled), the
@@ -16900,21 +16906,18 @@
 
   <p>The intrinsic width of a <code><a href="#video1">video</a></code>
    element's playback area is the intrinsic width of the video resource, if
-   that is available; otherwise it is the intrinsic width of the resource
-   given by the <code title=attr-video-poster><a
-   href="#poster">poster</a></code> attribute, if that is available;
-   otherwise it is 300 CSS pixels.
+   that is available; otherwise it is the intrinsic width of the <a
+   href="#poster0">poster frame</a>, if that is available; otherwise it is
+   300 CSS pixels.
 
   <p>The intrinsic height of a <code><a href="#video1">video</a></code>
    element's playback area is the intrinsic height of the video resource, if
-   that is available; otherwise it is the intrinsic height of the resource
-   given by the <code title=attr-video-poster><a
-   href="#poster">poster</a></code> attribute, if that is available;
-   otherwise it is 150 CSS pixels.
+   that is available; otherwise it is the intrinsic height of the <a
+   href="#poster0">poster frame</a>, if that is available; otherwise it is
+   150 CSS pixels.
 
-  <p class=note>The image given by the <code title=attr-video-poster><a
-   href="#poster">poster</a></code> attribute is not affected by the pixel
-   ratio conversions.
+  <p class=note>The <a href="#poster0">poster frame</a> is not affected by
+   the pixel ratio conversions.
 
   <hr>
   <!-- XXX

Modified: source
===================================================================
--- source	2008-07-07 09:17:51 UTC (rev 1849)
+++ source	2008-07-08 22:58:43 UTC (rev 1850)
@@ -14581,12 +14581,13 @@
   must contain a <span>valid URL</span>. If the specified resource is
   to be used, it must be fetched when the element is created or when
   the <code title="attr-video-poster">poster</code> attribute is
-  set.</p> <!-- So that it is unaffected by changes to the base URL.
-  -->
+  set. The <dfn>poster frame</dfn> is then the image obtained from
+  that resource, if any.</p> <!-- So that it is unaffected by changes
+  to the base URL.  -->
 
   <p class="note">The image given by the <code
-  title="attr-video-poster">poster</code> attribute is intended to be
-  a <i>poster frame</i>, a representative frame of the video
+  title="attr-video-poster">poster</code> attribute, the <i>poster
+  frame</i>, is intended to be a representative frame of the video
   (typically one of the first non-blank frames) that gives the user an
   idea of what the video is like.</p>
 
@@ -14606,36 +14607,28 @@
   pixel. If no video data is available, then the attributes must
   return 0.</p>
 
+  <hr>
+
   <p>When no video data is available (the element's <code
   title="dom-media-networkState">networkState</code> attribute is
   either <code title="dom-media-EMPTY">EMPTY</code>, <code
   title="dom-media-LOADING">LOADING</code>, or <code
   title="dom-media-LOADED_METADATA">LOADED_METADATA</code>),
-  <code>video</code> elements represent either the image given by the
-  <code title="attr-video-poster">poster</code> attribute, or
-  nothing.</p>
+  <code>video</code> elements represent either the <span>poster
+  frame</span>, or nothing.</p>
 
-  <p>When a <code>video</code> element is <span>actively
-  playing</span>, it represents the frame of video at the continuously
-  increasing <span title="current playback position">"current"
-  position</span>. When the <span>current playback position</span>
-  changes such that the last frame rendered is no longer the frame
-  corresponding to the <span>current playback position</span> in the
-  video, the new frame must be rendered. Similarly, any audio
-  associated with the video must, if played, be played synchronized
-  with the <span>current playback position</span>, at the specified
-  <span title="dom-media-volume">volume</span> with the specified
-  <span title="dom-media-muted">mute state</span>.</p>
-
   <p>When a <code>video</code> element is <span
   title="dom-media-paused">paused</span> and the <span title="current
   playback position">current playback position</span> is the first
   frame of video, the element represents either the frame of video
   corresponding to the <span title="current playback position">current
-  playback position</span> or the image given by the <code
-  title="attr-video-poster">poster</code> attribute, at the discretion
-  of the user agent.</p>
+  playback position</span> or the <span>poster frame</span>, at the
+  discretion of the user agent.</p>
 
+  <p>Notwithstanding the above, the <span>poster frame</span> should
+  be preferred over nothing, but the <span>poster frame</span> should
+  not be shown again after a frame of video has been shown.</p>
+
   <p>When a <code>video</code> element is <span
   title="dom-media-paused">paused</span> at any other position, the
   element represents the frame of video corresponding to the <span
@@ -14644,6 +14637,18 @@
   or buffering), the last frame of the video to have been
   rendered.</p>
 
+  <p>When a <code>video</code> element is <span>actively
+  playing</span>, it represents the frame of video at the continuously
+  increasing <span title="current playback position">"current"
+  position</span>. When the <span>current playback position</span>
+  changes such that the last frame rendered is no longer the frame
+  corresponding to the <span>current playback position</span> in the
+  video, the new frame must be rendered. Similarly, any audio
+  associated with the video must, if played, be played synchronized
+  with the <span>current playback position</span>, at the specified
+  <span title="dom-media-volume">volume</span> with the specified
+  <span title="dom-media-muted">mute state</span>.</p>
+
   <p>When a <code>video</code> element is neither <span>actively
   playing</span> nor <span title="dom-media-paused">paused</span>
   (e.g. when seeking or stalled), the element represents the last
@@ -14703,19 +14708,18 @@
 
   <p>The intrinsic width of a <code>video</code> element's playback
   area is the intrinsic width of the video resource, if that is
-  available; otherwise it is the intrinsic width of the resource given
-  by the <code title="attr-video-poster">poster</code> attribute, if
-  that is available; otherwise it is 300 CSS pixels.</p>
+  available; otherwise it is the intrinsic width of the <span>poster
+  frame</span>, if that is available; otherwise it is 300 CSS
+  pixels.</p>
 
   <p>The intrinsic height of a <code>video</code> element's playback
   area is the intrinsic height of the video resource, if that is
-  available; otherwise it is the intrinsic height of the resource given
-  by the <code title="attr-video-poster">poster</code> attribute, if
-  that is available; otherwise it is 150 CSS pixels.</p>
+  available; otherwise it is the intrinsic height of the <span>poster
+  frame</span>, if that is available; otherwise it is 150 CSS
+  pixels.</p>
 
-  <p class="note">The image given by the <code
-  title="attr-video-poster">poster</code> attribute is not affected by
-  the pixel ratio conversions.</p>
+  <p class="note">The <span>poster frame</span> is not affected by the
+  pixel ratio conversions.</p>
 
   <hr>
 




More information about the Commit-Watchers mailing list