[] (1) work in progress -- declarations for states not yet defined

git-svn-id: http://svn.whatwg.org/webapps@700 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Apr 1, 2007 · 3684d65 · 3684d65
1 parent 2bd0151
commit 3684d65
Show file tree

Hide file tree

Showing 2 changed files with 81 additions and 33 deletions.
diff --git a/index b/index
@@ -22,7 +22,7 @@
 
    <h1 id=web-applications>Web Applications 1.0</h1>
 
-   <h2 class="no-num no-toc" id=working>Working Draft &mdash; 29 March 2007</h2>
+   <h2 class="no-num no-toc" id=working>Working Draft &mdash; 1 April 2007</h2>
 
    <p>You can take part in this work. <a
     href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -12907,6 +12907,8 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
   readonly attribute unsigned long <a href="#videoheight" title=dom-video-videoHeight>videoHeight</a>;
 };</pre>
   </dl>
+  <!-- XXX request: changing the playback aspect ratio -->
+  <!-- XXX request: applying CSS filters -->
 
   <p>A <code><a href="#video2">video</a></code> element represents a video or
    movie.
@@ -13146,19 +13148,37 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
   readonly attribute DOMString <a href="#currentsrc" title=dom-media-currentSrc>currentSrc</a>;
   readonly attribute float <a href="#duration" title=dom-media-duration>duration</a>;
 
-  // playback state
+  <span class=big-issue> The next three blocks are not yet defined. </span>
+
+  // network state
   const unsigned short <a href="#empty" title=dom-media-EMPTY>EMPTY</a> = 0;
-  const unsigned short <a href="#playing" title=dom-media-PLAYING>PLAYING</a> = 1;
-  const unsigned short <a href="#paused" title=dom-media-PAUSED>PAUSED</a> = 2;
-  const unsigned short <a href="#autopaused" title=dom-media-AUTO_PAUSED>AUTO_PAUSED</a> = 3;
-  readonly attribute unsigned short <a href="#state" title=dom-media-state>state</a>;
-  readonly attribute boolean <a href="#buffering" title=dom-media-buffering>buffering</a>;
+  const unsigned short <span title=dom-media-LOADING>LOADING</span> = 1;
+  const unsigned short <a href="#buffering" title=dom-media-BUFFERING>BUFFERING</a> = 2;
+  const unsigned short <span title=dom-media-LOADED>LOADED</span> = 10;
+  const unsigned short <span title=dom-media-ERROR>ERROR</span> = 100;
+  readonly attribute unsigned short <span title=dom-media-networkState>networkState</span>;
   readonly attribute boolean <a href="#seeking" title=dom-media-seeking>seeking</a>;
-  readonly attribute boolean <a href="#ended" title=dom-media-ended>ended</a>;
+
+  // buffering state
+  const unsigned short <a href="#empty" title=dom-media-EMPTY>EMPTY</a> = 0;
+  const unsigned short <span title=dom-media-PARTIAL>PARTIAL</span> = 1;
+  const unsigned short <span title=dom-media-PAUSABLE>PAUSABLE</span> = 2;
+  const unsigned short <span title=dom-media-PLAYABLE>PLAYABLE</span> = 3;
+  const unsigned short <span title=dom-media-ENDABLE>ENDABLE</span> = 4;
+  const unsigned short <span title=dom-media-LOADED>LOADED</span> = 10;
+  readonly attribute unsigned short <span title=dom-media-bufferingState>bufferingState</span>;
   readonly attribute float <a href="#bufferingrate" title=dom-media-bufferingRate>bufferingRate</a>;
   readonly attribute <a href="#timeranges">TimeRanges</a> <a href="#buffered" title=dom-media-buffered>buffered</a>;
