Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Editorial: remove redundant tables #327

Merged
merged 7 commits into from
Dec 21, 2023
Merged

Editorial: remove redundant tables #327

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
27c53c8
Editorial: remove redundant tables
marcoscaceres Oct 23, 2023
d724a1d
Update media-source-respec.html
marcoscaceres Dec 8, 2023
5304ed6
Update media-source-respec.html
marcoscaceres Dec 8, 2023
04c8e30
Update media-source-respec.html
marcoscaceres Dec 8, 2023
4a663a6
Merge branch 'main' into redudant_tables
marcoscaceres Dec 18, 2023
bf9f19c
Merge branch 'main' into redudant_tables
marcoscaceres Dec 21, 2023
9f61f9a
fix markup
marcoscaceres Dec 21, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
117 changes: 12 additions & 105 deletions media-source-respec.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -571,8 +571,7 @@ <h3><dfn>removeSourceBuffer()</dfn> method</h3>
{{removesourcebuffer}} at the <a>SourceBufferList</a> returned by {{MediaSource/sourceBuffers}}.</li>
<li>Destroy all resources for |sourceBuffer|.</li>
</ol>
<table
class="parameters"><tbody><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><th class="prmName">|sourceBuffer|</th><td class="prmType">{{SourceBuffer}}</td><td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td><td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td><td class="prmDesc"></td></tr></tbody></table><div><em>Return type: </em>{{undefined}}</div></dd>
</section>

<h3><dfn>endOfStream()</dfn> method</h3>
<p>Signals the end of the stream.</p>
Expand All @@ -582,9 +581,6 @@ <h3><dfn>endOfStream()</dfn> method</h3>
<li>If the {{SourceBuffer/updating}} attribute equals true on any <a>SourceBuffer</a> in {{MediaSource/sourceBuffers}}, then throw an {{InvalidStateError}} exception and abort these steps.</li>
<li>Run the [=end of stream=] algorithm with the error parameter set to |error:EndOfStreamError|.</li>
</ol>
<table
class="parameters"><tbody><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><th class="prmName">|error|</th><td class="prmType">{{EndOfStreamError}}</td><td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td><td class="prmOptTrue"><span role="img" aria-label="True">✔</span></td><td class="prmDesc"></td></tr></tbody></table><div><em>Return type: </em>{{undefined}}</div></dd>

<h3><dfn>setLiveSeekableRange()</dfn> method</h3>

<p>Updates {{MediaSource/[[live seekable range]]}} that is used in
Expand All @@ -596,37 +592,6 @@ <h3><dfn>setLiveSeekableRange()</dfn> method</h3>
<li>Set {{MediaSource/[[live seekable range]]}} to be a new <a def-id="normalized-timeranges-object"></a>
containing a single range whose start position is |start| and end position is |end|.
</li></ol>
<table class="parameters">
<tbody>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Nullable</th>
<th>Optional</th>
<th>Description</th>
</tr>
<tr>
<th class="prmName">|start|</th>
<td class="prmType">{{double}}</td>
<td class="prmNullFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmOptFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmDesc">The start of the range, in seconds measured from [=presentation start time=]. While set, and if {{MediaSource/duration}} equals positive Infinity, {{HTMLMediaElement}}.{{HTMLMediaElement/seekable}} will return a non-empty TimeRanges object with a lowest range start timestamp no greater than |start|.</td>
</tr>
<tr>
<th class="prmName">|end|</th>
<td class="prmType">{{double}}</td>
<td class="prmNullFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmOptFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmDesc">The end of range, in seconds measured from [=presentation start time=]. While set, and if {{MediaSource/duration}} equals positive Infinity, {{HTMLMediaElement}}.{{HTMLMediaElement/seekable}} will return a non-empty TimeRanges object with a highest range end timestamp no less than |end|.</td>
</tr>
</tbody>
</table>
<div><em>Return type: </em>{{undefined}}</div></dd>

