Skip to content

Commit

Permalink
[] (0) Remove bufferedBytes and totalBytes.
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@2405 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Nov 15, 2008
1 parent 911d5fa commit 64f6157
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 146 deletions.
81 changes: 11 additions & 70 deletions index
View file
Expand Up @@ -447,9 +447,8 @@
<li><a href=#seeking><span class=secno>4.8.10.10 </span>Seeking</a></li>
<li><a href=#user-interface><span class=secno>4.8.10.11 </span>User interface</a></li>
<li><a href=#time-ranges><span class=secno>4.8.10.12 </span>Time ranges</a></li>
<li><a href=#byte-ranges><span class=secno>4.8.10.13 </span>Byte ranges</a></li>
<li><a href=#mediaevents><span class=secno>4.8.10.14 </span>Event summary</a></li>
<li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.15 </span>Security and privacy considerations</a></ol></li>
<li><a href=#mediaevents><span class=secno>4.8.10.13 </span>Event summary</a></li>
<li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.14 </span>Security and privacy considerations</a></ol></li>
<li><a href=#the-canvas-element><span class=secno>4.8.11 </span>The <code>canvas</code> element</a>
<ol>
<li><a href=#the-2d-context><span class=secno>4.8.11.1 </span>The 2D context</a>
Expand Down Expand Up @@ -16853,8 +16852,6 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
readonly attribute float <a href=#dom-media-bufferingrate title=dom-media-bufferingRate>bufferingRate</a>;
readonly attribute boolean <a href=#dom-media-bufferingthrottled title=dom-media-bufferingThrottled>bufferingThrottled</a>;
readonly attribute <a href=#timeranges>TimeRanges</a> <a href=#dom-media-buffered title=dom-media-buffered>buffered</a>;
readonly attribute <a href=#byteranges>ByteRanges</a> <a href=#dom-media-bufferedbytes title=dom-media-bufferedBytes>bufferedBytes</a>;
readonly attribute unsigned long <a href=#dom-media-totalbytes title=dom-media-totalBytes>totalBytes</a>;
void <a href=#dom-media-load title=dom-media-load>load</a>();
DOMString <a href=#dom-navigator-canplaytype title=dom-navigator-canPlayType>canPlayType</a>(in DOMString type);

Expand Down Expand Up @@ -17633,30 +17630,20 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
attribute must return a static <a href=#normalized-timeranges-object>normalized
<code>TimeRanges</code> object</a> that represents the ranges of
the <a href=#media-resource>media resource</a>, if any, that the user agent has
buffered, at the time the attribute is evaluated.</p>
buffered, at the time the attribute is evaluated. Users agents must
accurately determine the ranges available, even for media streams
where this can only be determined by tedious inspection.</p>

<p class=note>Typically this will be a single range anchored at
the zero point, but if, e.g. the user agent uses HTTP range requests
in response to seeking, then there could be multiple ranges.</p>

<p>The <dfn id=dom-media-bufferedbytes title=dom-media-bufferedBytes><code>bufferedBytes</code></dfn>
attribute must return a static <a href=#normalized-byteranges-object>normalized
<code>ByteRanges</code> object</a> that represents the ranges of
the <a href=#media-resource>media resource</a>, if any, that the user agent has
buffered, at the time the attribute is evaluated.</p>

<p>The <dfn id=dom-media-totalbytes title=dom-media-totalBytes><code>totalBytes</code></dfn> attribute
must return the length of the <a href=#media-resource>media resource</a>, in bytes,
if it is known and finite. If it is not known, is infinite
(e.g. streaming radio), or if no <a href=#media-data>media data</a> is
available, the attribute must return 0.</p>

<p>User agents may discard previously buffered data.</p>

<p class=note>Thus, a time or byte position included within a
range of the objects return by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code> or <code title=dom-media-bufferedBytes><a href=#dom-media-bufferedbytes>bufferedBytes</a></code> attributes at
one time can end up being not included in the range(s) of objects
returned by the same attributes at a later time.</p>
<p class=note>Thus, a time position included within a range of the
objects return by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code> attribute at one time can
end up being not included in the range(s) of objects returned by the
same attribute at later times.</p>



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