-  readonly attribute float <a href="#position0" title=dom-media-position>position</a>;
+
+  // playback state
+  const unsigned short <a href="#empty" title=dom-media-EMPTY>EMPTY</a> = 0;
+  const unsigned short <a href="#playing" title=dom-media-PLAYING>PLAYING</a> = 1;
+  const unsigned short <span title=dom-media-WAITING>WAITING</span> = 2;
+  const unsigned short <a href="#paused" title=dom-media-PAUSED>PAUSED</a> = 3;
+  readonly attribute unsigned short <span title=dom-media-playbackState>playbackState</span>;
   readonly attribute <a href="#timeranges">TimeRanges</a> <a href="#played" title=dom-media-played>played</a>;
+  readonly attribute boolean <a href="#ended" title=dom-media-ended>ended</a>;
+  readonly attribute float <a href="#position0" title=dom-media-position>position</a>;
 
   // controls
            attribute boolean <a href="#controls0" title=dom-media-controls>controls</a>;
@@ -13190,14 +13210,11 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
    <code title=attr-media-controls><a href="#controls">controls</a></code>,
    apply to all <span>media elements</span>. They are defined in this
    section.</p>
-  <!-- XXX v1 features:
+  <!-- XXX v2 features:
     * more events from:
       http://webkit.org/specs/HTML_Timed_Media_Elements.html
       e.g. mediarendererror
-    * fire an 'ended' event when playback ends and 'ended' becomes true
     * volumechange mutechange
-  -->
-  <!-- XXX v1.5 features
     * change rate/direction of playback (ffwd)
     * frame forward / backwards / step(n) while paused
     * ability to insert a bunch of "stop points"; points where the
@@ -13207,10 +13224,11 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
       marks; time triggers)
     * some of the mediaStatus stuff from:
       http://webkit.org/specs/HTML_Timed_Media_Elements.html
-  -->
-  <!-- XXX v2 features: 
     * autoplay="" that waits for the buffer to be full enough that it
       is estimated that it can play all the way through without stopping
+    * ability to control looping declaratively
+  -->
+  <!-- XXX v3 features:
     * per-frame control: get current frame; set current frame
     * queue of content
       - pause current stream and insert content at front of queue to play immediately
@@ -13219,7 +13237,13 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
       - pause playback upon reaching a certain time
       - playlists, with the ability to get metadata out of them (e.g. xspf)
     * control over closed captions
-    * ability to control looping declaratively
+    * get byte ranges as well as time ranges for buffered data
+    * in-band metadata and cue points to allow:
+      - Chapter markers that synchronize to playback (without having to poll
+        the playhead position)
+      - Annotations on video content (i.e., pop-up video)
+      - General custom metadata store (ratings, etc.)
+
   -->
 
   <p><a href="#media5" title="media element">Media elements</a> are used to

diff --git a/source b/source
@@ -10893,6 +10893,9 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
    </dd>
   </dl>
 
+  <!-- XXX request: changing the playback aspect ratio -->
+  <!-- XXX request: applying CSS filters -->
+
   <p>A <code>video</code> element represents a video or movie.</p>
 
   <p>Content may be provided inside the <code>video</code> element so
@@ -11125,19 +11128,37 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
   readonly attribute DOMString <span title="dom-media-currentSrc">currentSrc</span>;
   readonly attribute float <span title="dom-media-duration">duration</span>;
 
-  // playback state
+  <span class="big-issue"> The next three blocks are not yet defined. </span>
+
+  // network state
   const unsigned short <span title="dom-media-EMPTY">EMPTY</span> = 0;
-  const unsigned short <span title="dom-media-PLAYING">PLAYING</span> = 1;
-  const unsigned short <span title="dom-media-PAUSED">PAUSED</span> = 2;
-  const unsigned short <span title="dom-media-AUTO_PAUSED">AUTO_PAUSED</span> = 3;
-  readonly attribute unsigned short <span title="dom-media-state">state</span>;
-  readonly attribute boolean <span title="dom-media-buffering">buffering</span>;
+  const unsigned short <span title="dom-media-LOADING">LOADING</span> = 1;
+  const unsigned short <span title="dom-media-BUFFERING">BUFFERING</span> = 2;
+  const unsigned short <span title="dom-media-LOADED">LOADED</span> = 10;
+  const unsigned short <span title="dom-media-ERROR">ERROR</span> = 100;
+  readonly attribute unsigned short <span title="dom-media-networkState">networkState</span>;
   readonly attribute boolean <span title="dom-media-seeking">seeking</span>;
