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

Clarify the Seekhead elements #616

Merged
merged 4 commits into from Jul 3, 2022
Merged

Clarify the Seekhead elements #616

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1fa1aba
SeekHead: SeekId and SeekPosition reference a Top-Level element
robUx4 Jun 19, 2022
6352505
SeekHead: Add a link to the data layout section which explains SeekHe…
robUx4 Jun 19, 2022
95a4614
SeekHead contains seeking information of Top-Level elements
robUx4 Jun 19, 2022
20af792
livestreaming: use SeekHead instead of fake MetaSeek element name
robUx4 Jun 19, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
6 changes: 3 additions & 3 deletions ebml_matroska.xml
View file
Open in desktop
Expand Up @@ -8,19 +8,19 @@
A Matroska file is composed of 1 Segment.</documentation>
</element>
<element name="SeekHead" path="\Segment\SeekHead" id="0x114D9B74" type="master" maxOccurs="2">
<documentation lang="en" purpose="definition">Contains the Segment Position of other Top-Level Elements.</documentation>
<documentation lang="en" purpose="definition">Contains seeking information of Top-Level Elements; see (#data-layout).</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Seek" path="\Segment\SeekHead\Seek" id="0x4DBB" type="master" minOccurs="1">
<documentation lang="en" purpose="definition">Contains a single seek entry to an EBML Element.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SeekID" path="\Segment\SeekHead\Seek\SeekID" id="0x53AB" type="binary" length="&lt;= 4" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The binary ID corresponding to the Element name.</documentation>
<documentation lang="en" purpose="definition">The binary EBML ID of a Top-Level Element.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SeekPosition" path="\Segment\SeekHead\Seek\SeekPosition" id="0x53AC" type="uinteger" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The Segment Position of the Element.</documentation>
<documentation lang="en" purpose="definition">The Segment Position ((#segment-position)) of a Top-Level Element.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Info" path="\Segment\Info" id="0x1549A966" type="master" minOccurs="1" maxOccurs="1" recurring="1">
Expand Down
4 changes: 2 additions & 2 deletions streaming.md
View file
Open in desktop
Expand Up @@ -36,11 +36,11 @@ of the `Segment Element` **MUST** be set to 1. Another option is to concatenate
with known sizes, one after the other. This solution allows a change of codec/resolution
between each segment. For example, this allows for a switch between 4:3 and 16:9 in a television program.

When `Segment Elements` are continuous, certain `Elements`, like `MetaSeek`, `Cues`,
When `Segment Elements` are continuous, certain `Elements`, like `SeekHead`, `Cues`,
`Chapters`, and `Attachments`, **MUST NOT** be used.

It is possible for a `Matroska Player` to detect that a stream is not seekable.
If the stream has neither a `MetaSeek` list or a `Cues` list at the beginning of the stream,
If the stream has neither a `SeekHead` list or a `Cues` list at the beginning of the stream,
it **SHOULD** be considered non-seekable. Even though it is possible to seek blindly forward
in the stream, it is **NOT RECOMMENDED**.

Expand Down