<h3><dfn>clearLiveSeekableRange()</dfn> method</h3>
<p>Updates {{MediaSource/[[live seekable range]]}} that is used in
section [[[#htmlmediaelement-extensions]]] to modify
Expand All @@ -637,7 +602,6 @@ <h3><dfn>clearLiveSeekableRange()</dfn> method</h3>
<li>If {{MediaSource/[[live seekable range]]}} contains a range, then set {{MediaSource/[[live seekable
range]]}} to be a new empty {{TimeRanges}} object.
</li></ol>
<div><em>No parameters.</em></div><div><em>Return type: </em>{{undefined}}</div>

<h3><dfn>isTypeSupported()</dfn> method</h3>
<p>Check to see whether the <a>MediaSource</a> is capable of creating <a>SourceBuffer</a> objects for the specified MIME type.</p>
Expand All @@ -656,8 +620,7 @@ <h3><dfn>isTypeSupported()</dfn> method</h3>
<p class="note">
This method returning true implies that HTMLMediaElement.canPlayType() will return "maybe" or "probably" since it does not make sense for a <a>MediaSource</a> to support a type the HTMLMediaElement knows it cannot play.
</p>
<table class="parameters"><tbody><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><th class="prmName">|type|</th><td class="prmType">{{DOMString}}</td><td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td><td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td><td class="prmDesc"></td></tr></tbody></table><div><em>Return type: </em>{{boolean}}</div></dd></dl>

</section>

<section id="mediasource-events">
<h3>Event Summary</h3>
Expand Down Expand Up @@ -1437,7 +1400,9 @@ <h2><dfn>SourceBuffer</dfn> interface</h2>
<li>[=Queue a task=] to [=fire an event=] named {{updatestart}} at this <a>SourceBuffer</a> object.</li>
<li>Asynchronously run the [=buffer append=] algorithm.</li>
</ol>
<table class="parameters"><tbody><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><th class="prmName">|data|</th><td class="prmType">{{BufferSource}}</td><td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td><td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td><td class="prmDesc"></td></tr></tbody></table><div><em>Return type: </em>{{undefined}}</div></dd><dt><dfn><code>abort</code></dfn></dt><dd>

marcoscaceres marked this conversation as resolved.
Show resolved Hide resolved
<dt><code><dfn>abort</dfn></code></dt><dd>

<p>Aborts the current segment and resets the segment parser.</p>

<ol class="method-algorithm">
Expand All @@ -1456,7 +1421,7 @@ <h2><dfn>SourceBuffer</dfn> interface</h2>
<li>Set {{SourceBuffer/appendWindowStart}} to the [=presentation start time=].</li>
<li>Set {{SourceBuffer/appendWindowEnd}} to positive Infinity.</li>
</ol>
<div><em>No parameters.</em></div><div><em>Return type: </em>{{undefined}}</div></dd>
</dd>
<dt><dfn><code>changeType</code></dfn></dt><dd>
<p>Changes the MIME type associated with this object. Subsequent {{SourceBuffer/appendBuffer()}} calls will expect the newly appended bytes to conform to the new type.</a>
<ol class="method-algorithm">
Expand Down Expand Up @@ -1490,27 +1455,13 @@ <h2><dfn>SourceBuffer</dfn> interface</h2>
<li>Set the {{SourceBuffer/[[pending initialization segment for changeType flag]]}} on this {{SourceBuffer}}
object to true.
</ol>
<table class="parameters">
<tbody>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Nullable</th>
<th>Optional</th>
<th>Description</th>
</tr>
<tr>
<th class="prmName">|type|</th>
<td class="prmType">{{DOMString}}</td>
<td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td>
<td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td>
<td class="prmDesc"></td>
</tr>
</tbody>
</table>
<div><em>Return type: </em>{{undefined}}</div></dd>
</dd>
<dt><dfn><code>remove</code></dfn></dt><dd>
<p>Removes media for a specific time range.</p>
<p>
Removes media for a specific time range.
The |start| of the removal range, in seconds measured from [=presentation start time=]
The |end| of the removal range, in seconds measured from [=presentation start time=].
</p>
<ol class="method-algorithm">
<li>If this object has been removed from the {{MediaSource/sourceBuffers}} attribute of the [=parent media source=] then throw an {{InvalidStateError}} exception and abort these steps.</li>
<li>If the {{SourceBuffer/updating}} attribute equals true, then throw an {{InvalidStateError}} exception and abort these steps.</li>
Expand All @@ -1527,37 +1478,6 @@ <h2><dfn>SourceBuffer</dfn> interface</h2>
</li>
<li>Run the [=range removal=] algorithm with |start| and |end| as the start and end of the removal range.</li>
</ol>

<table class="parameters">
<tbody>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Nullable</th>
<th>Optional</th>
<th>Description</th>
</tr>
<tr>
<th class="prmName">|start|</th>
<td class="prmType">{{double}}</td>
<td class="prmNullFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmOptFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmDesc">The start of the removal range, in seconds measured from [=presentation start time=].</td>
</tr>
<tr>
<th class="prmName">|end|</th>
<td class="prmType">{{unrestricted double}}</td>
<td class="prmNullFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmOptFalse"><span aria-label="False" role=
"img">✘</span></td>
<td class="prmDesc">The end of the removal range, in seconds measured from [=presentation start time=].</td>
</tr>
</tbody>
</table>
<div><em>Return type: </em>{{undefined}}</div>
</dd></dl>
</section>

Expand Down Expand Up @@ -2649,19 +2569,6 @@ <h2>Methods</h2>
<li>If |index:unsigned long| is greater than or equal to the {{SourceBufferList/length}} attribute then return undefined and abort these steps.</li>
<li>Return the |index|'th <a>SourceBuffer</a> object in the list.</li>
</ol>
<table class="parameters">
<tbody>
<tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr>
<tr>
<th class="prmName">|index|</th>
<td class="prmType">{{unsigned long}}</td>
<td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td>
<td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td>
<td class="prmDesc"></td>
</tr>
</tbody>
</table>
<div><em>Return type: </em>{{SourceBuffer}}</div>
</dd>
</dl>
</section>
Expand Down
Loading