-  readonly attribute boolean <span title="dom-media-ended">ended</span>;
+
+  // buffering state
+  const unsigned short <span title="dom-media-EMPTY">EMPTY</span> = 0;
+  const unsigned short <span title="dom-media-PARTIAL">PARTIAL</span> = 1;
+  const unsigned short <span title="dom-media-PAUSABLE">PAUSABLE</span> = 2;
+  const unsigned short <span title="dom-media-PLAYABLE">PLAYABLE</span> = 3;
+  const unsigned short <span title="dom-media-ENDABLE">ENDABLE</span> = 4;
+  const unsigned short <span title="dom-media-LOADED">LOADED</span> = 10;
+  readonly attribute unsigned short <span title="dom-media-bufferingState">bufferingState</span>;
   readonly attribute float <span title="dom-media-bufferingRate">bufferingRate</span>;
   readonly attribute <span>TimeRanges</span> <span title="dom-media-buffered">buffered</span>;
-  readonly attribute float <span title="dom-media-position">position</span>;
+
+  // playback state
+  const unsigned short <span title="dom-media-EMPTY">EMPTY</span> = 0;
+  const unsigned short <span title="dom-media-PLAYING">PLAYING</span> = 1;
+  const unsigned short <span title="dom-media-WAITING">WAITING</span> = 2;
+  const unsigned short <span title="dom-media-PAUSED">PAUSED</span> = 3;
+  readonly attribute unsigned short <span title="dom-media-playbackState">playbackState</span>;
   readonly attribute <span>TimeRanges</span> <span title="dom-media-played">played</span>;
+  readonly attribute boolean <span title="dom-media-ended">ended</span>;
+  readonly attribute float <span title="dom-media-position">position</span>;
 
   // controls
            attribute boolean <span title="dom-media-controls">controls</span>;
@@ -11169,15 +11190,11 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
   title="attr-media-controls">controls</code>, apply to all <span>media
   elements</span>. They are defined in this section.</p>
 
-  <!-- XXX v1 features:
+  <!-- XXX v2 features:
     * more events from:
       http://webkit.org/specs/HTML_Timed_Media_Elements.html
       e.g. mediarendererror
-    * fire an 'ended' event when playback ends and 'ended' becomes true
     * volumechange mutechange
-  -->
-
-  <!-- XXX v1.5 features
     * change rate/direction of playback (ffwd)
     * frame forward / backwards / step(n) while paused
     * ability to insert a bunch of "stop points"; points where the
@@ -11187,11 +11204,12 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
       marks; time triggers)
     * some of the mediaStatus stuff from:
       http://webkit.org/specs/HTML_Timed_Media_Elements.html
-  -->
-
-  <!-- XXX v2 features: 
     * autoplay="" that waits for the buffer to be full enough that it
       is estimated that it can play all the way through without stopping
+    * ability to control looping declaratively
+  -->
+
+  <!-- XXX v3 features:
     * per-frame control: get current frame; set current frame
     * queue of content
       - pause current stream and insert content at front of queue to play immediately
@@ -11200,7 +11218,13 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>
       - pause playback upon reaching a certain time
       - playlists, with the ability to get metadata out of them (e.g. xspf)
     * control over closed captions
-    * ability to control looping declaratively
+    * get byte ranges as well as time ranges for buffered data
+    * in-band metadata and cue points to allow:
+      - Chapter markers that synchronize to playback (without having to poll
+        the playhead position)
+      - Annotations on video content (i.e., pop-up video)
+      - General custom metadata store (ratings, etc.)
+
   -->
 
   <p><span title="media element">Media elements</span> are used to