<h5 id=byte-ranges><span class=secno>4.8.10.13 </span>Byte ranges</h5>

<p>Objects implementing the <code><a href=#byteranges>ByteRanges</a></code> interface
represent a list of ranges of bytes.</p>

<pre class=idl>interface <dfn id=byteranges>ByteRanges</dfn> {
readonly attribute unsigned long <a href=#dom-byteranges-length title=dom-ByteRanges-length>length</a>;
unsigned long <a href=#dom-byteranges-start title=dom-ByteRanges-start>start</a>(in unsigned long index);
unsigned long <a href=#dom-byteranges-end title=dom-ByteRanges-end>end</a>(in unsigned long index);
};</pre>

<p>The <dfn id=dom-byteranges-length title=dom-ByteRanges-length><code>length</code></dfn>
DOM attribute must return the number of ranges represented by the object.</p>

<p>The <dfn id=dom-byteranges-start title=dom-ByteRanges-start><code>start(<var title="">index</var>)</code></dfn> method must return the position
of the first byte of the <var title="">index</var>th range
represented by the object.</p>

<p>The <dfn id=dom-byteranges-end title=dom-ByteRanges-end><code>end(<var title="">index</var>)</code></dfn> method must return the position
of the byte immediately after the last byte of the <var title="">index</var>th range represented by the object. (The byte
position returned by this method is not in the range itself. If the
first byte of the range is the byte at position 0, and the entire
stream of bytes is in the range, then the value of the position of
the byte returned by this method for that range will be the same as
the number of bytes in the stream.)</p>

<p>These methods must raise <code>INDEX_SIZE_ERR</code> exceptions
if called with an <var title="">index</var> argument greater than or
equal to the number of ranges represented by the object.</p>

<p>When a <code><a href=#byteranges>ByteRanges</a></code> object is said to be a
<dfn id=normalized-byteranges-object>normalized <code>ByteRanges</code> object</dfn>, the ranges it
represents must obey the following criteria:</p>

<ul><li>The start of a range must be greater than the end of all
earlier ranges.</li>

<li>The start of a range must be less than the end of that same
range.</li>

</ul><p>In other words, the ranges in such an object are ordered, don't
overlap, aren't empty, and don't touch (adjacent ranges are folded
into one bigger range).</p>



<h5 id=mediaevents><span class=secno>4.8.10.14 </span>Event summary</h5>
<h5 id=mediaevents><span class=secno>4.8.10.13 </span>Event summary</h5>

<p>The following events fire on <a href=#media-element title="media element">media
elements</a> as part of the processing model described above:</p>
Expand Down Expand Up @@ -18586,7 +18527,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<td><code>Event</code>
<td>Either the <code title=dom-media-volume><a href=#dom-media-volume>volume</a></code> attribute or the <code title=dom-media-muted><a href=#dom-media-muted>muted</a></code> attribute has changed. Fired after the relevant attribute's setter has returned.
<td>
</table><h5 id=security-and-privacy-considerations><span class=secno>4.8.10.15 </span>Security and privacy considerations</h5>
</table><h5 id=security-and-privacy-considerations><span class=secno>4.8.10.14 </span>Security and privacy considerations</h5>

<p class=XXX>Talk about making sure interactive media files
(e.g. SVG) don't have access to the container DOM (XSS potential);
Expand Down
84 changes: 8 additions & 76 deletions source
View file
Expand Up @@ -18082,8 +18082,6 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
readonly attribute float <span title="dom-media-bufferingRate">bufferingRate</span>;
readonly attribute boolean <span title="dom-media-bufferingThrottled">bufferingThrottled</span>;
readonly attribute <span>TimeRanges</span> <span title="dom-media-buffered">buffered</span>;
readonly attribute <span>ByteRanges</span> <span title="dom-media-bufferedBytes">bufferedBytes</span>;
readonly attribute unsigned long <span title="dom-media-totalBytes">totalBytes</span>;
void <span title="dom-media-load">load</span>();
DOMString <span title="dom-navigator-canPlayType">canPlayType</span>(in DOMString type);

