forked from ietf-wg-cellar/matroska-specification
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathebml_matroska.xml
1727 lines (1724 loc) · 137 KB
/
ebml_matroska.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<EBMLSchema xmlns="urn:ietf:rfc:8794" docType="matroska" version="4">
<!-- constraints on EBML Header Elements -->
<element name="EBMLMaxIDLength" path="\EBML\EBMLMaxIDLength" id="0x42F2" type="uinteger" range="4" default="4" minOccurs="1" maxOccurs="1"/>
<element name="EBMLMaxSizeLength" path="\EBML\EBMLMaxSizeLength" id="0x42F3" type="uinteger" range="1-8" default="8" minOccurs="1" maxOccurs="1"/>
<!-- Root Element-->
<element name="Segment" path="\Segment" id="0x18538067" type="master" minOccurs="1" maxOccurs="1" unknownsizeallowed="1">
<documentation lang="en" purpose="definition">The `Root Element` that contains all other `Top-Level Elements`; see (#data-layout).</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SeekHead" path="\Segment\SeekHead" id="0x114D9B74" type="master" maxOccurs="2">
<documentation lang="en" purpose="definition">Contains seeking information of `Top-Level Elements`; see (#data-layout).</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Seek" path="\Segment\SeekHead\Seek" id="0x4DBB" type="master" minOccurs="1">
<documentation lang="en" purpose="definition">Contains a single seek entry to an EBML Element.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SeekID" path="\Segment\SeekHead\Seek\SeekID" id="0x53AB" type="binary" length="4" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The binary EBML ID of a `Top-Level Element`.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SeekPosition" path="\Segment\SeekHead\Seek\SeekPosition" id="0x53AC" type="uinteger" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The `Segment Position` ((#segment-position)) of a `Top-Level Element`.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Info" path="\Segment\Info" id="0x1549A966" type="master" minOccurs="1" maxOccurs="1" recurring="1">
<documentation lang="en" purpose="definition">Contains general information about the `Segment`.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SegmentUUID" path="\Segment\Info\SegmentUUID" id="0x73A4" type="binary" length="16" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<documentation lang="en" purpose="usage notes">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.</documentation>
<extension type="libmatroska" cppname="SegmentUID"/>
</element>
<element name="SegmentFilename" path="\Segment\Info\SegmentFilename" id="0x7384" type="utf-8" maxOccurs="1">
<documentation lang="en" purpose="definition">A filename corresponding to this `Segment`.</documentation>
</element>
<element name="PrevUUID" path="\Segment\Info\PrevUUID" id="0x3CB923" type="binary" length="16" maxOccurs="1">
<documentation lang="en" purpose="definition">An ID that identifies the previous `Segment` of a `Linked Segment`.</documentation>
<documentation lang="en" purpose="usage notes">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`.</documentation>
<extension type="libmatroska" cppname="PrevUID"/>
</element>
<element name="PrevFilename" path="\Segment\Info\PrevFilename" id="0x3C83AB" type="utf-8" maxOccurs="1">
<documentation lang="en" purpose="definition">A filename corresponding to the file of the previous `Linked Segment`.</documentation>
<documentation lang="en" purpose="usage notes">Provision of the previous filename is for display convenience,
but `PrevUUID` **SHOULD** be considered authoritative for identifying the previous `Segment` in a `Linked Segment`.</documentation>
</element>
<element name="NextUUID" path="\Segment\Info\NextUUID" id="0x3EB923" type="binary" length="16" maxOccurs="1">
<documentation lang="en" purpose="definition">An ID that identifies the next `Segment` of a `Linked Segment`.</documentation>
<documentation lang="en" purpose="usage notes">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`.</documentation>
<extension type="libmatroska" cppname="NextUID"/>
</element>
<element name="NextFilename" path="\Segment\Info\NextFilename" id="0x3E83BB" type="utf-8" maxOccurs="1">
<documentation lang="en" purpose="definition">A filename corresponding to the file of the next `Linked Segment`.</documentation>
<documentation lang="en" purpose="usage notes">Provision of the next filename is for display convenience,
but `NextUUID` **SHOULD** be considered authoritative for identifying the Next `Segment`.</documentation>
</element>
<element name="SegmentFamily" path="\Segment\Info\SegmentFamily" id="0x4444" type="binary" length="16">
<documentation lang="en" purpose="definition">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.</documentation>
<documentation lang="en" purpose="usage notes">If the `Segment` `Info` contains a `ChapterTranslate` element, this element is **REQUIRED**.</documentation>
</element>
<element name="ChapterTranslate" path="\Segment\Info\ChapterTranslate" id="0x6924" type="master">
<documentation lang="en" purpose="definition">The mapping between this `Segment` and a
segment value in the given Chapter Codec.</documentation>
<documentation lang="en" purpose="rationale">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.</documentation>
</element>
<element name="ChapterTranslateID" path="\Segment\Info\ChapterTranslate\ChapterTranslateID" id="0x69A5" type="binary" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The binary value used to represent this `Segment` in the chapter codec data.
The format depends on the `ChapProcessCodecID` used; see (#chapprocesscodecid-element).</documentation>
</element>
<element name="ChapterTranslateCodec" path="\Segment\Info\ChapterTranslate\ChapterTranslateCodec" id="0x69BF" type="uinteger" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Applies to the chapter codec of the given chapter edition(s); see (#chapprocesscodecid-element).</documentation>
<extension type="enum source" source="Chapter Codec ID"/>
</element>
<element name="ChapterTranslateEditionUID" path="\Segment\Info\ChapterTranslate\ChapterTranslateEditionUID" id="0x69FC" type="uinteger">
<documentation lang="en" purpose="definition">Specifies a chapter edition UID to which this `ChapterTranslate` applies.</documentation>
<documentation lang="en" purpose="usage notes">When no `ChapterTranslateEditionUID` is specified in the `ChapterTranslate`, the `ChapterTranslate` applies to all chapter editions found in the `Segment` using the given `ChapterTranslateCodec`.</documentation>
</element>
<element name="TimestampScale" path="\Segment\Info\TimestampScale" id="0x2AD7B1" type="uinteger" range="not 0" default="1000000" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="TimecodeScale"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Duration" path="\Segment\Info\Duration" id="0x4489" type="float" range="> 0x0p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Duration of the `Segment`, expressed in `Segment` Ticks, which are based on `TimestampScale`; see (#timestamp-ticks).</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="DateUTC" path="\Segment\Info\DateUTC" id="0x4461" type="date" maxOccurs="1">
<documentation lang="en" purpose="definition">The date and time that the `Segment` was created by the muxing application or library.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Title" path="\Segment\Info\Title" id="0x7BA9" type="utf-8" maxOccurs="1">
<documentation lang="en" purpose="definition">General name of the `Segment`.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="MuxingApp" path="\Segment\Info\MuxingApp" id="0x4D80" type="utf-8" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Muxing application or library (example: "libmatroska-0.4.3").</documentation>
<documentation lang="en" purpose="usage notes">Include the full name of the application or library followed by the version number.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="WritingApp" path="\Segment\Info\WritingApp" id="0x5741" type="utf-8" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Writing application (example: "mkvmerge-0.3.3").</documentation>
<documentation lang="en" purpose="usage notes">Include the full name of the application followed by the version number.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Cluster" path="\Segment\Cluster" id="0x1F43B675" type="master" unknownsizeallowed="1">
<documentation lang="en" purpose="definition">The `Top-Level Element` containing the (monolithic) `Block` structure.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Timestamp" path="\Segment\Cluster\Timestamp" id="0xE7" type="uinteger" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Absolute timestamp of the cluster, expressed in Segment Ticks, which are based on `TimestampScale`; see (#timestamp-ticks).</documentation>
<documentation lang="en" purpose="usage notes">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)).</documentation>
<extension type="libmatroska" cppname="ClusterTimecode"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SilentTracks" path="\Segment\Cluster\SilentTracks" id="0x5854" type="master" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="ClusterSilentTracks"/>
</element>
<element name="SilentTrackNumber" path="\Segment\Cluster\SilentTracks\SilentTrackNumber" id="0x58D7" type="uinteger" minver="0" maxver="0">
<documentation lang="en" purpose="definition">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`.</documentation>
<extension type="libmatroska" cppname="ClusterSilentTrackNumber"/>
</element>
<element name="Position" path="\Segment\Cluster\Position" id="0xA7" type="uinteger" maxver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">The `Segment Position` of the `Cluster` in the `Segment` (0 in live streams).
It might help to resynchronize the offset on damaged streams.</documentation>
<extension type="libmatroska" cppname="ClusterPosition"/>
</element>
<element name="PrevSize" path="\Segment\Cluster\PrevSize" id="0xAB" type="uinteger" maxOccurs="1">
<documentation lang="en" purpose="definition">Size of the previous `Cluster`, in octets. Can be useful for backward playing.</documentation>
<extension type="libmatroska" cppname="ClusterPrevSize"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="SimpleBlock" path="\Segment\Cluster\SimpleBlock" id="0xA3" type="binary" minver="2">
<documentation lang="en" purpose="definition">Similar to `Block` (see (#block-structure)) but without all the extra information.
Mostly used to reduce overhead when no extra feature is needed; see (#simpleblock-structure) on `SimpleBlock` Structure.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="divx.com" divx="1"/>
</element>
<element name="BlockGroup" path="\Segment\Cluster\BlockGroup" id="0xA0" type="master">
<documentation lang="en" purpose="definition">Basic container of information containing a single `Block` and information specific to that `Block`.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Block" path="\Segment\Cluster\BlockGroup\Block" id="0xA1" type="binary" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">`Block` containing the actual data to be rendered and a timestamp relative to the `Cluster` Timestamp;
see (#block-structure) on `Block` Structure.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="BlockVirtual" path="\Segment\Cluster\BlockGroup\BlockVirtual" id="0xA2" type="binary" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">A `Block` with no data. It must be stored in the stream at the place the real `Block` would be in display order.
</documentation>
</element>
<element name="BlockAdditions" path="\Segment\Cluster\BlockGroup\BlockAdditions" id="0x75A1" type="master" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="BlockMore" path="\Segment\Cluster\BlockGroup\BlockAdditions\BlockMore" id="0xA6" type="master" minOccurs="1">
<documentation lang="en" purpose="definition">Contains the `BlockAdditional` and some parameters.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="BlockAdditional" path="\Segment\Cluster\BlockGroup\BlockAdditions\BlockMore\BlockAdditional" id="0xA5" type="binary" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Interpreted by the codec as it wishes (using the `BlockAddID`).</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="BlockAddID" path="\Segment\Cluster\BlockGroup\BlockAdditions\BlockMore\BlockAddID" id="0xEE" type="uinteger" range="not 0" default="1" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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`.</documentation>
<documentation lang="en" purpose="usage notes">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.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="BlockDuration" path="\Segment\Cluster\BlockGroup\BlockDuration" id="0x9B" type="uinteger" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<implementation_note note_attribute="minOccurs">`BlockDuration` **MUST** be set (minOccurs=1) if the associated `TrackEntry` stores a `DefaultDuration` value.</implementation_note>
<implementation_note note_attribute="default">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).</implementation_note>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="ReferencePriority" path="\Segment\Cluster\BlockGroup\ReferencePriority" id="0xFA" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
</element>
<element name="ReferenceBlock" path="\Segment\Cluster\BlockGroup\ReferenceBlock" id="0xFB" type="integer">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="ReferenceVirtual" path="\Segment\Cluster\BlockGroup\ReferenceVirtual" id="0xFD" type="integer" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">The `Segment Position` of the data that would otherwise be in position of the virtual block.</documentation>
</element>
<element name="CodecState" path="\Segment\Cluster\BlockGroup\CodecState" id="0xA4" type="binary" minver="2" maxOccurs="1">
<documentation lang="en" purpose="definition">The new codec state to use. Data interpretation is private to the codec.
This information **SHOULD** always be referenced by a seek entry.</documentation>
</element>
<element name="DiscardPadding" path="\Segment\Cluster\BlockGroup\DiscardPadding" id="0x75A2" type="integer" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Slices" path="\Segment\Cluster\BlockGroup\Slices" id="0x8E" type="master" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">Contains slices description.</documentation>
</element>
<element name="TimeSlice" path="\Segment\Cluster\BlockGroup\Slices\TimeSlice" id="0xE8" type="master" minver="0" maxver="0">
<documentation lang="en" purpose="definition">Contains extra time information about the data contained in the `Block`.
Being able to interpret this element is not required for playback.</documentation>
</element>
<element name="LaceNumber" path="\Segment\Cluster\BlockGroup\Slices\TimeSlice\LaceNumber" id="0xCC" type="uinteger" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="SliceLaceNumber"/>
</element>
<element name="FrameNumber" path="\Segment\Cluster\BlockGroup\Slices\TimeSlice\FrameNumber" id="0xCD" type="uinteger" minver="0" maxver="0" default="0" maxOccurs="1">
<documentation lang="en" purpose="definition">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).</documentation>
<extension type="libmatroska" cppname="SliceFrameNumber"/>
</element>
<element name="BlockAdditionID" path="\Segment\Cluster\BlockGroup\Slices\TimeSlice\BlockAdditionID" id="0xCB" type="uinteger" minver="0" maxver="0" default="0" maxOccurs="1">
<documentation lang="en" purpose="definition">The ID of the `BlockAdditional` element (0 is the main `Block`).</documentation>
<extension type="libmatroska" cppname="SliceBlockAddID"/>
</element>
<element name="Delay" path="\Segment\Cluster\BlockGroup\Slices\TimeSlice\Delay" id="0xCE" type="uinteger" minver="0" maxver="0" default="0" maxOccurs="1">
<documentation lang="en" purpose="definition">The delay to apply to the element, expressed in Track Ticks; see (#timestamp-ticks).</documentation>
<extension type="libmatroska" cppname="SliceDelay"/>
</element>
<element name="SliceDuration" path="\Segment\Cluster\BlockGroup\Slices\TimeSlice\SliceDuration" id="0xCF" type="uinteger" minver="0" maxver="0" default="0" maxOccurs="1">
<documentation lang="en" purpose="definition">The duration to apply to the element, expressed in Track Ticks; see (#timestamp-ticks).</documentation>
</element>
<element name="ReferenceFrame" path="\Segment\Cluster\BlockGroup\ReferenceFrame" id="0xC8" type="master" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">Contains information about the last reference frame. See [@?DivXTrickTrack].</documentation>
<extension type="divx.com" divx="1"/>
</element>
<element name="ReferenceOffset" path="\Segment\Cluster\BlockGroup\ReferenceFrame\ReferenceOffset" id="0xC9" type="uinteger" minver="0" maxver="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The relative offset, in bytes, from the previous `BlockGroup` element for this Smooth FF/RW video track to the containing `BlockGroup`
element. See [@?DivXTrickTrack].</documentation>
<extension type="divx.com" divx="1"/>
</element>
<element name="ReferenceTimestamp" path="\Segment\Cluster\BlockGroup\ReferenceFrame\ReferenceTimestamp" id="0xCA" type="uinteger" minver="0" maxver="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The timestamp of the `BlockGroup` pointed to by ReferenceOffset, expressed in Track Ticks; see (#timestamp-ticks). See [@?DivXTrickTrack].</documentation>
<extension type="libmatroska" cppname="ReferenceTimeCode"/>
<extension type="divx.com" divx="1"/>
</element>
<element name="EncryptedBlock" path="\Segment\Cluster\EncryptedBlock" id="0xAF" type="binary" minver="0" maxver="0">
<documentation lang="en" purpose="definition">Similar to `SimpleBlock` (see (#simpleblock-structure)),
but the data inside the `Block` are Transformed (encrypted and/or signed).</documentation>
</element>
<element name="Tracks" path="\Segment\Tracks" id="0x1654AE6B" type="master" maxOccurs="1" recurring="1">
<documentation lang="en" purpose="definition">A `Top-Level Element` of information with many tracks described.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="TrackEntry" path="\Segment\Tracks\TrackEntry" id="0xAE" type="master" minOccurs="1">
<documentation lang="en" purpose="definition">Describes a track with all elements.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="TrackNumber" path="\Segment\Tracks\TrackEntry\TrackNumber" id="0xD7" type="uinteger" range="not 0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The track number as used in the `Block` Header.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="TrackUID" path="\Segment\Tracks\TrackEntry\TrackUID" id="0x73C5" type="uinteger" range="not 0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">A UID that identifies the `Track`.</documentation>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="TrackType" path="\Segment\Tracks\TrackEntry\TrackType" id="0x83" type="uinteger" range="not 0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The `TrackType` defines the type of each frame found in the `Track`.
The value **SHOULD** be stored on 1 octet.</documentation>
<extension type="enum source" registry="Track Type" policy="Specification Required"/>
<restriction>
<enum value="1" label="video">
<documentation lang="en" purpose="definition">An image.</documentation>
</enum>
<enum value="2" label="audio">
<documentation lang="en" purpose="definition">Audio samples.</documentation>
</enum>
<enum value="3" label="complex">
<documentation lang="en" purpose="definition">A mix of different other `TrackType`. The codec needs to define how the `Matroska Player` should interpret such data.</documentation>
</enum>
<enum value="16" label="logo">
<documentation lang="en" purpose="definition">An image to be rendered over the video track(s).</documentation>
</enum>
<enum value="17" label="subtitle">
<documentation lang="en" purpose="definition">Subtitle or closed caption data to be rendered over the video track(s).</documentation>
</enum>
<enum value="18" label="buttons">
<documentation lang="en" purpose="definition">Interactive button(s) to be rendered over the video track(s).</documentation>
</enum>
<enum value="32" label="control">
<documentation lang="en" purpose="definition">Metadata used to control the player of the `Matroska Player`.</documentation>
</enum>
<enum value="33" label="metadata">
<documentation lang="en" purpose="definition">Timed metadata that can be passed on to the `Matroska Player`.</documentation>
</enum>
</restriction>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="FlagEnabled" path="\Segment\Tracks\TrackEntry\FlagEnabled" id="0xB9" type="uinteger" minver="2" range="0-1" default="1" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="TrackFlagEnabled"/>
</element>
<element name="FlagDefault" path="\Segment\Tracks\TrackEntry\FlagDefault" id="0x88" type="uinteger" range="0-1" default="1" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="TrackFlagDefault"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="FlagForced" path="\Segment\Tracks\TrackEntry\FlagForced" id="0x55AA" type="uinteger" range="0-1" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="TrackFlagForced"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="FlagHearingImpaired" path="\Segment\Tracks\TrackEntry\FlagHearingImpaired" id="0x55AB" type="uinteger" minver="4" range="0-1" maxOccurs="1">
<documentation lang="en" purpose="definition">Set to 1 if and only if the track is suitable for users with hearing impairments.</documentation>
</element>
<element name="FlagVisualImpaired" path="\Segment\Tracks\TrackEntry\FlagVisualImpaired" id="0x55AC" type="uinteger" minver="4" range="0-1" maxOccurs="1">
<documentation lang="en" purpose="definition">Set to 1 if and only if the track is suitable for users with visual impairments.</documentation>
</element>
<element name="FlagTextDescriptions" path="\Segment\Tracks\TrackEntry\FlagTextDescriptions" id="0x55AD" type="uinteger" minver="4" range="0-1" maxOccurs="1">
<documentation lang="en" purpose="definition">Set to 1 if and only if the track contains textual descriptions of video content.</documentation>
</element>
<element name="FlagOriginal" path="\Segment\Tracks\TrackEntry\FlagOriginal" id="0x55AE" type="uinteger" minver="4" range="0-1" maxOccurs="1">
<documentation lang="en" purpose="definition">Set to 1 if and only if the track is in the content's original language.</documentation>
</element>
<element name="FlagCommentary" path="\Segment\Tracks\TrackEntry\FlagCommentary" id="0x55AF" type="uinteger" minver="4" range="0-1" maxOccurs="1">
<documentation lang="en" purpose="definition">Set to 1 if and only if the track contains commentary.</documentation>
</element>
<element name="FlagLacing" path="\Segment\Tracks\TrackEntry\FlagLacing" id="0x9C" type="uinteger" range="0-1" default="1" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="TrackFlagLacing"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="MinCache" path="\Segment\Tracks\TrackEntry\MinCache" id="0x6DE7" type="uinteger" minver="0" maxver="0" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="libmatroska" cppname="TrackMinCache"/>
</element>
<element name="MaxCache" path="\Segment\Tracks\TrackEntry\MaxCache" id="0x6DF8" type="uinteger" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">The maximum cache size necessary to store referenced frames in and the current frame.
0 means no cache is needed.</documentation>
<extension type="libmatroska" cppname="TrackMaxCache"/>
</element>
<element name="DefaultDuration" path="\Segment\Tracks\TrackEntry\DefaultDuration" id="0x23E383" type="uinteger" range="not 0" maxOccurs="1">
<documentation lang="en" purpose="definition">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).</documentation>
<extension type="libmatroska" cppname="TrackDefaultDuration"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="DefaultDecodedFieldDuration" path="\Segment\Tracks\TrackEntry\DefaultDecodedFieldDuration" id="0x234E7A" type="uinteger" minver="4" range="not 0" maxOccurs="1">
<documentation lang="en" purpose="definition">The period between two successive fields at the output of the decoding process, expressed in Matroska Ticks -- i.e., in nanoseconds; see (#timestamp-ticks).
See (#defaultdecodedfieldduration) for more information.</documentation>
<extension type="libmatroska" cppname="TrackDefaultDecodedFieldDuration"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="TrackTimestampScale" path="\Segment\Tracks\TrackEntry\TrackTimestampScale" id="0x23314F" type="float" maxver="3" range="> 0x0p+0" default="0x1p+0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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).</documentation>
<extension type="libmatroska" cppname="TrackTimecodeScale"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="TrackOffset" path="\Segment\Tracks\TrackEntry\TrackOffset" id="0x537F" type="integer" minver="0" maxver="0" default="0" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="stream copy" keep="1"/>
</element>
<element name="MaxBlockAdditionID" path="\Segment\Tracks\TrackEntry\MaxBlockAdditionID" id="0x55EE" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The maximum value of `BlockAddID` ((#blockaddid-element)).
A value of 0 means there is no `BlockAdditions` ((#blockadditions-element)) for this track.</documentation>
</element>
<element name="BlockAdditionMapping" path="\Segment\Tracks\TrackEntry\BlockAdditionMapping" id="0x41E4" type="master" minver="4">
<documentation lang="en" purpose="definition">Contains elements that extend the track format by adding content either to each frame,
with `BlockAddID` ((#blockaddid-element)), or to the track as a whole
with `BlockAddIDExtraData`.</documentation>
</element>
<element name="BlockAddIDValue" path="\Segment\Tracks\TrackEntry\BlockAdditionMapping\BlockAddIDValue" id="0x41F0" type="uinteger" minver="4" range=">=2" maxOccurs="1">
<documentation lang="en" purpose="definition">If the track format extension needs content beside frames,
the value refers to the `BlockAddID` ((#blockaddid-element)) value being described.</documentation>
<documentation lang="en" purpose="usage notes">To keep `MaxBlockAdditionID` as low as possible, small values **SHOULD** be used.</documentation>
</element>
<element name="BlockAddIDName" path="\Segment\Tracks\TrackEntry\BlockAdditionMapping\BlockAddIDName" id="0x41A4" type="string" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">A human-friendly name describing the type of `BlockAdditional` data,
as defined by the associated `Block Additional Mapping`.</documentation>
</element>
<element name="BlockAddIDType" path="\Segment\Tracks\TrackEntry\BlockAdditionMapping\BlockAddIDType" id="0x41E7" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Stores the registered identifier of the `Block Additional Mapping`
to define how the `BlockAdditional` data should be handled.</documentation>
<documentation lang="en" purpose="usage notes">If `BlockAddIDType` is 0, the `BlockAddIDValue` and corresponding `BlockAddID` values **MUST** be 1.</documentation>
</element>
<element name="BlockAddIDExtraData" path="\Segment\Tracks\TrackEntry\BlockAdditionMapping\BlockAddIDExtraData" id="0x41ED" type="binary" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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`.</documentation>
</element>
<element name="Name" path="\Segment\Tracks\TrackEntry\Name" id="0x536E" type="utf-8" maxOccurs="1">
<documentation lang="en" purpose="definition">A human-readable track name.</documentation>
<extension type="libmatroska" cppname="TrackName"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="Language" path="\Segment\Tracks\TrackEntry\Language" id="0x22B59C" type="string" default="eng" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The language of the track,
in the Matroska languages form; see (#language-codes) on language codes.
This element **MUST** be ignored if the `LanguageBCP47` element is used in the same `TrackEntry`.</documentation>
<extension type="libmatroska" cppname="TrackLanguage"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="LanguageBCP47" path="\Segment\Tracks\TrackEntry\LanguageBCP47" id="0x22B59D" type="string" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">The language of the track,
in the form defined in [@!RFC5646]; see (#language-codes) on language codes.
If this element is used, then any `Language` elements used in the same `TrackEntry` **MUST** be ignored.</documentation>
<extension type="libmatroska" cppname="LanguageIETF"/>
</element>
<element name="CodecID" path="\Segment\Tracks\TrackEntry\CodecID" id="0x86" type="string" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">An ID corresponding to the codec;
see [@?I-D.ietf-cellar-codec] for more info.</documentation>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="CodecPrivate" path="\Segment\Tracks\TrackEntry\CodecPrivate" id="0x63A2" type="binary" maxOccurs="1">
<documentation lang="en" purpose="definition">Private data only known to the codec.</documentation>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="CodecName" path="\Segment\Tracks\TrackEntry\CodecName" id="0x258688" type="utf-8" maxOccurs="1">
<documentation lang="en" purpose="definition">A human-readable string specifying the codec.</documentation>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="AttachmentLink" path="\Segment\Tracks\TrackEntry\AttachmentLink" id="0x7446" type="uinteger" maxver="3" range="not 0" maxOccurs="1">
<documentation lang="en" purpose="definition">The UID of an attachment that is used by this codec.</documentation>
<documentation lang="en" purpose="usage notes">The value **MUST** match the `FileUID` value of an attachment found in this `Segment`.</documentation>
<extension type="libmatroska" cppname="TrackAttachmentLink"/>
</element>
<element name="CodecSettings" path="\Segment\Tracks\TrackEntry\CodecSettings" id="0x3A9697" type="utf-8" minver="0" maxver="0" maxOccurs="1">
<documentation lang="en" purpose="definition">A string describing the encoding setting used.</documentation>
</element>
<element name="CodecInfoURL" path="\Segment\Tracks\TrackEntry\CodecInfoURL" id="0x3B4040" type="string" minver="0" maxver="0">
<documentation lang="en" purpose="definition">A URL to find information about the codec used.</documentation>
</element>
<element name="CodecDownloadURL" path="\Segment\Tracks\TrackEntry\CodecDownloadURL" id="0x26B240" type="string" minver="0" maxver="0">
<documentation lang="en" purpose="definition">A URL to download information about the codec used.</documentation>
</element>
<element name="CodecDecodeAll" path="\Segment\Tracks\TrackEntry\CodecDecodeAll" id="0xAA" type="uinteger" maxver="0" range="0-1" default="1" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Set to 1 if the codec can decode potentially damaged data.</documentation>
</element>
<element name="TrackOverlay" path="\Segment\Tracks\TrackEntry\TrackOverlay" id="0x6FAB" type="uinteger" maxver="0">
<documentation lang="en" purpose="definition">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.</documentation>
</element>
<element name="CodecDelay" path="\Segment\Tracks\TrackEntry\CodecDelay" id="0x56AA" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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`.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="SeekPreRoll" path="\Segment\Tracks\TrackEntry\SeekPreRoll" id="0x56BB" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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).</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="TrackTranslate" path="\Segment\Tracks\TrackEntry\TrackTranslate" id="0x6624" type="master">
<documentation lang="en" purpose="definition">The mapping between this `TrackEntry` and a track value in the given Chapter Codec.</documentation>
<documentation lang="en" purpose="rationale">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.</documentation>
</element>
<element name="TrackTranslateTrackID" path="\Segment\Tracks\TrackEntry\TrackTranslate\TrackTranslateTrackID" id="0x66A5" type="binary" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The binary value used to represent this `TrackEntry` in the chapter codec data.
The format depends on the `ChapProcessCodecID` used; see (#chapprocesscodecid-element).</documentation>
</element>
<element name="TrackTranslateCodec" path="\Segment\Tracks\TrackEntry\TrackTranslate\TrackTranslateCodec" id="0x66BF" type="uinteger" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Applies to the chapter codec of the given chapter edition(s); see (#chapprocesscodecid-element).</documentation>
<extension type="enum source" source="Chapter Codec ID"/>
</element>
<element name="TrackTranslateEditionUID" path="\Segment\Tracks\TrackEntry\TrackTranslate\TrackTranslateEditionUID" id="0x66FC" type="uinteger">
<documentation lang="en" purpose="definition">Specifies a chapter edition UID to which this `TrackTranslate` applies.</documentation>
<documentation lang="en" purpose="usage notes">When no `TrackTranslateEditionUID` is specified in the `TrackTranslate`, the `TrackTranslate` applies to all chapter editions found in the `Segment` using the given `TrackTranslateCodec`.</documentation>
</element>
<element name="Video" path="\Segment\Tracks\TrackEntry\Video" id="0xE0" type="master" maxOccurs="1">
<documentation lang="en" purpose="definition">Video settings.</documentation>
<extension type="libmatroska" cppname="TrackVideo"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="FlagInterlaced" path="\Segment\Tracks\TrackEntry\Video\FlagInterlaced" id="0x9A" type="uinteger" minver="2" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Specifies whether the video frames in this track are interlaced.</documentation>
<restriction>
<enum value="0" label="undetermined">
<documentation lang="en" purpose="definition">Unknown status.</documentation>
<documentation lang="en" purpose="usage notes">This value **SHOULD** be avoided.</documentation>
</enum>
<enum value="1" label="interlaced">
<documentation lang="en" purpose="definition">Interlaced frames.</documentation>
</enum>
<enum value="2" label="progressive">
<documentation lang="en" purpose="definition">No interlacing.</documentation>
</enum>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoFlagInterlaced"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="FieldOrder" path="\Segment\Tracks\TrackEntry\Video\FieldOrder" id="0x9D" type="uinteger" minver="4" default="2" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Specifies the field ordering of video frames in this track.</documentation>
<documentation lang="en" purpose="usage notes">If `FlagInterlaced` is not set to 1, this element **MUST** be ignored.</documentation>
<restriction>
<enum value="0" label="progressive">
<documentation lang="en" purpose="definition">Interlaced frames.</documentation>
<documentation lang="en" purpose="usage notes">This value **SHOULD** be avoided; setting `FlagInterlaced` to 2 is sufficient.</documentation>
</enum>
<enum value="1" label="tff">
<documentation lang="en" purpose="definition">Top field displayed first. Top field stored first.</documentation>
</enum>
<enum value="2" label="undetermined">
<documentation lang="en" purpose="definition">Unknown field order.</documentation>
<documentation lang="en" purpose="usage notes">This value **SHOULD** be avoided.</documentation>
</enum>
<enum value="6" label="bff">
<documentation lang="en" purpose="definition">Bottom field displayed first. Bottom field stored first.</documentation>
</enum>
<enum value="9" label="tff (interleaved)">
<documentation lang="en" purpose="definition">Top field displayed first. Fields are interleaved in storage with the top line of the top field stored first.</documentation>
</enum>
<enum value="14" label="bff (interleaved)">
<documentation lang="en" purpose="definition">Bottom field displayed first. Fields are interleaved in storage with the top line of the top field stored first.</documentation>
</enum>
</restriction>
<extension type="libmatroska" cppname="VideoFieldOrder"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="StereoMode" path="\Segment\Tracks\TrackEntry\Video\StereoMode" id="0x53B8" type="uinteger" minver="3" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Stereo-3D video mode. See (#multi-planar-and-3d-videos) for more details.</documentation>
<extension type="enum source" registry="Stereo Mode" policy="Specification Required"/>
<restriction>
<enum value="0" label="mono"/>
<enum value="1" label="side by side (left eye first)"/>
<enum value="2" label="top - bottom (right eye is first)"/>
<enum value="3" label="top - bottom (left eye is first)"/>
<enum value="4" label="checkboard (right eye is first)"/>
<enum value="5" label="checkboard (left eye is first)"/>
<enum value="6" label="row interleaved (right eye is first)"/>
<enum value="7" label="row interleaved (left eye is first)"/>
<enum value="8" label="column interleaved (right eye is first)"/>
<enum value="9" label="column interleaved (left eye is first)"/>
<enum value="10" label="anaglyph (cyan/red)"/>
<enum value="11" label="side by side (right eye first)"/>
<enum value="12" label="anaglyph (green/magenta)"/>
<enum value="13" label="both eyes laced in one Block (left eye is first)"/>
<enum value="14" label="both eyes laced in one Block (right eye is first)"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoStereoMode"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="AlphaMode" path="\Segment\Tracks\TrackEntry\Video\AlphaMode" id="0x53C0" type="uinteger" minver="3" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="enum source" registry="Alpha Mode" policy="First Come First Served"/>
<restriction>
<enum value="0" label="none">
<documentation lang="en" purpose="definition">The `BlockAdditional` element with `BlockAddID` of "1" does not exist or **SHOULD NOT** be considered as containing such data.</documentation>
</enum>
<enum value="1" label="present">
<documentation lang="en" purpose="definition">The `BlockAdditional` element with `BlockAddID` of "1" contains alpha channel data.</documentation>
</enum>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoAlphaMode"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="OldStereoMode" path="\Segment\Tracks\TrackEntry\Video\OldStereoMode" id="0x53B9" type="uinteger" maxver="2" maxOccurs="1">
<documentation lang="en" purpose="definition">Bogus `StereoMode` value used in old versions of [@?libmatroska].</documentation>
<documentation lang="en" purpose="usage notes">This element **MUST NOT** be used. It was an incorrect value used in libmatroska up to 0.9.0.</documentation>
<restriction>
<enum value="0" label="mono"/>
<enum value="1" label="right eye"/>
<enum value="2" label="left eye"/>
<enum value="3" label="both eyes"/>
</restriction>
</element>
<element name="PixelWidth" path="\Segment\Tracks\TrackEntry\Video\PixelWidth" id="0xB0" type="uinteger" range="not 0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Width of the encoded video frames in pixels.</documentation>
<extension type="libmatroska" cppname="VideoPixelWidth"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="PixelHeight" path="\Segment\Tracks\TrackEntry\Video\PixelHeight" id="0xBA" type="uinteger" range="not 0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Height of the encoded video frames in pixels.</documentation>
<extension type="libmatroska" cppname="VideoPixelHeight"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="PixelCropBottom" path="\Segment\Tracks\TrackEntry\Video\PixelCropBottom" id="0x54AA" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The number of video pixels to remove at the bottom of the image.</documentation>
<extension type="libmatroska" cppname="VideoPixelCropBottom"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="PixelCropTop" path="\Segment\Tracks\TrackEntry\Video\PixelCropTop" id="0x54BB" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The number of video pixels to remove at the top of the image.</documentation>
<extension type="libmatroska" cppname="VideoPixelCropTop"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="PixelCropLeft" path="\Segment\Tracks\TrackEntry\Video\PixelCropLeft" id="0x54CC" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The number of video pixels to remove on the left of the image.</documentation>
<extension type="libmatroska" cppname="VideoPixelCropLeft"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="PixelCropRight" path="\Segment\Tracks\TrackEntry\Video\PixelCropRight" id="0x54DD" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The number of video pixels to remove on the right of the image.</documentation>
<extension type="libmatroska" cppname="VideoPixelCropRight"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="DisplayWidth" path="\Segment\Tracks\TrackEntry\Video\DisplayWidth" id="0x54B0" type="uinteger" range="not 0" maxOccurs="1">
<documentation lang="en" purpose="definition">Width of the video frames to display. Applies to the video frame after cropping (PixelCrop* Elements).</documentation>
<implementation_note note_attribute="default">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.</implementation_note>
<extension type="libmatroska" cppname="VideoDisplayWidth"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="DisplayHeight" path="\Segment\Tracks\TrackEntry\Video\DisplayHeight" id="0x54BA" type="uinteger" range="not 0" maxOccurs="1">
<documentation lang="en" purpose="definition">Height of the video frames to display. Applies to the video frame after cropping (PixelCrop* Elements).</documentation>
<implementation_note note_attribute="default">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.</implementation_note>
<extension type="libmatroska" cppname="VideoDisplayHeight"/>
<extension type="stream copy" keep="1"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="DisplayUnit" path="\Segment\Tracks\TrackEntry\Video\DisplayUnit" id="0x54B2" type="uinteger" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">How `DisplayWidth` and `DisplayHeight` are interpreted.</documentation>
<extension type="enum source" registry="Display Unit" policy="Specification Required"/>
<restriction>
<enum value="0" label="pixels"/>
<enum value="1" label="centimeters"/>
<enum value="2" label="inches"/>
<enum value="3" label="display aspect ratio"/>
<enum value="4" label="unknown"/>
</restriction>
<extension type="libmatroska" cppname="VideoDisplayUnit"/>
<extension type="webmproject.org" webm="1"/>
</element>
<element name="AspectRatioType" path="\Segment\Tracks\TrackEntry\Video\AspectRatioType" id="0x54B3" type="uinteger" minver="0" maxver="0" default="0" maxOccurs="1">
<documentation lang="en" purpose="definition">Specifies the possible modifications to the aspect ratio.</documentation>
<restriction>
<enum value="0" label="free resizing"/>
<enum value="1" label="keep aspect ratio"/>
<enum value="2" label="fixed"/>
</restriction>
<extension type="libmatroska" cppname="VideoAspectRatio"/>
</element>
<element name="UncompressedFourCC" path="\Segment\Tracks\TrackEntry\Video\UncompressedFourCC" id="0x2EB524" type="binary" length="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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].</documentation>
<implementation_note note_attribute="minOccurs">UncompressedFourCC **MUST** be set (minOccurs=1) in `TrackEntry` when the `CodecID` element of the `TrackEntry` is set to "V_UNCOMPRESSED".</implementation_note>
<extension type="libmatroska" cppname="VideoColourSpace"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="GammaValue" path="\Segment\Tracks\TrackEntry\Video\GammaValue" id="0x2FB523" type="float" minver="0" maxver="0" range="> 0x0p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Gamma value.</documentation>
<extension type="libmatroska" cppname="VideoGamma"/>
</element>
<element name="FrameRate" path="\Segment\Tracks\TrackEntry\Video\FrameRate" id="0x2383E3" type="float" minver="0" maxver="0" range="> 0x0p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">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`.</documentation>
<extension type="libmatroska" cppname="VideoFrameRate"/>
</element>
<element name="Colour" path="\Segment\Tracks\TrackEntry\Video\Colour" id="0x55B0" type="master" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">Settings describing the color format.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColour"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="MatrixCoefficients" path="\Segment\Tracks\TrackEntry\Video\Colour\MatrixCoefficients" id="0x55B1" type="uinteger" minver="4" default="2" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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].</documentation>
<restriction>
<enum value="0" label="Identity"/>
<enum value="1" label="ITU-R BT.709"/>
<enum value="2" label="unspecified"/>
<enum value="3" label="reserved"/>
<enum value="4" label="US FCC 73.682"/>
<enum value="5" label="ITU-R BT.470BG"/>
<enum value="6" label="SMPTE 170M"/>
<enum value="7" label="SMPTE 240M"/>
<enum value="8" label="YCoCg"/>
<enum value="9" label="BT2020 Non-constant Luminance"/>
<enum value="10" label="BT2020 Constant Luminance"/>
<enum value="11" label="SMPTE ST 2085"/>
<enum value="12" label="Chroma-derived Non-constant Luminance"/>
<enum value="13" label="Chroma-derived Constant Luminance"/>
<enum value="14" label="ITU-R BT.2100-0"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourMatrix"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="BitsPerChannel" path="\Segment\Tracks\TrackEntry\Video\Colour\BitsPerChannel" id="0x55B2" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Number of decoded bits per channel. A value of 0 indicates that the `BitsPerChannel` is unspecified.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoBitsPerChannel"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ChromaSubsamplingHorz" path="\Segment\Tracks\TrackEntry\Video\Colour\ChromaSubsamplingHorz" id="0x55B3" type="uinteger" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoChromaSubsampHorz"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ChromaSubsamplingVert" path="\Segment\Tracks\TrackEntry\Video\Colour\ChromaSubsamplingVert" id="0x55B4" type="uinteger" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoChromaSubsampVert"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="CbSubsamplingHorz" path="\Segment\Tracks\TrackEntry\Video\Colour\CbSubsamplingHorz" id="0x55B5" type="uinteger" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoCbSubsampHorz"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="CbSubsamplingVert" path="\Segment\Tracks\TrackEntry\Video\Colour\CbSubsamplingVert" id="0x55B6" type="uinteger" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">The number of pixels to remove in the Cb channel for every pixel not removed vertically.
This is additive with `ChromaSubsamplingVert`.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoCbSubsampVert"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ChromaSitingHorz" path="\Segment\Tracks\TrackEntry\Video\Colour\ChromaSitingHorz" id="0x55B7" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">How chroma is subsampled horizontally.</documentation>
<extension type="enum source" registry="Horizontal Chroma Siting" policy="First Come First Served"/>
<restriction>
<enum value="0" label="unspecified"/>
<enum value="1" label="left collocated"/>
<enum value="2" label="half"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoChromaSitHorz"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ChromaSitingVert" path="\Segment\Tracks\TrackEntry\Video\Colour\ChromaSitingVert" id="0x55B8" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">How chroma is subsampled vertically.</documentation>
<extension type="enum source" registry="Vertical Chroma Siting" policy="First Come First Served"/>
<restriction>
<enum value="0" label="unspecified"/>
<enum value="1" label="top collocated"/>
<enum value="2" label="half"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoChromaSitVert"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="Range" path="\Segment\Tracks\TrackEntry\Video\Colour\Range" id="0x55B9" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Clipping of the color ranges.</documentation>
<extension type="enum source" registry="Color Range" policy="Specification Required"/>
<restriction>
<enum value="0" label="unspecified"/>
<enum value="1" label="broadcast range"/>
<enum value="2" label="full range (no clipping)"/>
<enum value="3" label="defined by MatrixCoefficients / TransferCharacteristics"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourRange"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="TransferCharacteristics" path="\Segment\Tracks\TrackEntry\Video\Colour\TransferCharacteristics" id="0x55BA" type="uinteger" minver="4" default="2" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The transfer characteristics of the video. For clarity,
the value and meanings for `TransferCharacteristics` are adopted from Table 3 of [@!ITU-H.273].</documentation>
<restriction>
<enum value="0" label="reserved"/>
<enum value="1" label="ITU-R BT.709"/>
<enum value="2" label="unspecified"/>
<enum value="3" label="reserved2"/>
<enum value="4" label="Gamma 2.2 curve - BT.470M"/>
<enum value="5" label="Gamma 2.8 curve - BT.470BG"/>
<enum value="6" label="SMPTE 170M"/>
<enum value="7" label="SMPTE 240M"/>
<enum value="8" label="Linear"/>
<enum value="9" label="Log"/>
<enum value="10" label="Log Sqrt"/>
<enum value="11" label="IEC 61966-2-4"/>
<enum value="12" label="ITU-R BT.1361 Extended Colour Gamut"/>
<enum value="13" label="IEC 61966-2-1"/>
<enum value="14" label="ITU-R BT.2020 10 bit"/>
<enum value="15" label="ITU-R BT.2020 12 bit"/>
<enum value="16" label="ITU-R BT.2100 Perceptual Quantization"/>
<enum value="17" label="SMPTE ST 428-1"/>
<enum value="18" label="ARIB STD-B67 (HLG)"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourTransferCharacter"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="Primaries" path="\Segment\Tracks\TrackEntry\Video\Colour\Primaries" id="0x55BB" type="uinteger" minver="4" default="2" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">The color primaries of the video. For clarity,
the value and meanings for `Primaries` are adopted from Table 2 of [@!ITU-H.273].</documentation>
<restriction>
<enum value="0" label="reserved"/>
<enum value="1" label="ITU-R BT.709"/>
<enum value="2" label="unspecified"/>
<enum value="3" label="reserved2"/>
<enum value="4" label="ITU-R BT.470M"/>
<enum value="5" label="ITU-R BT.470BG - BT.601 625"/>
<enum value="6" label="ITU-R BT.601 525 - SMPTE 170M"/>
<enum value="7" label="SMPTE 240M"/>
<enum value="8" label="FILM"/>
<enum value="9" label="ITU-R BT.2020"/>
<enum value="10" label="SMPTE ST 428-1"/>
<enum value="11" label="SMPTE RP 432-2"/>
<enum value="12" label="SMPTE EG 432-2"/>
<enum value="22" label="EBU Tech. 3213-E - JEDEC P22 phosphors"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourPrimaries"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="MaxCLL" path="\Segment\Tracks\TrackEntry\Video\Colour\MaxCLL" id="0x55BC" type="uinteger" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">Maximum brightness of a single pixel (Maximum Content Light Level)
in candelas per square meter (cd/m^2^).</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourMaxCLL"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="MaxFALL" path="\Segment\Tracks\TrackEntry\Video\Colour\MaxFALL" id="0x55BD" type="uinteger" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">Maximum brightness of a single full frame (Maximum Frame-Average Light Level)
in candelas per square meter (cd/m^2^).</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourMaxFALL"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="MasteringMetadata" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata" id="0x55D0" type="master" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">SMPTE 2086 mastering data.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoColourMasterMeta"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="PrimaryRChromaticityX" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\PrimaryRChromaticityX" id="0x55D1" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Red X chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoRChromaX"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="PrimaryRChromaticityY" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\PrimaryRChromaticityY" id="0x55D2" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Red Y chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoRChromaY"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="PrimaryGChromaticityX" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\PrimaryGChromaticityX" id="0x55D3" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Green X chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoGChromaX"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="PrimaryGChromaticityY" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\PrimaryGChromaticityY" id="0x55D4" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Green Y chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoGChromaY"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="PrimaryBChromaticityX" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\PrimaryBChromaticityX" id="0x55D5" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Blue X chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoBChromaX"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="PrimaryBChromaticityY" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\PrimaryBChromaticityY" id="0x55D6" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Blue Y chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoBChromaY"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="WhitePointChromaticityX" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\WhitePointChromaticityX" id="0x55D7" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">White X chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoWhitePointChromaX"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="WhitePointChromaticityY" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\WhitePointChromaticityY" id="0x55D8" type="float" minver="4" range="0x0p+0-0x1p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">White Y chromaticity coordinate, as defined by [@!CIE-1931].</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoWhitePointChromaY"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="LuminanceMax" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\LuminanceMax" id="0x55D9" type="float" minver="4" range=">= 0x0p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Maximum luminance. Represented in candelas per square meter (cd/m^2^).</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoLuminanceMax"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="LuminanceMin" path="\Segment\Tracks\TrackEntry\Video\Colour\MasteringMetadata\LuminanceMin" id="0x55DA" type="float" minver="4" range=">= 0x0p+0" maxOccurs="1">
<documentation lang="en" purpose="definition">Minimum luminance. Represented in candelas per square meter (cd/m^2^).</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoLuminanceMin"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="Projection" path="\Segment\Tracks\TrackEntry\Video\Projection" id="0x7670" type="master" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">Describes the video projection details. Used to render spherical or VR videos or to flip videos horizontally or vertically.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoProjection"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ProjectionType" path="\Segment\Tracks\TrackEntry\Video\Projection\ProjectionType" id="0x7671" type="uinteger" minver="4" default="0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">Describes the projection used for this video track.</documentation>
<extension type="enum source" registry="Projection Type" policy="First Come First Served"/>
<restriction>
<enum value="0" label="rectangular"/>
<enum value="1" label="equirectangular"/>
<enum value="2" label="cubemap"/>
<enum value="3" label="mesh"/>
</restriction>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoProjectionType"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ProjectionPrivate" path="\Segment\Tracks\TrackEntry\Video\Projection\ProjectionPrivate" id="0x7672" type="binary" minver="4" maxOccurs="1">
<documentation lang="en" purpose="definition">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").</documentation>
<documentation lang="en" purpose="usage notes">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoProjectionPrivate"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ProjectionPoseYaw" path="\Segment\Tracks\TrackEntry\Video\Projection\ProjectionPoseYaw" id="0x7673" type="float" minver="4" range=">= -0xB4p+0, <= 0xB4p+0" default="0x0p+0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoProjectionPoseYaw"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ProjectionPosePitch" path="\Segment\Tracks\TrackEntry\Video\Projection\ProjectionPosePitch" id="0x7674" type="float" minver="4" range=">= -0x5Ap+0, <= 0x5Ap+0" default="0x0p+0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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.</documentation>
<extension type="webmproject.org" webm="1"/>
<extension type="libmatroska" cppname="VideoProjectionPosePitch"/>
<extension type="stream copy" keep="1"/>
</element>
<element name="ProjectionPoseRoll" path="\Segment\Tracks\TrackEntry\Video\Projection\ProjectionPoseRoll" id="0x7675" type="float" minver="4" range=">= -0xB4p+0, <= 0xB4p+0" default="0x0p+0" minOccurs="1" maxOccurs="1">
<documentation lang="en" purpose="definition">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