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.
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`.