The Matroska Media Container logo

Menu

Legend

  • Element Name — The full name of the described element
  • L — The level within an EBML tree that the element may occur at. + is for a recursive level (can be its own child). g: global element (can be found at any level)
  • EBML ID — The Element ID displayed as octets
  • Ma — "mand." means that the element is mandatory and must be present if the parent element is present unless the element has a default value
  • Mu — "mult." means that the element may occur multiple times as a child of the same parent
  • Rng — Valid range of values to store in the element
  • Default — The default value of the element to use if the parent element is present but this element is not
  • T — The element's type, the form of data the element contains (m: master; b: binary; f: floating point number; u: unsigned integer; i: signed integer; 8: Unicode string; s: ASCII string; d: date & time)
  • 1, 2, 3, 4 — the Matroska specification versions this element is contained in (v4 is still work in progress; additions and changes are possible)
  • W — All elements available for use in WebM.
  • Description — A short description of the element's purpose.

Matroska v4 element specification

Note: this is Matroska version 4 generated from ebml_matroska.xml git revision f93ab02 @ 2026-06-21 10:17:16 +0200

Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
EBMLMaxIDLength 1 0x42F2 mand. - 4 4 u * * * * *
EBMLMaxSizeLength 1 0x42F3 mand. - 1-8 8 u * * * * *
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Segment
Segment 0 0x18538067 mand. - - - m * * * * * The `Root Element` that contains all other `Top-Level Elements`; see data-layout.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Meta Seek Information
SeekHead 1 0x114D9B74 - mult. - - m * * * * * Contains seeking information of `Top-Level Elements`; see data-layout.
Seek 2 0x4DBB mand. mult. - - m * * * * * Contains a single seek entry to an EBML Element.
SeekID 3 0x53AB mand. - - - b * * * * * The binary EBML ID of a `Top-Level Element`.
SeekPosition 3 0x53AC mand. - - - u * * * * * The `Segment Position` (segment-position) of a `Top-Level Element`.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Segment Information
Info 1 0x1549A966 mand. - - - m * * * * * Contains general information about the `Segment`.
SegmentUUID 2 0x73A4 - - - - b * * * * * 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.
SegmentFilename 2 0x7384 - - - - 8 * * * * * A filename corresponding to this `Segment`.
PrevUUID 2 0x3CB923 - - - - b * * * * * 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`.
PrevFilename 2 0x3C83AB - - - - 8 * * * * * 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`.
NextUUID 2 0x3EB923 - - - - b * * * * * 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`.
NextFilename 2 0x3E83BB - - - - 8 * * * * * 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`.
SegmentFamily 2 0x4444 - mult. - - b * * * * * 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**.
ChapterTranslate 2 0x6924 - mult. - - m * * * * * 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.
ChapterTranslateID 3 0x69A5 mand. - - - b * * * * * The binary value used to represent this `Segment` in the chapter codec data. The format depends on the `ChapProcessCodecID` used; see ChapProcessCodecID.
ChapterTranslateCodec 3 0x69BF mand. - - - u * * * * * Applies to the chapter codec of the given chapter edition(s); see ChapProcessCodecID.
ChapterTranslateEditionUID 3 0x69FC - mult. - - u * * * * * 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`.
TimestampScale 2 0x2AD7B1 mand. - not 0 1000000 u * * * * * 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 2 0x4489 - - > 0.0 - f * * * * * Duration of the `Segment`, expressed in `Segment` Ticks, which are based on `TimestampScale`; see timestamp-ticks.
DateUTC 2 0x4461 - - - - d * * * * * The date and time that the `Segment` was created by the muxing application or library.
Title 2 0x7BA9 - - - - 8 * * * * * General name of the `Segment`.
MuxingApp 2 0x4D80 mand. - - - 8 * * * * * Muxing application or library (example: "libmatroska-0.4.3"). Include the full name of the application or library followed by the version number.
WritingApp 2 0x5741 mand. - - - 8 * * * * * Writing application (example: "mkvmerge-0.3.3"). Include the full name of the application followed by the version number.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Cluster
Cluster 1 0x1F43B675 - mult. - - m * * * * * The `Top-Level Element` containing the (monolithic) `Block` structure.
Timestamp 2 0xE7 mand. - - - u * * * * * 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).
SilentTracks 2 0x5854 - - - - m 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.
SilentTrackNumber 3 0x58D7 - mult. - - u 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`.
Position 2 0xA7 - - - - u * * * * * The `Segment Position` of the `Cluster` in the `Segment` (0 in live streams). It might help to resynchronize the offset on damaged streams.
PrevSize 2 0xAB - - - - u * * * * * Size of the previous `Cluster`, in octets. Can be useful for backward playing.
SimpleBlock 2 0xA3 - mult. - - b * * * * Similar to `Block` (see basics) but without all the extra information. Mostly used to reduce overhead when no extra feature is needed; see basics on `SimpleBlock` Structure.
BlockGroup 2 0xA0 - mult. - - m * * * * * Basic container of information containing a single `Block` and information specific to that `Block`.
Block 3 0xA1 mand. - - - b * * * * * `Block` containing the actual data to be rendered and a timestamp relative to the `Cluster` Timestamp; see basics on `Block` Structure.
BlockVirtual 3 0xA2 - - - - b A `Block` with no data. It must be stored in the stream at the place the real `Block` would be in display order.
BlockAdditions 3 0x75A1 - - - - m * * * * * 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.
BlockMore 4 0xA6 mand. mult. - - m * * * * * Contains the `BlockAdditional` and some parameters.
BlockAdditional 5 0xA5 mand. - - - b * * * * * Interpreted by the codec as it wishes (using the `BlockAddID`).
BlockAddID 5 0xEE mand. - not 0 1 u * * * * * 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.
BlockDuration 3 0x9B - - - [desc.] u * * * * * 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. 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). BlockDuration **MUST** be set if the associated TrackEntry stores a DefaultDuration value.
ReferencePriority 3 0xFA mand. - - 0 u * * * * * 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.
ReferenceBlock 3 0xFB - mult. - - i * * * * * 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.
ReferenceVirtual 3 0xFD - - - - i The `Segment Position` of the data that would otherwise be in position of the virtual block.
CodecState 3 0xA4 - - - - b * * * * The new codec state to use. Data interpretation is private to the codec. This information **SHOULD** always be referenced by a seek entry.
DiscardPadding 3 0x75A2 - - - - i * * 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.
Slices 3 0x8E - - - - m Contains slices description.
TimeSlice 4 0xE8 - mult. - - m Contains extra time information about the data contained in the `Block`. Being able to interpret this element is not required for playback.
LaceNumber 5 0xCC - - - - u 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.
FrameNumber 5 0xCD - - - 0 u 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).
BlockAdditionID 5 0xCB - - - 0 u The ID of the `BlockAdditional` element (0 is the main `Block`).
Delay 5 0xCE - - - 0 u The delay to apply to the element, expressed in Track Ticks; see timestamp-ticks.
SliceDuration 5 0xCF - - - 0 u The duration to apply to the element, expressed in Track Ticks; see timestamp-ticks.
ReferenceFrame 3 0xC8 - - - - m Contains information about the last reference frame. See [@?DivXTrickTrack].
ReferenceOffset 4 0xC9 mand. - - - u The relative offset, in bytes, from the previous `BlockGroup` element for this Smooth FF/RW video track to the containing `BlockGroup` element. See [@?DivXTrickTrack].
ReferenceTimestamp 4 0xCA mand. - - - u The timestamp of the `BlockGroup` pointed to by ReferenceOffset, expressed in Track Ticks; see timestamp-ticks. See [@?DivXTrickTrack].
EncryptedBlock 2 0xAF - mult. - - b Similar to `SimpleBlock` (see basics), but the data inside the `Block` are Transformed (encrypted and/or signed).
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Track
Tracks 1 0x1654AE6B - - - - m * * * * * A `Top-Level Element` of information with many tracks described.
TrackEntry 2 0xAE mand. mult. - - m * * * * * Describes a track with all elements.
TrackNumber 3 0xD7 mand. - not 0 - u * * * * * The track number as used in the `Block` Header.
TrackUID 3 0x73C5 mand. - not 0 - u * * * * * A UID that identifies the `Track`.
TrackType 3 0x83 mand. - not 0 - u * * * * * The `TrackType` defines the type of each frame found in the `Track`. The value **SHOULD** be stored on 1 octet.
1 - video,
2 - audio,
3 - complex,
16 - logo,
17 - subtitle,
18 - buttons,
32 - control,
33 - metadata
FlagEnabled 3 0xB9 mand. - 0-1 1 u * * * * 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.
FlagDefault 3 0x88 mand. - 0-1 1 u * * * * * 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.
FlagForced 3 0x55AA mand. - 0-1 0 u * * * * * 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.
FlagHearingImpaired 3 0x55AB - - 0-1 - u * * Set to 1 if and only if the track is suitable for users with hearing impairments.
FlagVisualImpaired 3 0x55AC - - 0-1 - u * * Set to 1 if and only if the track is suitable for users with visual impairments.
FlagTextDescriptions 3 0x55AD - - 0-1 - u * * Set to 1 if and only if the track contains textual descriptions of video content.
FlagOriginal 3 0x55AE - - 0-1 - u * * Set to 1 if and only if the track is in the content's original language.
FlagCommentary 3 0x55AF - - 0-1 - u * * Set to 1 if and only if the track contains commentary.
FlagLacing 3 0x9C mand. - 0-1 1 u * * * * * 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.
MinCache 3 0x6DE7 mand. - - 0 u 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.
MaxCache 3 0x6DF8 - - - - u The maximum cache size necessary to store referenced frames in and the current frame. 0 means no cache is needed.
DefaultDuration 3 0x23E383 - - not 0 - u * * * * * 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).
DefaultDecodedFieldDuration 3 0x234E7A - - not 0 - u * * 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 notes for more information.
TrackTimestampScale 3 0x23314F mand. - > 0.0 1.0 f * * * * 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).
TrackOffset 3 0x537F - - - 0 i 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.
MaxBlockAdditionID 3 0x55EE mand. - - 0 u * * * * * The maximum value of `BlockAddID` (BlockAddID). A value of 0 means there is no `BlockAdditions` (BlockAdditions) for this track.
BlockAdditionMapping 3 0x41E4 - mult. - - m * * Contains elements that extend the track format by adding content either to each frame, with `BlockAddID` (BlockAddID), or to the track as a whole with `BlockAddIDExtraData`.
BlockAddIDValue 4 0x41F0 - - >=2 - u * * If the track format extension needs content beside frames, the value refers to the `BlockAddID` (BlockAddID) value being described. To keep `MaxBlockAdditionID` as low as possible, small values **SHOULD** be used.
BlockAddIDName 4 0x41A4 - - - - s * * A human-friendly name describing the type of `BlockAdditional` data, as defined by the associated `Block Additional Mapping`.
BlockAddIDType 4 0x41E7 mand. - - 0 u * * 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.
BlockAddIDExtraData 4 0x41ED - - - - b * * 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`.
Name 3 0x536E - - - - 8 * * * * * A human-readable track name.
Language 3 0x22B59C mand. - - eng s * * * * * The language of the track, in the Matroska languages form; see basics on language codes. This element **MUST** be ignored if the `LanguageBCP47` element is used in the same `TrackEntry`.
LanguageBCP47 3 0x22B59D - - - - s * * The language of the track, in the form defined in [@!RFC5646]; see basics on language codes. If this element is used, then any `Language` elements used in the same `TrackEntry` **MUST** be ignored.
CodecID 3 0x86 mand. - - - s * * * * * An ID corresponding to the codec; see Matroska codec RFC for more info.
CodecPrivate 3 0x63A2 - - - - b * * * * * Private data only known to the codec.
CodecName 3 0x258688 - - - - 8 * * * * * A human-readable string specifying the codec.
CodecSettings 3 0x3A9697 - - - - 8 A string describing the encoding setting used.
CodecInfoURL 3 0x3B4040 - mult. - - s A URL to find information about the codec used.
CodecDownloadURL 3 0x26B240 - mult. - - s A URL to download information about the codec used.
CodecDecodeAll 3 0xAA mand. - 0-1 1 u Set to 1 if the codec can decode potentially damaged data.
TrackOverlay 3 0x6FAB - mult. - - u 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.
CodecDelay 3 0x56AA mand. - - 0 u * * 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`.
SeekPreRoll 3 0x56BB mand. - - 0 u * * 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.
TrackTranslate 3 0x6624 - mult. - - m * * * * * 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.
TrackTranslateTrackID 4 0x66A5 mand. - - - b * * * * * The binary value used to represent this `TrackEntry` in the chapter codec data. The format depends on the `ChapProcessCodecID` used; see ChapProcessCodecID.
TrackTranslateCodec 4 0x66BF mand. - - - u * * * * * Applies to the chapter codec of the given chapter edition(s); see ChapProcessCodecID.
TrackTranslateEditionUID 4 0x66FC - mult. - - u * * * * * 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 3 0xE0 - - - - m * * * * * Video settings.
FlagInterlaced 4 0x9A mand. - - 0 u * * * * Specifies whether the video frames in this track are interlaced.
0 - undetermined,
1 - interlaced,
2 - progressive
FieldOrder 4 0x9D mand. - - 2 u * * Specifies the field ordering of video frames in this track. If `FlagInterlaced` is not set to 1, this element **MUST** be ignored.
0 - progressive,
1 - tff,
2 - undetermined,
6 - bff,
9 - tff (interleaved),
14 - bff (interleaved)
StereoMode 4 0x53B8 mand. - - 0 u * * * Stereo-3D video mode. See notes for more details.
0 - mono,
1 - side by side (left eye first),
2 - top - bottom (right eye is first),
3 - top - bottom (left eye is first),
4 - checkboard (right eye is first),
5 - checkboard (left eye is first),
6 - row interleaved (right eye is first),
7 - row interleaved (left eye is first),
8 - column interleaved (right eye is first),
9 - column interleaved (left eye is first),
10 - anaglyph (cyan/red),
11 - side by side (right eye first),
12 - anaglyph (green/magenta),
13 - both eyes laced in one Block (left eye is first),
14 - both eyes laced in one Block (right eye is first)
AlphaMode 4 0x53C0 mand. - - 0 u * * * 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.
0 - none,
1 - present
OldStereoMode 4 0x53B9 - - - - u * * * 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.
0 - mono,
1 - right eye,
2 - left eye,
3 - both eyes
PixelWidth 4 0xB0 mand. - not 0 - u * * * * * Width of the encoded video frames in pixels.
PixelHeight 4 0xBA mand. - not 0 - u * * * * * Height of the encoded video frames in pixels.
PixelCropBottom 4 0x54AA mand. - - 0 u * * * * * The number of video pixels to remove at the bottom of the image.
PixelCropTop 4 0x54BB mand. - - 0 u * * * * * The number of video pixels to remove at the top of the image.
PixelCropLeft 4 0x54CC mand. - - 0 u * * * * * The number of video pixels to remove on the left of the image.
PixelCropRight 4 0x54DD mand. - - 0 u * * * * * The number of video pixels to remove on the right of the image.
DisplayWidth 4 0x54B0 - - not 0 [desc.] u * * * * * 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.
DisplayHeight 4 0x54BA - - not 0 [desc.] u * * * * * 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.
DisplayUnit 4 0x54B2 mand. - - 0 u * * * * * How `DisplayWidth` and `DisplayHeight` are interpreted.
0 - pixels,
1 - centimeters,
2 - inches,
3 - display aspect ratio,
4 - unknown
AspectRatioType 4 0x54B3 - - - 0 u Specifies the possible modifications to the aspect ratio.
0 - free resizing,
1 - keep aspect ratio,
2 - fixed
UncompressedFourCC 4 0x2EB524 - - - - b * * * * * 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 in TrackEntry when the CodecID element of the TrackEntry is set to "V_UNCOMPRESSED".
GammaValue 4 0x2FB523 - - > 0.0 - f Gamma value.
FrameRate 4 0x2383E3 - - > 0.0 - f 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`.
Colour 4 0x55B0 - - - - m * * Settings describing the color format.
MatrixCoefficients 5 0x55B1 mand. - - 2 u * * 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].
0 - Identity,
1 - ITU-R BT.709,
2 - unspecified,
3 - reserved,
4 - US FCC 73.682,
5 - ITU-R BT.470BG,
6 - SMPTE 170M,
7 - SMPTE 240M,
8 - YCoCg,
9 - BT2020 Non-constant Luminance,
10 - BT2020 Constant Luminance,
11 - SMPTE ST 2085,
12 - Chroma-derived Non-constant Luminance,
13 - Chroma-derived Constant Luminance,
14 - ITU-R BT.2100-0
BitsPerChannel 5 0x55B2 mand. - - 0 u * * Number of decoded bits per channel. A value of 0 indicates that the `BitsPerChannel` is unspecified.
ChromaSubsamplingHorz 5 0x55B3 - - - - u * * 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.
ChromaSubsamplingVert 5 0x55B4 - - - - u * * 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.
CbSubsamplingHorz 5 0x55B5 - - - - u * * 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.
CbSubsamplingVert 5 0x55B6 - - - - u * * The number of pixels to remove in the Cb channel for every pixel not removed vertically. This is additive with `ChromaSubsamplingVert`.
ChromaSitingHorz 5 0x55B7 mand. - - 0 u * * How chroma is subsampled horizontally.
0 - unspecified,
1 - left collocated,
2 - half
ChromaSitingVert 5 0x55B8 mand. - - 0 u * * How chroma is subsampled vertically.
0 - unspecified,
1 - top collocated,
2 - half
Range 5 0x55B9 mand. - - 0 u * * Clipping of the color ranges.
0 - unspecified,
1 - broadcast range,
2 - full range (no clipping),
3 - defined by MatrixCoefficients / TransferCharacteristics
TransferCharacteristics 5 0x55BA mand. - - 2 u * * The transfer characteristics of the video. For clarity, the value and meanings for `TransferCharacteristics` are adopted from Table 3 of [@!ITU-H.273].
0 - reserved,
1 - ITU-R BT.709,
2 - unspecified,
3 - reserved2,
4 - Gamma 2.2 curve - BT.470M,
5 - Gamma 2.8 curve - BT.470BG,
6 - SMPTE 170M,
7 - SMPTE 240M,
8 - Linear,
9 - Log,
10 - Log Sqrt,
11 - IEC 61966-2-4,
12 - ITU-R BT.1361 Extended Colour Gamut,
13 - IEC 61966-2-1,
14 - ITU-R BT.2020 10 bit,
15 - ITU-R BT.2020 12 bit,
16 - ITU-R BT.2100 Perceptual Quantization,
17 - SMPTE ST 428-1,
18 - ARIB STD-B67 (HLG)
Primaries 5 0x55BB mand. - - 2 u * * The color primaries of the video. For clarity, the value and meanings for `Primaries` are adopted from Table 2 of [@!ITU-H.273].
0 - reserved,
1 - ITU-R BT.709,
2 - unspecified,
3 - reserved2,
4 - ITU-R BT.470M,
5 - ITU-R BT.470BG - BT.601 625,
6 - ITU-R BT.601 525 - SMPTE 170M,
7 - SMPTE 240M,
8 - FILM,
9 - ITU-R BT.2020,
10 - SMPTE ST 428-1,
11 - SMPTE RP 432-2,
12 - SMPTE EG 432-2,
22 - EBU Tech. 3213-E - JEDEC P22 phosphors
MaxCLL 5 0x55BC - - - - u * * Maximum brightness of a single pixel (Maximum Content Light Level) in candelas per square meter (cd/m^2^).
MaxFALL 5 0x55BD - - - - u * * Maximum brightness of a single full frame (Maximum Frame-Average Light Level) in candelas per square meter (cd/m^2^).
MasteringMetadata 5 0x55D0 - - - - m * * SMPTE 2086 mastering data.
PrimaryRChromaticityX 6 0x55D1 - - 0.0-0x1p+0 - f * * Red X chromaticity coordinate, as defined by [@!CIE-1931].
PrimaryRChromaticityY 6 0x55D2 - - 0.0-0x1p+0 - f * * Red Y chromaticity coordinate, as defined by [@!CIE-1931].
PrimaryGChromaticityX 6 0x55D3 - - 0.0-0x1p+0 - f * * Green X chromaticity coordinate, as defined by [@!CIE-1931].
PrimaryGChromaticityY 6 0x55D4 - - 0.0-0x1p+0 - f * * Green Y chromaticity coordinate, as defined by [@!CIE-1931].
PrimaryBChromaticityX 6 0x55D5 - - 0.0-0x1p+0 - f * * Blue X chromaticity coordinate, as defined by [@!CIE-1931].
PrimaryBChromaticityY 6 0x55D6 - - 0.0-0x1p+0 - f * * Blue Y chromaticity coordinate, as defined by [@!CIE-1931].
WhitePointChromaticityX 6 0x55D7 - - 0.0-0x1p+0 - f * * White X chromaticity coordinate, as defined by [@!CIE-1931].
WhitePointChromaticityY 6 0x55D8 - - 0.0-0x1p+0 - f * * White Y chromaticity coordinate, as defined by [@!CIE-1931].
LuminanceMax 6 0x55D9 - - >= 0.0 - f * * Maximum luminance. Represented in candelas per square meter (cd/m^2^).
LuminanceMin 6 0x55DA - - >= 0.0 - f * * Minimum luminance. Represented in candelas per square meter (cd/m^2^).
Projection 4 0x7670 - - - - m * * Describes the video projection details. Used to render spherical or VR videos or to flip videos horizontally or vertically.
ProjectionType 5 0x7671 mand. - - 0 u * * Describes the projection used for this video track.
0 - rectangular,
1 - equirectangular,
2 - cubemap,
3 - mesh
ProjectionPrivate 5 0x7672 - - - - b * * 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.
ProjectionPoseYaw 5 0x7673 mand. - >= -0xB4p+0, <= 0xB4p+0 0.0 f * * 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.
ProjectionPosePitch 5 0x7674 mand. - >= -0x5Ap+0, <= 0x5Ap+0 0.0 f * * 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.
ProjectionPoseRoll 5 0x7675 mand. - >= -0xB4p+0, <= 0xB4p+0 0.0 f * * 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 3 0xE1 - - - - m * * * * * Audio settings.
SamplingFrequency 4 0xB5 mand. - > 0.0 8000.0 f * * * * * Sampling frequency in Hz.
OutputSamplingFrequency 4 0x78B5 - - > 0.0 [desc.] f * * * * * 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.
Channels 4 0x9F mand. - not 0 1 u * * * * * Numbers of channels in the track.
ChannelPositions 4 0x7D7B - - - - b Table of horizontal angles for each successive channel.
BitDepth 4 0x6264 - - not 0 - u * * * * * Bits per sample, mostly used for PCM.
Emphasis 4 0x52F1 mand. - - 0 u * Audio emphasis applied on audio samples. The player **MUST** apply the inverse emphasis to get the proper audio samples.
0 - No emphasis,
1 - CD audio,
2 - reserved,
3 - CCIT J.17,
4 - FM 50,
5 - FM 75,
10 - Phono RIAA,
11 - Phono IEC N78,
12 - Phono TELDEC,
13 - Phono EMI,
14 - Phono Columbia LP,
15 - Phono LONDON,
16 - Phono NARTB
TrackOperation 3 0xE2 - - - - m * * * Operation that needs to be applied on tracks to create this virtual track. For more details, see notes.
TrackCombinePlanes 4 0xE3 - - - - m * * * Contains the list of all video plane tracks that need to be combined to create this 3D track.
TrackPlane 5 0xE4 mand. mult. - - m * * * Contains a video plane track that needs to be combined to create this 3D track.
TrackPlaneUID 6 0xE5 mand. - not 0 - u * * * The `TrackUID` number of the track representing the plane.
TrackPlaneType 6 0xE6 mand. - - - u * * * The kind of plane this track corresponds to.
0 - left eye,
1 - right eye,
2 - background
TrackJoinBlocks 4 0xE9 - - - - m * * * Contains the list of all tracks whose `Blocks` need to be combined to create this virtual track.
TrackJoinUID 5 0xED mand. mult. not 0 - u * * * The `TrackUID` number of a track whose blocks are used to create this virtual track.
TrickTrackUID 3 0xC0 - - - - u The `TrackUID` of the Smooth FF/RW video in the paired EBML structure corresponding to this video track. See [@?DivXTrickTrack].
TrickTrackSegmentUID 3 0xC1 - - - - b The `SegmentUUID` of the `Segment` containing the track identified by TrickTrackUID. See [@?DivXTrickTrack].
TrickTrackFlag 3 0xC6 - - - 0 u 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].
TrickMasterTrackUID 3 0xC7 - - - - u The `TrackUID` of the video track in the paired EBML structure that corresponds to this Smooth FF/RW track. See [@?DivXTrickTrack].
TrickMasterTrackSegmentUID 3 0xC4 - - - - b The `SegmentUUID` of the `Segment` containing the track identified by MasterTrackUID. See [@?DivXTrickTrack].
ContentEncodings 3 0x6D80 - - - - m * * * * * Settings for several content encoding mechanisms like compression or encryption.
ContentEncoding 4 0x6240 mand. mult. - - m * * * * * Settings for one content encoding like compression or encryption.
ContentEncodingOrder 5 0x5031 mand. - - 0 u * * * * * 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`.
ContentEncodingScope 5 0x5032 mand. - not 0 1 u * * * * * A bit field that describes which elements have been modified in this way. Values (big-endian) can be OR'ed.
0x1 - Block,
0x2 - Private,
0x4 - Next
ContentEncodingType 5 0x5033 mand. - - 0 u * * * * * A value describing the kind of transformation that is applied.
0 - Compression,
1 - Encryption
ContentCompression 5 0x5034 - - - - m * * * * * 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.
ContentCompAlgo 6 0x4254 mand. - - 0 u * * * * * 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.
0 - zlib,
1 - bzlib,
2 - lzo1x,
3 - Header Stripping
ContentCompSettings 6 0x4255 - - - - b * * * * * 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.
ContentEncryption 5 0x5035 - - - - m * * * * * 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.
ContentEncAlgo 6 0x47E1 mand. - - 0 u * * * * * The encryption algorithm used.
0 - Not encrypted,
1 - DES,
2 - 3DES,
3 - Twofish,
4 - Blowfish,
5 - AES
ContentEncKeyID 6 0x47E2 - - - - b * * * * * For public key algorithms, the ID of the public key that the data was encrypted with.
ContentEncAESSettings 6 0x47E7 - - - - m * * Settings describing the encryption algorithm used.
AESSettingsCipherMode 7 0x47E8 mand. - not 0 - u * * The AES cipher mode used in the encryption.
1 - AES-CTR,
2 - AES-CBC
ContentSignature 6 0x47E3 - - - - b A cryptographic signature of the contents.
ContentSigKeyID 6 0x47E4 - - - - b This is the ID of the private key that the data was signed with.
ContentSigAlgo 6 0x47E5 - - - 0 u The algorithm used for the signature.
0 - Not signed,
1 - RSA
ContentSigHashAlgo 6 0x47E6 - - - 0 u The hash algorithm used for the signature.
0 - Not signed,
1 - SHA1-160,
2 - MD5
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Cueing Data
Cues 1 0x1C53BB6B - - - - m * * * * * 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).
CuePoint 2 0xBB mand. mult. - - m * * * * * Contains all information relative to a seek point in the `Segment`.
CueTime 3 0xB3 mand. - - - u * * * * * Absolute timestamp of the seek point, expressed in Segment Ticks, which are based on `TimestampScale`; see timestamp-ticks.
CueTrackPositions 3 0xB7 mand. mult. - - m * * * * * Contains positions for different tracks corresponding to the timestamp.
CueTrack 4 0xF7 mand. - not 0 - u * * * * * The track for which a position is given.
CueClusterPosition 4 0xF1 mand. - - - u * * * * * The `Segment Position` (segment-position) of the `Cluster` containing the associated `Block`.
CueRelativePosition 4 0xF0 - - - - u * * 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`.
CueDuration 4 0xB2 - - - - u * * 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.
CueBlockNumber 4 0x5378 - - not 0 - u * * * * * Number of the `Block` in the specified `Cluster`.
CueCodecState 4 0xEA mand. - - 0 u * * * * 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`.
CueReference 4 0xDB - mult. - - m * * * * The `Clusters` containing the referenced `Blocks`.
CueRefTime 5 0x96 mand. - - - u * * * * Timestamp of the referenced `Block`, expressed in Segment Ticks which is based on `TimestampScale`; see timestamp-ticks.
CueRefCluster 5 0x97 mand. - - - u The `Segment Position` of the `Cluster` containing the referenced `Block`.
CueRefNumber 5 0x535F - - not 0 1 u Number of the referenced `Block` of Track X in the specified `Cluster`.
CueRefCodecState 5 0xEB - - - 0 u The `Segment Position` of the Codec State corresponding to this referenced element. 0 means that the data is taken from the initial `TrackEntry`.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Attachment
Attachments 1 0x1941A469 - - - - m * * * * * Contains attached files.
AttachedFile 2 0x61A7 mand. mult. - - m * * * * * An attached file.
FileDescription 3 0x467E - - - - 8 * * * * * A human-friendly name for the attached file.
FileName 3 0x466E mand. - - - 8 * * * * * Filename of the attached file.
FileMediaType 3 0x4660 mand. - - - s * * * * * Media type of the file following the format described in [@!RFC6838].
FileData 3 0x465C mand. - - - b * * * * * The data of the file.
FileUID 3 0x46AE mand. - not 0 - u * * * * * UID representing the file, as random as possible.
FileReferral 3 0x4675 - - - - b A binary value that a track/codec can refer to when the attachment is needed.
FileUsedStartTime 3 0x4661 - - - - u 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.
FileUsedEndTime 3 0x4662 - - - - u 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.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Chapters
Chapters 1 0x1043A770 - - - - m * * * * * A system to define basic menus and partition data. For more detailed information, see chapters.
EditionEntry 2 0x45B9 mand. mult. - - m * * * * * Contains all information about a `Segment` edition.
EditionUID 3 0x45BC - - not 0 - u * * * * * A UID that identifies the edition. It's useful for tagging an edition.
EditionFlagHidden 3 0x45BD mand. - 0-1 0 u * * * * * 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 notes on `Chapter` flags).
EditionFlagDefault 3 0x45DB mand. - 0-1 0 u * * * * * Set to 1 if the edition **SHOULD** be used as the default one.
EditionFlagOrdered 3 0x45DD mand. - 0-1 0 u * * * * * Set to 1 if the chapters can be defined multiple times and the order to play them is enforced; see editionflagordered.
EditionDisplay 3 0x4520 - mult. - - m * Contains a possible string to use for the edition display for the given languages.
EditionString 4 0x4521 mand. - - - 8 * Contains the string to use as the edition name.
EditionLanguageIETF 4 0x45E4 - mult. - - s * One language corresponding to the EditionString, in the form defined in [@!RFC5646]; see [@!RFC9559, Section 12] on language codes.
ChapterAtom 3+ 0xB6 mand. mult. - - m * * * * * Contains the atom information to use as the chapter atom (applies to all tracks).
ChapterUID 4 0x73C4 mand. - not 0 - u * * * * * A UID that identifies the `Chapter`.
ChapterStringUID 4 0x5654 - - - - 8 * * * A unique string ID that identifies the `Chapter`. For example, it is used as the storage for cue identifier values [@?WebVTT].
ChapterTimeStart 4 0x91 mand. - - - u * * * * * Timestamp of the start of `Chapter`, expressed in Matroska Ticks -- i.e., in nanoseconds; see timestamp-ticks.
ChapterTimeEnd 4 0x92 - - - - u * * * * * 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 if the Edition is an ordered edition; see (#editionflagordered). If it's a Parent Chapter, see (#nested-chapters).
ChapterFlagHidden 4 0x98 mand. - 0-1 0 u * * * * * 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).
ChapterFlagEnabled 4 0x4598 mand. - 0-1 1 u * * * * * 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 notes on `Chapter` flags.
ChapterSegmentUUID 4 0x6E67 - - - - b * * * * * 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 if ChapterSegmentEditionUID is used; see (#medium-linking) on Medium-Linking Segments.
ChapterSkipType 4 0x4588 - - - - u 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.
0 - No Skipping,
1 - Opening Credits,
2 - End Credits,
3 - Recap,
4 - Next Preview,
5 - Preview,
6 - Advertisement,
7 - Intermission
ChapterSegmentEditionUID 4 0x6EBC - - not 0 - u * * * * * 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`.
ChapterPhysicalEquiv 4 0x63C3 - - - - u * * * * * Specifies the physical equivalent of this `ChapterAtom`, e.g., "DVD" (60) or "SIDE" (50); see notes for a complete list of values.
ChapterTrack 4 0x8F - - - - m * * * * * List of tracks on which the chapter applies. If this element is not present, all tracks apply.
ChapterTrackUID 5 0x89 mand. mult. not 0 - u * * * * * 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`.
ChapterDisplay 4 0x80 - mult. - - m * * * * * Contains all possible strings to use for the chapter display.
ChapString 5 0x85 mand. - - - 8 * * * * * Contains the string to use as the chapter atom.
ChapLanguage 5 0x437C mand. mult. - eng s * * * * * A language corresponding to the string, in the Matroska languages form; see basics on language codes. This element **MUST** be ignored if a `ChapLanguageBCP47` element is used within the same `ChapterDisplay` element.
ChapLanguageBCP47 5 0x437D - mult. - - s * * A language corresponding to the `ChapString`, in the form defined in [@!RFC5646]; see basics on language codes. If a `ChapLanguageBCP47` element is used, then any `ChapLanguage` and `ChapCountry` elements used in the same `ChapterDisplay` **MUST** be ignored.
ChapCountry 5 0x437E - mult. - - s * * * * * A country corresponding to the string, in the Matroska countries form; see basics on country codes. This element **MUST** be ignored if a `ChapLanguageBCP47` element is used within the same `ChapterDisplay` element.
ChapProcess 4 0x6944 - mult. - - m * * * * * Contains all the commands associated with the Atom.
ChapProcessCodecID 5 0x6955 mand. - - 0 u * * * * * Contains the type of the codec used for processing.
0 - Matroska Script,
1 - DVD-menu
ChapProcessPrivate 5 0x450D - - - - b * * * * * Optional data attached to the `ChapProcessCodecID` information. For `ChapProcessCodecID` = 1, it is the "DVD level" equivalent; see menu-features on DVD menus.
ChapProcessCommand 5 0x6911 - mult. - - m * * * * * Contains all the commands associated with the Atom.
ChapProcessTime 6 0x6922 mand. - - - u * * * * * Defines when the process command **SHOULD** be handled.
0 - during the whole chapter,
1 - before starting playback,
2 - after playback of the chapter
ChapProcessData 6 0x6933 mand. - - - b * * * * * 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 Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Tagging
Tags 1 0x1254C367 - mult. - - m * * * * * Element containing metadata describing `Tracks`, `Editions`, `Chapters`, `Attachments`, or the `Segment` as a whole. A list of valid tags can be found in Matroska tagging RFC.
Tag 2 0x7373 mand. mult. - - m * * * * * A single metadata descriptor.
Targets 3 0x63C0 mand. - - - m * * * * * 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`.
TargetTypeValue 4 0x68CA mand. - not 0 50 u * * * * * 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.
10 - SHOT,
20 - SUBTRACK / MOVEMENT / SCENE,
30 - TRACK / SONG / CHAPTER,
40 - PART / SESSION,
50 - ALBUM / OPERA / CONCERT / MOVIE / EPISODE,
60 - EDITION / ISSUE / VOLUME / OPUS / SEASON / SEQUEL,
70 - COLLECTION
TargetType 4 0x63CA - - - - s * * * * * An informational string that can be used to display the logical level of the target, such as "ALBUM", "TRACK", "MOVIE", "CHAPTER", etc.
COLLECTION - TargetTypeValue 70,
EDITION - TargetTypeValue 60,
ISSUE - TargetTypeValue 60,
VOLUME - TargetTypeValue 60,
OPUS - TargetTypeValue 60,
SEASON - TargetTypeValue 60,
SEQUEL - TargetTypeValue 60,
ALBUM - TargetTypeValue 50,
OPERA - TargetTypeValue 50,
CONCERT - TargetTypeValue 50,
MOVIE - TargetTypeValue 50,
EPISODE - TargetTypeValue 50,
PART - TargetTypeValue 40,
SESSION - TargetTypeValue 40,
TRACK - TargetTypeValue 30,
SONG - TargetTypeValue 30,
CHAPTER - TargetTypeValue 30,
SUBTRACK - TargetTypeValue 20,
MOVEMENT - TargetTypeValue 20,
SCENE - TargetTypeValue 20,
SHOT - TargetTypeValue 10
TagTrackUID 4 0x63C5 - mult. - 0 u * * * * * 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`.
TagEditionUID 4 0x63C9 - mult. - 0 u * * * * * 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`.
TagChapterUID 4 0x63C4 - mult. - 0 u * * * * * 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`.
TagAttachmentUID 4 0x63C6 - mult. - 0 u * * * * * 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`.
TagBlockAddIDValue 4 0x63C7 - mult. - 0 u * A `BlockAddIDValue`that identifies the `Block Addition Mapping` that the tags belong to. If the value is 0 at this level and if the `TrackUID` value is 0 at this level, the tags apply to all block addition mappings in this `Segment`. If the value is 0 at this level and if the `TrackUID` value is not 0 at this level, the tags apply to all block addition mappings in the referenced `Track`. If the value is not 0 at this level and if the `TrackUID` value is 0 at this level, the tags apply to all block addition mappings with this value in this `Segment`. If the value is not 0 at this level and if the `TrackUID` value is not 0 at this level, the value **MUST** match the `BlockAddIDValue` value of a block addition mapping found in the referenced `Track`.
SimpleTag 3+ 0x67C8 mand. mult. - - m * * * * * Contains general information about the target.
TagName 4 0x45A3 mand. - - - 8 * * * * * The name of the tag value that is going to be stored.
TagLanguage 4 0x447A mand. - - und s * * * * * Specifies the language of the specified tag in the Matroska languages form; see basics on language codes. This element **MUST** be ignored if the `TagLanguageBCP47` element is used within the same `SimpleTag` element.
TagLanguageBCP47 4 0x447B - - - - s * * The language used in the `TagString`, in the form defined in [@!RFC5646]; see basics on language codes. If this element is used, then any `TagLanguage` elements used in the same `SimpleTag` **MUST** be ignored.
TagDefault 4 0x4484 mand. - 0-1 1 u * * * * * A boolean value to indicate if this is the default/original language to use for the given tag.
TagDefaultBogus 4 0x44B4 mand. - 0-1 1 u A variant of the `TagDefault` element with a bogus element ID; see tagdefault.
TagString 4 0x4487 - - - - 8 * * * * * The tag value.
TagBinary 4 0x4485 - - - - b * * * * * The tag value if it is binary. Note that this cannot be used in the same `SimpleTag` as `TagString`.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description