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 a1f7f0a @ 2023-04-01 17:17:24 +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 unique ID to identify the Segment amongst many others (128 bits). It is equivalent to a UUID v4 [@!RFC4122] with all bits randomly (or pseudo-randomly) 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 unique ID **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 to identify 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 to identify 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 unique ID that all Segments of a Linked Segment **MUST** share (128 bits). It is equivalent to a UUID v4 [@!RFC4122] with all bits randomly (or pseudo-randomly) 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 Codec may need to address different segments, but they may not know of the way to identify such segment 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 Segment IDs 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 * * * * * This `ChapterTranslate` applies to this chapter codec of the given chapter edition(s); see ChapProcessCodecID.
0 - Matroska Script,
1 - DVD-menu
ChapterTranslateEditionUID 3 0x69FC - mult. - - u * * * * * Specify a chapter edition UID on 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 is 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 is 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 on seeking or to decide what track to use.
SilentTrackNumber 3 0x58D7 - mult. - - u One of the track number that are 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 resynchronise 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 reduced 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 * * * * * Contain additional binary data to complete the main one; see Codec BlockAdditions section of Matroska codec RFC 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 * * * * * Contain 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 to identify how to interpret the BlockAdditional data; see Codec BlockAdditions section of Matroska codec RFC for more information. A value of 1 indicates that the meaning of the BlockAdditional data is defined by the codec. Any other value indicates the meaning of the BlockAdditional data is found in the BlockAddIDType found in the TrackEntry. Each BlockAddID value **MUST** be unique between all BlockMore elements found in a BlockAdditions.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. When not written and with no DefaultDuration, 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 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` this `Block` depends on. Historically Matroska Writer didn't write the actual `Block(s)` this `Block` depends on, but *some* `Block` in the past. The value "0" **MAY** also be used to signify this `Block` cannot be decoded on its own, but without knownledge of which `Block` is necessary. In this case, other `ReferenceBlock` **MUST NOT** be found in the same `BlockGroup`. If the `BlockGroup` doesn't have any `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 value, at the beginning of the Block for negative value). 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 (allow you to generate 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 (encrypt 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 unique ID to identify the Track.
TrackType 3 0x83 mand. - - - 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 not usable track into a usable track using chapter codecs or control tracks.
FlagDefault 3 0x88 mand. - 0-1 1 u * * * * * Set if that track (audio, video or subs) 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 if that track is eligible for automatic selection by the player if it matches the user's language preference, even if the user's preferences would normally not enable subtitles with the selected audio track; this can be used for tracks containing only translations of foreign-language audio or onscreen text. See default-track-selection for more details.
FlagHearingImpaired 3 0x55AB - - 0-1 - u * * Set to 1 if and only if that track is suitable for users with hearing impairments.
FlagVisualImpaired 3 0x55AC - - 0-1 - u * * Set to 1 if and only if that track is suitable for users with visual impairments.
FlagTextDescriptions 3 0x55AD - - 0-1 - u * * Set to 1 if and only if that track contains textual descriptions of video content.
FlagOriginal 3 0x55AE - - 0-1 - u * * Set to 1 if and only if that track is in the content's original language.
FlagCommentary 3 0x55AF - - 0-1 - u * * Set to 1 if and only if that track contains commentary.
FlagLacing 3 0x9C mand. - 0-1 1 u * * * * * Set to 1 if the track **MAY** contain blocks using 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 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 [@!BCP47] form; 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 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). That means 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 not found it should be the second, etc.
CodecDelay 3 0x56AA mand. - - 0 u * * CodecDelay is The codec-built-in delay, expressed in Matroska Ticks -- i.e., in nanoseconds; see timestamp-ticks. It represents the amount 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, SeekPreRoll is the duration of the data 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 Codec may need to address content in 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 * * * * * This `TrackTranslate` applies to this chapter codec of the given chapter edition(s); see ChapProcessCodecID.
0 - Matroska Script,
1 - DVD-menu
TrackTranslateEditionUID 4 0x66FC - mult. - - u * * * * * Specify a chapter edition UID on 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 * * * * Specify whether the video frames in this track are interlaced.
0 - undetermined,
1 - interlaced,
2 - progressive
FieldOrder 4 0x9D mand. - - 2 u * * Specify 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 - bff(swapped),
14 - tff(swapped)
StereoMode 4 0x53B8 mand. - - 0 u * * * Stereo-3D video mode. There are some more details in notes.
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 * * * Indicate whether the BlockAdditional Element with BlockAddID of "1" contains Alpha data, as defined by to the Codec Mapping for the `CodecID`. Undefined values **SHOULD NOT** be used as the behavior of known implementations is different (considered either as 0 or 1).
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 & DisplayHeight are interpreted.
0 - pixels,
1 - centimeters,
2 - inches,
3 - display aspect ratio,
4 - unknown
AspectRatioType 4 0x54B3 - - - 0 u Specify the possible modifications to the aspect ratio.
0 - free resizing,
1 - keep aspect ratio,
2 - fixed
UncompressedFourCC 4 0x2EB524 - - - - b * * * * * Specify 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 no 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 colour 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 ISO/IEC 23001-8:2016 or ITU-T 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 amount 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 amount 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 amount 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 amount 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 ISO/IEC 23091-4 or ITU-T 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 colour primaries of the video. For clarity, the value and meanings for Primaries are adopted from Table 2 of ISO/IEC 23091-4 or ITU-T 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, VR videos or flipping videos horizontally/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 included. Setting `ProjectionPoseYaw` to 180 or -180 degrees, with the `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 included.
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 included. Setting `ProjectionPoseRoll` to 180 or -180 degrees, the `ProjectionPoseYaw` to 180 or -180 degrees with `ProjectionPosePitch` set to 0 degrees flips the image vertically. Setting `ProjectionPoseRoll` to 180 or -180 degrees, with the `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 (used for 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 look at 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 need 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 SegmentUID 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 must 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 SegmentUID 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 * * * * * Tell in which 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 over for each `ContentEncoding` found in the `ContentEncodings` of this `TrackEntry`.
ContentEncodingScope 5 0x5032 mand. - - 1 u * * * * * A bit field that describes which Elements have been modified in this way. Values (big-endian) can be OR'ed.
1 - Block,
2 - Private,
4 - Next
ContentEncodingType 5 0x5033 mand. - - 0 u * * * * * A value describing what kind of transformation 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 not to prevent seeking.
ContentCompAlgo 6 0x4254 mand. - - 0 u * * * * * The compression algorithm used. Compression method "1" (bzlib) and "2" (lzo1x) are lacking 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" as possible, 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 frames 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 this is the ID of the public key the the data was encrypted with.
ContentEncAESSettings 6 0x47E7 - - - - m * * Settings describing the encryption algorithm used.
AESSettingsCipherMode 7 0x47E8 mand. - - - 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 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 Matroska Ticks -- i.e., in nanoseconds; see timestamp-ticks.
CueTrackPositions 3 0xB7 mand. mult. - - m * * * * * Contain 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 is 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 Cue Element. 0 means that the data is taken from the initial Track Entry.
CueReference 4 0xDB - mult. - - m * * * * The Clusters containing the referenced Blocks.
CueRefTime 5 0x96 mand. - - - u * * * * Timestamp of the referenced Block, expressed in Matroska Ticks -- i.e., in nanoseconds; 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 Track Entry.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Attachment
Attachments 1 0x1941A469 - - - - m * * * * * Contain 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 [@!RFC6838] format.
FileData 3 0x465C mand. - - - b * * * * * The data of the file.
FileUID 3 0x46AE mand. - not 0 - u * * * * * Unique ID 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 is 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 is 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, look at the Chapters explanation in chapters.
EditionEntry 2 0x45B9 mand. mult. - - m * * * * * Contains all information about a Segment edition.
EditionUID 3 0x45BC - - not 0 - u * * * * * A unique ID to identify 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 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 [@!BCP47] form; see basics on language codes.
ChapterAtom 3+ 0xB6 mand. mult. - - m * * * * * Contains the atom information to use as the chapter atom (apply to all tracks).
ChapterUID 4 0x73C4 mand. - not 0 - u * * * * * A unique ID to identify the Chapter.
ChapterStringUID 4 0x5654 - - - - 8 * * * A unique string ID to identify the Chapter. For example it is used as the storage for [@?WebVTT] cue identifier values.
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`. The `ChapterTimeEnd` timestamp value being excluded, it **MUST** take in 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), unless 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 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 Indicate 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
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 * * * * * Specify the physical equivalent of this ChapterAtom like "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 [@!BCP47] form; 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 to the Atom.
ChapProcessCodecID 5 0x6955 mand. - - 0 u * * * * * Contains the type of the codec used for the processing. A value of 0 means native Matroska processing (to be defined), a value of 1 means the DVD command set is used; see menu-features on DVD menus. More codec IDs can be added later.
ChapProcessPrivate 5 0x450D - - - - b * * * * * Some 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 to 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 applies to. If empty or omitted, then the Tag describes everything in the Segment.
TargetTypeValue 4 0x68CA mand. - - 50 u * * * * * A number to indicate the logical level of the target.
70 - COLLECTION,
60 - EDITION / ISSUE / VOLUME / OPUS / SEASON / SEQUEL,
50 - ALBUM / OPERA / CONCERT / MOVIE / EPISODE,
40 - PART / SESSION,
30 - TRACK / SONG / CHAPTER,
20 - SUBTRACK / MOVEMENT / SCENE,
10 - SHOT
TargetType 4 0x63CA - - - - s * * * * * An informational string that can be used to display the logical level of the target like "ALBUM", "TRACK", "MOVIE", "CHAPTER", etc. ; see Section 6.4 of Matroska tagging RFC.
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 unique ID to identify the Track(s) 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 unique ID to identify the EditionEntry(s) 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 unique ID to identify the Chapter(s) 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 unique ID to identify the Attachment(s) 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.
SimpleTag 3+ 0x67C8 mand. mult. - - m * * * * * Contains general information about the target.
TagName 4 0x45A3 mand. - - - 8 * * * * * The name of the Tag that is going to be stored.
TagLanguage 4 0x447A mand. - - und s * * * * * Specifies the language of the tag specified, 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 [@!BCP47] form; 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 value of the Tag.
TagBinary 4 0x4485 - - - - b * * * * * The values of the Tag, 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