The `Root Element` that contains all other
`Top-Level Elements`; see (#data-layout).
Contains seeking information of `Top-Level
Elements`; see (#data-layout).
Contains a single seek entry to an EBML
Element.
The binary EBML ID of a `Top-Level Element`.
The `Segment Position` ((#segment-position))
of a `Top-Level Element`.
Contains general information about the
`Segment`.
A randomly generated UID that identifies the
`Segment` amongst many others (128 bits). It is equivalent to a Universally Unique
Identifier (UUID) v4 [@!RFC9562] with all bits randomly (or pseudorandomly) chosen. An
actual UUID v4 value, where some bits are not random, **MAY** also be used.
If the `Segment` is a part of a `Linked
Segment`, then this element is **REQUIRED**.
The value of the UID **MUST** contain at least one bit set to 1.
A filename corresponding to this `Segment`.
An ID that identifies the previous `Segment`
of a `Linked Segment`.
If the `Segment` is a part of a `Linked
Segment` that uses
Hard Linking ((#hard-linking)), then either the
`PrevUUID` or the `NextUUID` element is
**REQUIRED**. If a `Segment` contains a `PrevUUID`
but not a `NextUUID`, then it **MAY** be considered as the
last `Segment` of the `Linked Segment`. The `PrevUUID`
**MUST NOT** be equal to the `SegmentUUID`.
A filename corresponding to the file of the
previous `Linked Segment`.
Provision of the previous filename is for
display convenience,
but `PrevUUID` **SHOULD** be considered authoritative for identifying the previous
`Segment` in a `Linked Segment`.
An ID that identifies the next `Segment` of a
`Linked Segment`.
If the `Segment` is a part of a `Linked
Segment` that uses Hard Linking ((#hard-linking)),
then either the `PrevUUID` or the `NextUUID` element is **REQUIRED**. If a `Segment`
contains a `NextUUID` but not a `PrevUUID`, then it **MAY** be considered as the first
`Segment` of the `Linked Segment`. The `NextUUID` **MUST NOT** be equal to the
`SegmentUUID`.
A filename corresponding to the file of the
next `Linked Segment`.
Provision of the next filename is for display
convenience,
but `NextUUID` **SHOULD** be considered authoritative for identifying the Next
`Segment`.
A UID that all `Segments` of a `Linked
Segment` **MUST** share (128 bits). It is equivalent to a UUID v4 [@!RFC9562] with all
bits randomly (or pseudorandomly) chosen. An actual UUID v4 value, where some bits are
not random, **MAY** also be used.
If the `Segment` `Info` contains a
`ChapterTranslate` element, this element is **REQUIRED**.
The mapping between this `Segment` and a
segment value in the given Chapter Codec.
Chapter Codecs may need to address different
segments, but they may not know of the way to identify such segments when stored in
Matroska.
This element and its child elements add a way to map the internal segments known to the
Chapter Codec to the `SegmentUUID`s in Matroska.
This allows remuxing a file with Chapter Codec without changing the content of the codec
data, just the `Segment` mapping.
The binary value used to represent this
`Segment` in the chapter codec data.
The format depends on the `ChapProcessCodecID` used; see (#chapprocesscodecid-element).
Applies to the chapter codec of the given
chapter edition(s); see (#chapprocesscodecid-element).
Specifies a chapter edition UID to which this
`ChapterTranslate` applies.
When no `ChapterTranslateEditionUID` is
specified in the `ChapterTranslate`, the `ChapterTranslate` applies to all chapter
editions found in the `Segment` using the given `ChapterTranslateCodec`.
Base unit for Segment Ticks and Track Ticks,
in nanoseconds. A `TimestampScale` value of 1000000 means scaled timestamps in the
`Segment` are expressed in milliseconds; see (#timestamps) on how to interpret
timestamps.
Duration of the `Segment`, expressed in
`Segment` Ticks, which are based on `TimestampScale`; see (#timestamp-ticks).
The date and time that the `Segment` was
created by the muxing application or library.
General name of the `Segment`.
Muxing application or library (example:
"libmatroska-0.4.3").
Include the full name of the application or
library followed by the version number.
Writing application (example:
"mkvmerge-0.3.3").
Include the full name of the application
followed by the version number.
The `Top-Level Element` containing the
(monolithic) `Block` structure.
Absolute timestamp of the cluster, expressed
in Segment Ticks, which are based on `TimestampScale`; see (#timestamp-ticks).
This element **SHOULD** be the first child
element of the `Cluster` it belongs to
or the second if that `Cluster` contains a `CRC-32` element ((#crc-32)).
The list of tracks that are not used in that
part of the stream.
It is useful when using overlay tracks for seeking or deciding what track to use.
One of the track numbers that is not used from
now on in the stream.
It could change later if not specified as silent in a further `Cluster`.
The `Segment Position` of the `Cluster` in the
`Segment` (0 in live streams).
It might help to resynchronize the offset on damaged streams.
Size of the previous `Cluster`, in octets. Can
be useful for backward playing.
Similar to `Block` (see (#block-structure))
but without all the extra information.
Mostly used to reduce overhead when no extra feature is needed; see
(#simpleblock-structure) on `SimpleBlock` Structure.
Basic container of information containing a
single `Block` and information specific to that `Block`.
`Block` containing the actual data to be
rendered and a timestamp relative to the `Cluster` Timestamp;
see (#block-structure) on `Block` Structure.
A `Block` with no data. It must be stored in
the stream at the place the real `Block` would be in display order.
Contains additional binary data to complete
the `Block` element; see [@?I-D.ietf-cellar-codec, section 4.1.5] for more information.
An EBML parser that has no knowledge of the `Block` structure could still see and
use/skip these data.
Contains the `BlockAdditional` and some
parameters.
Interpreted by the codec as it wishes (using
the `BlockAddID`).
An ID that identifies how to interpret the
`BlockAdditional` data; see [@?I-D.ietf-cellar-codec, section 4.1.5] for
more information. A value of 1 indicates that the `BlockAdditional` data is
defined by the codec. Any other value indicates that the `BlockAdditional` data
should be handled according to the `BlockAddIDType` that is located in the
`TrackEntry`.
Each `BlockAddID` value **MUST** be unique
between all `BlockMore` elements found in a `BlockAdditions` element. To keep
`MaxBlockAdditionID` as low as possible, small values **SHOULD** be used.
The duration of the `Block`, expressed in
Track Ticks; see (#timestamp-ticks).
The `BlockDuration` element can be useful
at the end of a `Track` to define the duration of the last frame (as
there is no subsequent `Block` available) or when there is a break in a
track like for subtitle tracks.
`BlockDuration` **MUST** be set
(minOccurs=1) if the associated `TrackEntry` stores a `DefaultDuration` value.
If a value is not present and no
`DefaultDuration` is defined, the value is assumed to be the difference between the
timestamp of this `Block` and the timestamp of the next `Block` in "display" order (not
coding order).
This frame is referenced and has the specified
cache priority.
In the cache, only a frame of the same or higher priority can replace this frame. A
value of 0 means the frame is not referenced.
A timestamp value, relative to the timestamp
of the `Block` in this `BlockGroup`, expressed in Track Ticks; see (#timestamp-ticks).
This is used to reference other frames necessary to decode this frame.
The relative value **SHOULD** correspond to a valid `Block` that this `Block` depends
on.
Historically, `Matroska Writers` didn't write the actual `Block(s)` that this `Block`
depends on, but they did write *some* `Block(s)` in the past.
The value "0" **MAY** also be used to signify that this `Block` cannot be decoded on its
own, but the necessary reference `Block(s)` is unknown. In this case, other
`ReferenceBlock` elements **MUST NOT** be found in the same `BlockGroup`. If the
`BlockGroup` doesn't have a `ReferenceBlock` element, then the `Block` it contains can
be decoded without using any other `Block` data.
The `Segment Position` of the data that would
otherwise be in position of the virtual block.
The new codec state to use. Data
interpretation is private to the codec.
This information **SHOULD** always be referenced by a seek entry.
Duration of the silent data added to the
`Block`, expressed in
Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks)
(padding at the end of the `Block` for positive values and at the
beginning of the `Block` for negative values). The duration of
`DiscardPadding` is not calculated in the duration of the
`TrackEntry` and **SHOULD** be discarded during
playback.
Contains slices description.
Contains extra time information about the data
contained in the `Block`.
Being able to interpret this element is not required for playback.
The reverse number of the frame in the lace (0
is the last frame, 1 is the next to last, etc.).
Being able to interpret this element is not required for playback.
The number of the frame to generate from this
lace with this delay
(allows for the generation of many frames from the same Block/Frame).
The ID of the `BlockAdditional` element (0 is
the main `Block`).
The delay to apply to the element, expressed
in Track Ticks; see (#timestamp-ticks).
The duration to apply to the element,
expressed in Track Ticks; see (#timestamp-ticks).
Contains information about the last reference
frame. See [@?DivXTrickTrack].
The relative offset, in bytes, from the
previous `BlockGroup` element for this Smooth FF/RW video track to the containing
`BlockGroup`
element. See [@?DivXTrickTrack].
The timestamp of the `BlockGroup` pointed to
by ReferenceOffset, expressed in Track Ticks; see (#timestamp-ticks). See
[@?DivXTrickTrack].
Similar to `SimpleBlock` (see
(#simpleblock-structure)),
but the data inside the `Block` are Transformed (encrypted and/or signed).
A `Top-Level Element` of information with many
tracks described.
Describes a track with all elements.
The track number as used in the `Block`
Header.
A UID that identifies the `Track`.
The `TrackType` defines the type of each frame
found in the `Track`.
The value **SHOULD** be stored on 1 octet.
An image.
Audio samples.
A mix of different other `TrackType`.
The codec needs to define how the `Matroska Player` should interpret such data.
An image to be rendered over the video
track(s).
Subtitle or closed caption data to be
rendered over the video track(s).
Interactive button(s) to be rendered
over the video track(s).
Metadata used to control the player of
the `Matroska Player`.
Timed metadata that can be passed on
to the `Matroska Player`.
Set to 1 if the track is usable. It is
possible to turn a track that is not usable into a usable track using chapter codecs or
control tracks.
Set to 1 if the track (audio, video, or
subtitles) is eligible for automatic selection by the player; see
(#default-track-selection) for more details.
Applies only to subtitles. Set to 1 if the
track is eligible for automatic selection by the player if it matches the user's
language preference,
even if the user's preferences would not normally enable subtitles with the selected
audio track;
this can be used for tracks containing only translations of audio in foreign languages
or on-screen text.
See (#default-track-selection) for more details.
Set to 1 if and only if the track is suitable
for users with hearing impairments.
Set to 1 if and only if the track is suitable
for users with visual impairments.
Set to 1 if and only if the track contains
textual descriptions of video content.
Set to 1 if and only if the track is in the
content's original language.
Set to 1 if and only if the track contains
commentary.
Set to 1 if the track **MAY** contain blocks
that use lacing.
When set to 0, all blocks **MUST** have their lacing flags set to "no lacing"; see
(#block-lacing) on 'Block' Lacing.
The minimum number of frames a player should
be able to cache during playback.
If set to 0, the reference pseudo-cache system is not used.
The maximum cache size necessary to store
referenced frames in and the current frame.
0 means no cache is needed.
Number of nanoseconds per frame, expressed in
Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks)
("frame" in the Matroska sense -- one element put into a (Simple)Block).
The period between two successive fields at
the output of the decoding process, expressed in Matroska Ticks -- i.e., in nanoseconds;
see (#timestamp-ticks).
See (#defaultdecodedfieldduration) for more information.
The scale to apply on this track to work at
normal speed in relation with other tracks
(mostly used to adjust video speed when the audio length differs).
A value to add to the `Block`'s Timestamp,
expressed in Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks).
This can be used to adjust the playback offset of a track.
The maximum value of `BlockAddID`
((#blockaddid-element)).
A value of 0 means there is no `BlockAdditions` ((#blockadditions-element)) for this
track.
Contains elements that extend the track format
by adding content either to each frame,
with `BlockAddID` ((#blockaddid-element)), or to the track as a whole
with `BlockAddIDExtraData`.
If the track format extension needs content
beside frames,
the value refers to the `BlockAddID` ((#blockaddid-element)) value being described.
To keep `MaxBlockAdditionID` as low as
possible, small values **SHOULD** be used.
A human-friendly name describing the type of
`BlockAdditional` data,
as defined by the associated `Block Additional Mapping`.
Stores the registered identifier of the `Block
Additional Mapping`
to define how the `BlockAdditional` data should be handled.
If `BlockAddIDType` is 0, the
`BlockAddIDValue` and corresponding `BlockAddID` values **MUST** be 1.
Extra binary data that the `BlockAddIDType`
can use to interpret the `BlockAdditional` data.
The interpretation of the binary data depends on the `BlockAddIDType` value and the
corresponding `Block Additional Mapping`.
A human-readable track name.
The language of the track,
in the Matroska languages form; see (#language-codes) on language codes.
This element **MUST** be ignored if the `LanguageBCP47` element is used in the same
`TrackEntry`.
The language of the track,
in the form defined in [@!RFC5646]; see (#language-codes) on language codes.
If this element is used, then any `Language` elements used in the same `TrackEntry`
**MUST** be ignored.
An ID corresponding to the codec;
see [@?I-D.ietf-cellar-codec] for more info.
Private data only known to the codec.
A human-readable string specifying the codec.
The UID of an attachment that is used by this
codec.
The value **MUST** match the `FileUID` value
of an attachment found in this `Segment`.
A string describing the encoding setting used.
A URL to find information about the codec
used.
A URL to download information about the codec
used.
Set to 1 if the codec can decode potentially
damaged data.
Specify that this track is an overlay track
for the `Track` specified (in the u-integer).
This means that when this track has a gap on `SilentTracks`, the overlay track should be
used instead. The order of multiple `TrackOverlay` matters; the first one is the one
that should be used.
If the first one is not found, it should be the second, etc.
The built-in delay for the codec, expressed in
Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks).
It represents the number of codec samples that will be discarded by the decoder during
playback.
This timestamp value **MUST** be subtracted from each frame timestamp in order to get
the timestamp that will be actually played.
The value **SHOULD** be small so the muxing of tracks with the same actual timestamp are
in the same `Cluster`.
After a discontinuity, the duration of the
data
that the decoder **MUST** decode before the decoded data is valid, expressed in Matroska
Ticks -- i.e., in nanoseconds; see (#timestamp-ticks).
The mapping between this `TrackEntry` and a
track value in the given Chapter Codec.
Chapter Codecs may need to address content in a
specific track, but they may not know of the way to identify tracks in Matroska.
This element and its child elements add a way to map the internal tracks known to the
Chapter Codec to the track IDs in Matroska.
This allows remuxing a file with Chapter Codec without changing the content of the codec
data, just the track mapping.
The binary value used to represent this
`TrackEntry` in the chapter codec data.
The format depends on the `ChapProcessCodecID` used; see (#chapprocesscodecid-element).
Applies to the chapter codec of the given
chapter edition(s); see (#chapprocesscodecid-element).
Specifies a chapter edition UID to which this
`TrackTranslate` applies.
When no `TrackTranslateEditionUID` is
specified in the `TrackTranslate`, the `TrackTranslate` applies to all chapter editions
found in the `Segment` using the given `TrackTranslateCodec`.
Video settings.
Specifies whether the video frames in this
track are interlaced.
Unknown status.
This value **SHOULD** be avoided.
Interlaced frames.
No interlacing.
Specifies the field ordering of video frames
in this track.
If `FlagInterlaced` is not set to 1, this
element **MUST** be ignored.
Interlaced frames.
This value **SHOULD** be avoided;
setting `FlagInterlaced` to 2 is sufficient.
Top field displayed first. Top field
stored first.
Unknown field order.
This value **SHOULD** be avoided.
Bottom field displayed first. Bottom
field stored first.
Top field displayed first. Fields are
interleaved in storage with the top line of the top field stored first.
Bottom field displayed first. Fields
are interleaved in storage with the top line of the top field stored first.
Stereo-3D video mode. See
(#multi-planar-and-3d-videos) for more details.
Indicates whether the `BlockAdditional`
element with `BlockAddID` of "1"
contains Alpha data as defined by the Codec Mapping for the `CodecID`.
Undefined values (i.e., values other than 0 or 1) **SHOULD NOT** be used, as the
behavior of known implementations is different.
The `BlockAdditional` element with
`BlockAddID` of "1" does not exist or **SHOULD NOT** be considered as containing
such data.
The `BlockAdditional` element with
`BlockAddID` of "1" contains alpha channel data.
Bogus `StereoMode` value used in old versions
of [@?libmatroska].
This element **MUST NOT** be used. It was an
incorrect value used in libmatroska up to 0.9.0.
Width of the encoded video frames in pixels.
Height of the encoded video frames in pixels.
The number of video pixels to remove at the
bottom of the image.
The number of video pixels to remove at the
top of the image.
The number of video pixels to remove on the
left of the image.
The number of video pixels to remove on the
right of the image.
Width of the video frames to display. Applies
to the video frame after cropping (PixelCrop* Elements).
If the DisplayUnit of the same `TrackEntry` is
0, then the default value for `DisplayWidth` is equal to `PixelWidth` - `PixelCropLeft`
- `PixelCropRight`; else, there is no default value.
Height of the video frames to display. Applies
to the video frame after cropping (PixelCrop* Elements).
If the DisplayUnit of the same `TrackEntry` is
0, then the default value for `DisplayHeight` is equal to `PixelHeight` - `PixelCropTop`
- `PixelCropBottom`; else, there is no default value.
How `DisplayWidth` and `DisplayHeight` are
interpreted.
Specifies the possible modifications to the
aspect ratio.
Specifies the uncompressed pixel format used
for the `Track`'s data as a FourCC.
This value is similar in scope to the biCompression value of AVI's `BITMAPINFO`
[@?AVIFormat]. There is neither a definitive list of FourCC values nor an official
registry. Some common values for YUV pixel formats can be found at [@?MSYUV8],
[@?MSYUV16], and [@?FourCC-YUV]. Some common values for uncompressed RGB pixel formats
can be found at [@?MSRGB] and [@?FourCC-RGB].
UncompressedFourCC **MUST** be set
(minOccurs=1) in `TrackEntry` when the `CodecID` element of the `TrackEntry` is set to
"V_UNCOMPRESSED".
Gamma value.
Number of frames per second. This value is
informational only. It is intended for constant frame rate streams and should not be
used for a variable frame rate `TrackEntry`.
Settings describing the color format.
The Matrix Coefficients of the video used to
derive luma and chroma values from red, green, and blue color primaries.
For clarity, the value and meanings for `MatrixCoefficients` are adopted from Table 4 of
[@!ITU-H.273].
Number of decoded bits per channel. A value of
0 indicates that the `BitsPerChannel` is unspecified.
The number of pixels to remove in the Cr and
Cb channels for every pixel not removed horizontally. Example: For video with 4:2:0
chroma subsampling, the `ChromaSubsamplingHorz`
**SHOULD** be set to 1.
The number of pixels to remove in the Cr and
Cb channels for every pixel not removed vertically.
Example: For video with 4:2:0 chroma subsampling, the `ChromaSubsamplingVert`
**SHOULD** be set to 1.
The number of pixels to remove in the Cb
channel for every pixel not removed horizontally.
This is additive with `ChromaSubsamplingHorz`.
Example: For video with 4:2:1 chroma
subsampling, the `ChromaSubsamplingHorz` **SHOULD** be set to 1, and `CbSubsamplingHorz`
**SHOULD** be set to 1.
The number of pixels to remove in the Cb
channel for every pixel not removed vertically.
This is additive with `ChromaSubsamplingVert`.
How chroma is subsampled horizontally.
How chroma is subsampled vertically.
Clipping of the color ranges.
The transfer characteristics of the video. For
clarity,
the value and meanings for `TransferCharacteristics` are adopted from Table 3 of
[@!ITU-H.273].
The color primaries of the video. For clarity,
the value and meanings for `Primaries` are adopted from Table 2 of [@!ITU-H.273].
Maximum brightness of a single pixel (Maximum
Content Light Level)
in candelas per square meter (cd/m^2^).
Maximum brightness of a single full frame
(Maximum Frame-Average Light Level)
in candelas per square meter (cd/m^2^).
SMPTE 2086 mastering data.
Red X chromaticity coordinate, as defined by
[@!CIE-1931].
Red Y chromaticity coordinate, as defined by
[@!CIE-1931].
Green X chromaticity coordinate, as defined by
[@!CIE-1931].
Green Y chromaticity coordinate, as defined by
[@!CIE-1931].
Blue X chromaticity coordinate, as defined by
[@!CIE-1931].
Blue Y chromaticity coordinate, as defined by
[@!CIE-1931].
White X chromaticity coordinate, as defined by
[@!CIE-1931].
White Y chromaticity coordinate, as defined by
[@!CIE-1931].
Maximum luminance. Represented in candelas per
square meter (cd/m^2^).
Minimum luminance. Represented in candelas per
square meter (cd/m^2^).
Describes the video projection details. Used
to render spherical or VR videos or to flip videos horizontally or vertically.
Describes the projection used for this video
track.
Private data that only applies to a specific
projection.
* If `ProjectionType` equals 0 (rectangular),
then this element **MUST NOT** be present.
* If `ProjectionType` equals 1 (equirectangular), then this element **MUST** be present
and contain the same binary data that would be stored inside
an ISOBMFF Equirectangular Projection Box ("equi").
* If `ProjectionType` equals 2 (cubemap), then this element **MUST** be present and
contain the same binary data that would be stored
inside an ISOBMFF Cubemap Projection Box ("cbmp").
* If `ProjectionType` equals 3 (mesh), then this element **MUST** be present and contain
the same binary data that would be stored inside
an ISOBMFF Mesh Projection Box ("mshp").
ISOBMFF box size and FourCC fields are not
included in the binary data,
but the FullBox version and flag fields are. This is to avoid
redundant framing information while preserving versioning and semantics between the two
container formats.
Specifies a yaw rotation to the projection.
Value represents a clockwise rotation, in degrees, around the up vector. This rotation
must be applied
before any `ProjectionPosePitch` or `ProjectionPoseRoll` rotations.
The value of this element **MUST** be in the -180 to 180 degree range, both inclusive.
Setting `ProjectionPoseYaw` to 180 or -180 degrees with `ProjectionPoseRoll` and
`ProjectionPosePitch` set to 0 degrees flips the image horizontally.
Specifies a pitch rotation to the projection.
Value represents a counter-clockwise rotation, in degrees, around the right vector. This
rotation must be applied
after the `ProjectionPoseYaw` rotation and before the `ProjectionPoseRoll` rotation.
The value of this element **MUST** be in the -90 to 90 degree range, both inclusive.
Specifies a roll rotation to the projection.
Value represents a
counter-clockwise rotation, in degrees, around the forward vector. This
rotation must be applied after the `ProjectionPoseYaw` and
`ProjectionPosePitch` rotations. The value of this element
**MUST** be in the -180 to 180 degree range, both inclusive. Setting
`ProjectionPoseRoll` to 180 or -180 degrees and
`ProjectionPoseYaw` to 180 or -180 degrees with
`ProjectionPosePitch` set to 0 degrees flips the image vertically.
Setting `ProjectionPoseRoll` to 180 or -180 degrees with
`ProjectionPoseYaw` and `ProjectionPosePitch` set to 0 degrees
flips the image horizontally and vertically.
Audio settings.
Sampling frequency in Hz.
Real output sampling frequency in Hz that is
used for Spectral Band Replication (SBR) techniques.
The default value for
`OutputSamplingFrequency` of the same `TrackEntry` is equal to the `SamplingFrequency`.
Numbers of channels in the track.
Table of horizontal angles for each successive
channel.
Bits per sample, mostly used for PCM.
Audio emphasis applied on audio samples. The
player **MUST** apply the inverse emphasis to get the proper audio samples.
First order filter with zero point at
50 microseconds and a pole at 15 microseconds. Also found on DVD Audio and MPEG
audio.
Defined in [@!ITU-J.17].
FM Radio in Europe. RC Filter with a
time constant of 50 microseconds.
FM Radio in the USA. RC Filter with a
time constant of 75 microseconds.
Phono filter with time constants of
t1=3180, t2=318 and t3=75 microseconds. [@!NAB1964]
Phono filter with time constants of
t1=3180, t2=450 and t3=50 microseconds.
Phono filter with time constants of
t1=3180, t2=318 and t3=50 microseconds.
Phono filter with time constants of
t1=2500, t2=500 and t3=70 microseconds.
Phono filter with time constants of
t1=1590, t2=318 and t3=100 microseconds.
Phono filter with time constants of
t1=1590, t2=318 and t3=50 microseconds.
Phono filter with time constants of
t1=3180, t2=318 and t3=100 microseconds.
Operation that needs to be applied on tracks
to create this virtual track. For more details, see (#track-operation).
Contains the list of all video plane tracks
that need to be combined to create this 3D track.
Contains a video plane track that needs to be
combined to create this 3D track.
The `TrackUID` number of the track
representing the plane.
The kind of plane this track corresponds to.
Contains the list of all tracks whose `Blocks`
need to be combined to create this virtual track.
The `TrackUID` number of a track whose blocks
are used to create this virtual track.
The `TrackUID` of the Smooth FF/RW video in
the paired EBML structure corresponding to this video track. See [@?DivXTrickTrack].
The `SegmentUUID` of the `Segment` containing
the track identified by TrickTrackUID. See [@?DivXTrickTrack].
Set to 1 if this video track is a Smooth FF/RW
track. If set to 1, `MasterTrackUID` and `MasterTrackSegUID` should be present, and
`BlockGroups` for this track must contain ReferenceFrame structures.
Otherwise, TrickTrackUID and TrickTrackSegUID must be present if this track has a
corresponding Smooth FF/RW track. See [@?DivXTrickTrack].
The `TrackUID` of the video track in the
paired EBML structure that corresponds to this Smooth FF/RW track. See
[@?DivXTrickTrack].
The `SegmentUUID` of the `Segment` containing
the track identified by MasterTrackUID. See [@?DivXTrickTrack].
Settings for several content encoding
mechanisms like compression or encryption.
Settings for one content encoding like
compression or encryption.
Defines the order to apply each
`ContentEncoding` of the `ContentEncodings`.
The decoder/demuxer **MUST** start with the `ContentEncoding` with the highest
`ContentEncodingOrder` and work its way down to the `ContentEncoding` with the lowest
`ContentEncodingOrder`.
This value **MUST** be unique for each `ContentEncoding` found in the `ContentEncodings`
of this `TrackEntry`.
A bit field that describes which elements have
been modified in this way. Values (big-endian) can be OR'ed.
All frame contents, excluding lacing
data.
The track's `CodecPrivate` data.
The next ContentEncoding (next
`ContentEncodingOrder`; the data inside `ContentCompression` and/or
`ContentEncryption`).
This value **SHOULD NOT** be used, as
it's not supported by players.
A value describing the kind of transformation
that is applied.
Settings describing the compression used.
This element **MUST** be present if the value of `ContentEncodingType` is 0 and absent
otherwise.
Each block **MUST** be decompressable, even if no previous block is available in order
to not prevent seeking.
The compression algorithm used.
Compression method "1" (bzlib) and "2"
(lzo1x) lack proper documentation on the format, which limits implementation
possibilities. Due to licensing conflicts on commonly available libraries' compression
methods, "2" (lzo1x) does not offer widespread interoperability. A `Matroska Writer`
**SHOULD NOT** use these compression methods by default. A `Matroska Reader` **MAY**
support methods "1" and "2" and **SHOULD** support other methods.
zlib compression [@!RFC1950].
bzip2 compression [@?BZIP2] **SHOULD
NOT** be used; see usage notes.
Lempel-Ziv-Oberhumer compression
[@?LZO] **SHOULD NOT** be used; see usage notes.
Octets in `ContentCompSettings`
((#contentcompsettings-element)) have been stripped from each frame.
Settings that might be needed by the
decompressor. For Header Stripping (`ContentCompAlgo`=3),
the bytes that were removed from the beginning of each frame of the track.
Settings describing the encryption used.
This element **MUST** be present if the value of `ContentEncodingType` is 1 (encryption)
and **MUST** be ignored otherwise.
A `Matroska Player` **MAY** support encryption.
The encryption algorithm used.
The data are not encrypted.
Data Encryption Standard (DES)
[@?FIPS46-3].
This value **SHOULD** be avoided.
Triple Data Encryption Algorithm
[@?SP800-67].
This value **SHOULD** be avoided.
Twofish Encryption Algorithm
[@?Twofish].
Blowfish Encryption Algorithm
[@?Blowfish].
This value **SHOULD** be avoided.
Advanced Encryption Standard (AES)
[@?FIPS197].
For public key algorithms, the ID of the
public key that the data was encrypted with.
Settings describing the encryption algorithm
used.
ContentEncAESSettings **MUST NOT** be set
(maxOccurs=0) if ContentEncAlgo is not AES (5).
The AES cipher mode used in the encryption.
AESSettingsCipherMode **MUST NOT** be set
(maxOccurs=0) if ContentEncAlgo is not AES (5).
Counter [@?SP800-38A]
Cipher Block Chaining [@?SP800-38A]
A cryptographic signature of the contents.
This is the ID of the private key that the
data was signed with.
The algorithm used for the signature.
The hash algorithm used for the signature.
A `Top-Level Element` to speed seeking access.
All entries are
local to the `Segment`.
This element **SHOULD** be set when the
`Segment` is not transmitted as a live stream; see (#livestreaming).
Contains all information relative to a seek
point in the `Segment`.
Absolute timestamp of the seek point,
expressed in Segment Ticks, which are based on `TimestampScale`; see (#timestamp-ticks).
Contains positions for different tracks
corresponding to the timestamp.
The track for which a position is given.
The `Segment Position` ((#segment-position))
of the `Cluster` containing the associated `Block`.
The relative position inside the `Cluster` of
the referenced `SimpleBlock` or `BlockGroup`
with 0 being the first possible position for an element inside that `Cluster`.
The duration of the block, expressed in
Segment Ticks, which are based on `TimestampScale`; see (#timestamp-ticks).
If missing, the track's `DefaultDuration` does not apply and no duration information is
available in terms of the cues.
Number of the `Block` in the specified
`Cluster`.
The `Segment Position` ((#segment-position))
of the
Codec State corresponding to this `Cues` element. 0 means that the
data is taken from the initial `TrackEntry`.
The `Clusters` containing the referenced
`Blocks`.
Timestamp of the referenced `Block`, expressed
in Segment Ticks which is based on `TimestampScale`; see (#timestamp-ticks).
The `Segment Position` of the `Cluster`
containing the referenced `Block`.
Number of the referenced `Block` of Track X in
the specified `Cluster`.
The `Segment Position` of the Codec State
corresponding to this referenced element.
0 means that the data is taken from the initial `TrackEntry`.
Contains attached files.
An attached file.
A human-friendly name for the attached file.
Filename of the attached file.
Media type of the file following the format
described in [@!RFC6838].
The data of the file.
UID representing the file, as random as
possible.
A binary value that a track/codec can refer to
when the attachment is needed.
The timestamp at which this optimized font
attachment comes into context, expressed in Segment Ticks, which are based on
`TimestampScale`. See [@?DivXWorldFonts].
This element is reserved for future use and
if written **MUST** be the segment start timestamp.
The timestamp at which this optimized font
attachment goes out of context, expressed in Segment Ticks, which are based on
`TimestampScale`. See [@?DivXWorldFonts].
This element is reserved for future use and
if written **MUST** be the segment end timestamp.
A system to define basic menus and partition
data.
For more detailed information, see (#chapters).
Contains all information about a `Segment`
edition.
A UID that identifies the edition. It's useful
for tagging an edition.
Set to 1 if an edition is hidden. Hidden
editions **SHOULD NOT** be available to the user interface
(but still be available to Control Tracks; see (#chapter-flags) on `Chapter` flags).
Set to 1 if the edition **SHOULD** be used as
the default one.
Set to 1 if the chapters can be defined
multiple times and the order to play them is enforced; see (#editionflagordered).
Contains a possible string to use for the
edition display for the given languages.
Contains the string to use as the edition
name.
One language corresponding to the
EditionString,
in the form defined in [@!RFC5646]; see (#language-codes) on language codes.
Contains the atom information to use as the
chapter atom (applies to all tracks).
A UID that identifies the `Chapter`.
A unique string ID that identifies the
`Chapter`.
For example, it is used as the storage for cue identifier values [@?WebVTT].
Timestamp of the start of `Chapter`, expressed
in Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks).
Timestamp of the end of `Chapter` (timestamp
excluded), expressed in Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks).
The value **MUST** be greater than or equal to the `ChapterTimeStart` of the same
`ChapterAtom`.
With the `ChapterTimeEnd` timestamp value
being excluded, it **MUST** take into account the duration of
the last frame it includes, especially for the `ChapterAtom` using the last frames of
the `Segment`.
ChapterTimeEnd **MUST** be set (minOccurs=1)
if the `Edition` is an ordered edition; see (#editionflagordered). If it's a `Parent
Chapter`, see (#nested-chapters).
Set to 1 if a chapter is hidden.
Hidden chapters **SHOULD NOT** be available to the user interface
(but still be available to Control Tracks; see (#chapterflaghidden) on `Chapter` flags).
Set to 1 if the chapter is enabled. It can be
enabled/disabled by a Control Track.
When disabled, the movie **SHOULD** skip all the content between the TimeStart and
TimeEnd of this chapter; see (#chapter-flags) on `Chapter` flags.
The `SegmentUUID` of another `Segment` to play
during this chapter.
The value **MUST NOT** be the `SegmentUUID`
value of the `Segment` it belongs to.
`ChapterSegmentUUID` **MUST** be set
(minOccurs=1) if `ChapterSegmentEditionUID` is used; see (#medium-linking) on
Medium-Linking `Segments`.
Indicates what type of content the
`ChapterAtom` contains and might be skipped.
It can be used to automatically skip content based on the type.
If a `ChapterAtom` is inside a `ChapterAtom` that has a `ChapterSkipType` set, it
**MUST NOT** have a `ChapterSkipType` or have a `ChapterSkipType` with the same value as
it's parent `ChapterAtom`.
If the `ChapterAtom` doesn't contain a `ChapterTimeEnd`, the value of the
`ChapterSkipType` is only valid until the next `ChapterAtom` with a `ChapterSkipType`
value or the end of the file.
Content which should not be skipped.
Credits usually found at the beginning
of the content.
Credits usually found at the end of
the content.
Recap of previous episodes of the
content, usually found around the beginning.
Preview of the next episode of the
content, usually found around the end. It may contain spoilers the user wants to
avoid.
Preview of the current episode of the
content, usually found around the beginning. It may contain spoilers the user
want to avoid.
Advertisement within the content.
A pause of content between main parts
of the content.
The `EditionUID` to play from the `Segment`
linked in `ChapterSegmentUUID`.
If `ChapterSegmentEditionUID` is undeclared, then no `Edition` of the `Linked Segment`
is used; see (#medium-linking) on Medium-Linking `Segments`.
Specifies the physical equivalent of this
`ChapterAtom`, e.g., "DVD" (60) or "SIDE" (50);
see (#physical-types) for a complete list of values.
List of tracks on which the chapter applies.
If this element is not present, all tracks apply.
UID of the `Track` to apply this chapter to.
In the absence of a control track, choosing this chapter will select the listed `Tracks`
and deselect unlisted tracks.
Absence of this element indicates that the `Chapter` **SHOULD** be applied to any
currently used `Tracks`.
Contains all possible strings to use for the
chapter display.
Contains the string to use as the chapter
atom.
A language corresponding to the string,
in the Matroska languages form; see (#language-codes) on language codes.
This element **MUST** be ignored if a `ChapLanguageBCP47` element is used within the
same `ChapterDisplay` element.
A language corresponding to the `ChapString`,
in the form defined in [@!RFC5646]; see (#language-codes) on language codes.
If a `ChapLanguageBCP47` element is used, then any `ChapLanguage` and `ChapCountry`
elements used in the same `ChapterDisplay` **MUST** be ignored.
A country corresponding to the string,
in the Matroska countries form; see (#country-codes) on country codes.
This element **MUST** be ignored if a `ChapLanguageBCP47` element is used within the
same `ChapterDisplay` element.
Contains all the commands associated with the
Atom.
Contains the type of the codec used for
processing.
Chapter commands using the Matroska
Script codec.
Chapter commands using the DVD-like
codec.
Optional data attached to the
`ChapProcessCodecID` information.
For `ChapProcessCodecID` = 1, it is the "DVD level" equivalent; see (#menu-features) on
DVD menus.
Contains all the commands associated with the
Atom.
Defines when the process command **SHOULD** be
handled.
Contains the command information.
The data **SHOULD** be interpreted depending on the `ChapProcessCodecID` value. For
`ChapProcessCodecID` = 1,
the data correspond to the binary DVD cell pre/post commands; see (#menu-features) on
DVD menus.
Element containing metadata describing
`Tracks`, `Editions`, `Chapters`, `Attachments`, or the `Segment` as a whole.
A list of valid tags can be found in [@?I-D.ietf-cellar-tags].
A single metadata descriptor.
Specifies which other elements the metadata
represented by the tag value applies to.
If empty or omitted, then the tag value describes everything in the `Segment`.
A number to indicate the logical level of the
target.
The `TargetTypeValue` values are meant to be
compared.
Higher values **MUST** correspond to a logical level that contains the lower logical
level `TargetTypeValue` values.
The lowest hierarchy found in music or
movies.
Corresponds to parts of a track for
audio, such as a movement or scene in a movie.
The common parts of an album or movie.
When an album or episode has different
logical parts.
The most common grouping level of
music and video (e.g., an episode for TV series).
A list of lower levels grouped
together.
The highest hierarchical level that
tags can describe.
An informational string that can be used to
display the logical level of the target, such as "ALBUM", "TRACK", "MOVIE", "CHAPTER",
etc.
A UID that identifies the `Track(s)` that the
tags belong to.
If the value is 0 at this level, the tags
apply to all tracks in the `Segment`.
If set to any other value, it **MUST** match the `TrackUID` value of a track found in
this `Segment`.
A UID that identifies the `EditionEntry(s)`
that the tags belong to.
If the value is 0 at this level, the tags
apply to all editions in the `Segment`.
If set to any other value, it **MUST** match the `EditionUID` value of an edition found
in this `Segment`.
A UID that identifies the `Chapter(s)` that
the tags belong to.
If the value is 0 at this level, the tags
apply to all chapters in the `Segment`.
If set to any other value, it **MUST** match the `ChapterUID` value of a chapter found
in this `Segment`.
A UID that identifies the Attachment(s) that
the tags belong to.
If the value is 0 at this level, the tags
apply to all the attachments in
the `Segment`. If set to any other value, it **MUST** match
the `FileUID` value of an attachment found in this `Segment`.
Contains general information about the target.
The name of the tag value that is going to be
stored.
Specifies the language of the specified tag in
the Matroska languages form; see (#language-codes) on language codes.
This element **MUST** be ignored if the `TagLanguageBCP47` element is used within the
same `SimpleTag` element.
The language used in the `TagString`,
in the form defined in [@!RFC5646]; see (#language-codes) on language codes.
If this element is used, then any `TagLanguage` elements used in the same `SimpleTag`
**MUST** be ignored.
A boolean value to indicate if this is the
default/original language to use for the given tag.
A variant of the `TagDefault` element with a
bogus element ID; see (#tagdefault-element).
The tag value.
The tag value if it is binary. Note that this
cannot be used in the same `SimpleTag` as `TagString`.