-
Notifications
You must be signed in to change notification settings - Fork 2
/
ebml_matroska.xml
1709 lines (1698 loc) · 135 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>
</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" range="not 0" length="16" maxOccurs="1">
<documentation lang="en" purpose="definition">A randomly generated unique ID to identify the Segment amongst many others (128 bits).
It is effectively a Universally Unique IDentifier stored in binary form [@!RFC4122].</documentation>
<documentation lang="en" purpose="usage notes">If the Segment is a part of a Linked Segment, then this Element is **REQUIRED**.</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">A unique ID to identify the previous Segment of a Linked Segment (128 bits).
Like the SegmentUUID, it is a Universally Unique IDentifier stored in binary form [@!RFC4122].</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">A unique ID to identify the next Segment of a Linked Segment (128 bits).
Like the SegmentUUID, it is a Universally Unique IDentifier stored in binary form [@!RFC4122].</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 randomly generated unique ID that all Segments of a Linked Segment **MUST** share (128 bits).
It is effectively a Universally Unique IDentifier stored in binary form [@!RFC4122].</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 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.</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">This `ChapterTranslate` applies to this chapter codec of the given chapter edition(s); see (#chapprocesscodecid-element).</documentation>
<restriction>
<enum value="0" label="Matroska Script">
<documentation lang="en" purpose="definition">Chapter commands using the Matroska Script codec.</documentation>
</enum>
<enum value="1" label="DVD-menu">
<documentation lang="en" purpose="definition">Chapter commands using the DVD-like codec.</documentation>
</enum>
</restriction>
</element>
<element name="ChapterTranslateEditionUID" path="\Segment\Info\ChapterTranslate\ChapterTranslateEditionUID" id="0x69FC" type="uinteger">
<documentation lang="en" purpose="definition">Specify a chapter edition UID on 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 is 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 is 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 on seeking or to decide 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 number that are 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 resynchronise 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 reduced 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">Contain additional binary data to complete the main one; see Codec BlockAdditions section of [@?MatroskaCodec] 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">Contain 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 to identify how to interpret the BlockAdditional data; see Codec BlockAdditions section of [@?MatroskaCodec] 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.</documentation>
<documentation lang="en" purpose="usage notes">Each BlockAddID value **MUST** be unique between all BlockMore elements found in a BlockAdditions.</documentation>
<documentation lang="en" purpose="usage notes">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">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).</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 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` 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.</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 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.</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
(allow you to generate 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 (encrypt 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 unique ID to identify 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" 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>
<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 not usable track 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 if that track (audio, video or subs) 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 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.</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 that 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 that 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 that 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 that 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 that 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 using 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 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 [@!BCP47] form; 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 [@?MatroskaCodec] 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 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">
<documentation lang="en" purpose="definition">Specify that this track is an overlay track for the Track specified (in the u-integer).
That means when this track has a gap, see (#silenttracks-element) 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.</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">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.</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, 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).</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 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.</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">This `TrackTranslate` applies to this chapter codec of the given chapter edition(s); see (#chapprocesscodecid-element).</documentation>
<restriction>
<enum value="0" label="Matroska Script">
<documentation lang="en" purpose="definition">Chapter commands using the Matroska Script codec.</documentation>
</enum>
<enum value="1" label="DVD-menu">
<documentation lang="en" purpose="definition">Chapter commands using the DVD-like codec.</documentation>
</enum>
</restriction>
</element>
<element name="TrackTranslateEditionUID" path="\Segment\Tracks\TrackEntry\TrackTranslate\TrackTranslateEditionUID" id="0x66FC" type="uinteger">
<documentation lang="en" purpose="definition">Specify a chapter edition UID on 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">Specify 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">Specify 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="bff(swapped)">
<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="tff(swapped)">
<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. There are some more details in (#multi-planar-and-3d-videos).</documentation>
<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">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).</documentation>
<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 & DisplayHeight are interpreted.</documentation>
<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">Specify 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">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].</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 colour 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 ISO/IEC 23001-8:2016 or ITU-T 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 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.</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 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.</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 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.</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 amount 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>
<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>
<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>
<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 ISO/IEC 23091-4 or ITU-T 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 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.</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="0-1" 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="0-1" 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="0-1" 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="0-1" 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="0-1" 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="0-1" 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="0-1" 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="0-1" 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, VR videos or flipping videos horizontally/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>
<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" range=">= -0xB4p+0, <= 0xB4p+0" minver="4" 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 included.
Setting `ProjectionPoseYaw` to 180 or -180 degrees, with the `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 included.</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 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.