Expand Down Expand Up @@ -19025,34 +19023,21 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {
attribute must return a static <span>normalized
<code>TimeRanges</code> object</span> that represents the ranges of
the <span>media resource</span>, if any, that the user agent has
buffered, at the time the attribute is evaluated.</p>
buffered, at the time the attribute is evaluated. Users agents must
accurately determine the ranges available, even for media streams
where this can only be determined by tedious inspection.</p>

<p class="note">Typically this will be a single range anchored at
the zero point, but if, e.g. the user agent uses HTTP range requests
in response to seeking, then there could be multiple ranges.</p>

<p>The <dfn
title="dom-media-bufferedBytes"><code>bufferedBytes</code></dfn>
attribute must return a static <span>normalized
<code>ByteRanges</code> object</span> that represents the ranges of
the <span>media resource</span>, if any, that the user agent has
buffered, at the time the attribute is evaluated.</p>

<p>The <dfn
title="dom-media-totalBytes"><code>totalBytes</code></dfn> attribute
must return the length of the <span>media resource</span>, in bytes,
if it is known and finite. If it is not known, is infinite
(e.g. streaming radio), or if no <span>media data</span> is
available, the attribute must return 0.</p>

<p>User agents may discard previously buffered data.</p>

<p class="note">Thus, a time or byte position included within a
range of the objects return by the <code
title="dom-media-buffered">buffered</code> or <code
title="dom-media-bufferedBytes">bufferedBytes</code> attributes at
one time can end up being not included in the range(s) of objects
returned by the same attributes at a later time.</p>
<p class="note">Thus, a time position included within a range of the
objects return by the <code
title="dom-media-buffered">buffered</code> attribute at one time can
end up being not included in the range(s) of objects returned by the
same attribute at later times.</p>



Expand Down Expand Up @@ -19982,59 +19967,6 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {



<h5>Byte ranges</h5>

<p>Objects implementing the <code>ByteRanges</code> interface
represent a list of ranges of bytes.</p>

<pre class="idl">interface <dfn>ByteRanges</dfn> {
readonly attribute unsigned long <span title="dom-ByteRanges-length">length</span>;
unsigned long <span title="dom-ByteRanges-start">start</span>(in unsigned long index);
unsigned long <span title="dom-ByteRanges-end">end</span>(in unsigned long index);
};</pre>

<p>The <dfn title="dom-ByteRanges-length"><code>length</code></dfn>
DOM attribute must return the number of ranges represented by the object.</p>

<p>The <dfn title="dom-ByteRanges-start"><code>start(<var
title="">index</var>)</code></dfn> method must return the position
of the first byte of the <var title="">index</var>th range
represented by the object.</p>

<p>The <dfn title="dom-ByteRanges-end"><code>end(<var
title="">index</var>)</code></dfn> method must return the position
of the byte immediately after the last byte of the <var
title="">index</var>th range represented by the object. (The byte
position returned by this method is not in the range itself. If the
first byte of the range is the byte at position 0, and the entire
stream of bytes is in the range, then the value of the position of
the byte returned by this method for that range will be the same as
the number of bytes in the stream.)</p>

<p>These methods must raise <code>INDEX_SIZE_ERR</code> exceptions
if called with an <var title="">index</var> argument greater than or
equal to the number of ranges represented by the object.</p>

<p>When a <code>ByteRanges</code> object is said to be a
<dfn>normalized <code>ByteRanges</code> object</dfn>, the ranges it
represents must obey the following criteria:</p>

<ul>

<li>The start of a range must be greater than the end of all
earlier ranges.</li>

<li>The start of a range must be less than the end of that same
range.</li>

</ul>

<p>In other words, the ranges in such an object are ordered, don't
overlap, aren't empty, and don't touch (adjacent ranges are folded
into one bigger range).</p>



<h5 id="mediaevents">Event summary</h5>

<p>The following events fire on <span title="media element">media
Expand Down

0 comments on commit 64f6157

Please sign in to comment.