1 /* 2 * Matroska constants 3 * Copyright (c) 2003-2004 The FFmpeg project 4 * 5 * This file is part of FFmpeg. 6 * 7 * FFmpeg is free software; you can redistribute it and/or 8 * modify it under the terms of the GNU Lesser General Public 9 * License as published by the Free Software Foundation; either 10 * version 2.1 of the License, or (at your option) any later version. 11 * 12 * FFmpeg is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with FFmpeg; if not, write to the Free Software 19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 20 */ 21 22 #ifndef AVFORMAT_MATROSKA_H 23 #define AVFORMAT_MATROSKA_H 24 25 #include "libavcodec/avcodec.h" 26 #include "metadata.h" 27 #include "internal.h" 28 29 /* EBML version supported */ 30 #define EBML_VERSION 1 31 32 /* top-level master-IDs */ 33 #define EBML_ID_HEADER 0x1A45DFA3 34 35 /* IDs in the HEADER master */ 36 #define EBML_ID_EBMLVERSION 0x4286 37 #define EBML_ID_EBMLREADVERSION 0x42F7 38 #define EBML_ID_EBMLMAXIDLENGTH 0x42F2 39 #define EBML_ID_EBMLMAXSIZELENGTH 0x42F3 40 #define EBML_ID_DOCTYPE 0x4282 41 #define EBML_ID_DOCTYPEVERSION 0x4287 42 #define EBML_ID_DOCTYPEREADVERSION 0x4285 43 44 /* general EBML types */ 45 #define EBML_ID_VOID 0xEC 46 #define EBML_ID_CRC32 0xBF 47 48 /* 49 * Matroska element IDs, max. 32 bits 50 */ 51 52 /* toplevel segment */ 53 #define MATROSKA_ID_SEGMENT 0x18538067 54 55 /* Matroska top-level master IDs */ 56 #define MATROSKA_ID_INFO 0x1549A966 57 #define MATROSKA_ID_TRACKS 0x1654AE6B 58 #define MATROSKA_ID_CUES 0x1C53BB6B 59 #define MATROSKA_ID_TAGS 0x1254C367 60 #define MATROSKA_ID_SEEKHEAD 0x114D9B74 61 #define MATROSKA_ID_ATTACHMENTS 0x1941A469 62 #define MATROSKA_ID_CLUSTER 0x1F43B675 63 #define MATROSKA_ID_CHAPTERS 0x1043A770 64 65 /* IDs in the info master */ 66 #define MATROSKA_ID_TIMECODESCALE 0x2AD7B1 67 #define MATROSKA_ID_DURATION 0x4489 68 #define MATROSKA_ID_TITLE 0x7BA9 69 #define MATROSKA_ID_WRITINGAPP 0x5741 70 #define MATROSKA_ID_MUXINGAPP 0x4D80 71 #define MATROSKA_ID_DATEUTC 0x4461 72 #define MATROSKA_ID_SEGMENTUID 0x73A4 73 74 /* ID in the tracks master */ 75 #define MATROSKA_ID_TRACKENTRY 0xAE 76 77 /* IDs in the trackentry master */ 78 #define MATROSKA_ID_TRACKNUMBER 0xD7 79 #define MATROSKA_ID_TRACKUID 0x73C5 80 #define MATROSKA_ID_TRACKTYPE 0x83 81 #define MATROSKA_ID_TRACKVIDEO 0xE0 82 #define MATROSKA_ID_TRACKAUDIO 0xE1 83 #define MATROSKA_ID_TRACKOPERATION 0xE2 84 #define MATROSKA_ID_TRACKCOMBINEPLANES 0xE3 85 #define MATROSKA_ID_TRACKPLANE 0xE4 86 #define MATROSKA_ID_TRACKPLANEUID 0xE5 87 #define MATROSKA_ID_TRACKPLANETYPE 0xE6 88 #define MATROSKA_ID_CODECID 0x86 89 #define MATROSKA_ID_CODECPRIVATE 0x63A2 90 #define MATROSKA_ID_CODECNAME 0x258688 91 #define MATROSKA_ID_CODECINFOURL 0x3B4040 92 #define MATROSKA_ID_CODECDOWNLOADURL 0x26B240 93 #define MATROSKA_ID_CODECDECODEALL 0xAA 94 #define MATROSKA_ID_CODECDELAY 0x56AA 95 #define MATROSKA_ID_SEEKPREROLL 0x56BB 96 #define MATROSKA_ID_TRACKNAME 0x536E 97 #define MATROSKA_ID_TRACKLANGUAGE 0x22B59C 98 #define MATROSKA_ID_TRACKFLAGENABLED 0xB9 99 #define MATROSKA_ID_TRACKFLAGDEFAULT 0x88 100 #define MATROSKA_ID_TRACKFLAGFORCED 0x55AA 101 #define MATROSKA_ID_TRACKFLAGLACING 0x9C 102 #define MATROSKA_ID_TRACKMINCACHE 0x6DE7 103 #define MATROSKA_ID_TRACKMAXCACHE 0x6DF8 104 #define MATROSKA_ID_TRACKDEFAULTDURATION 0x23E383 105 #define MATROSKA_ID_TRACKCONTENTENCODINGS 0x6D80 106 #define MATROSKA_ID_TRACKCONTENTENCODING 0x6240 107 #define MATROSKA_ID_TRACKTIMECODESCALE 0x23314F 108 #define MATROSKA_ID_TRACKMAXBLKADDID 0x55EE 109 110 /* IDs in the trackvideo master */ 111 #define MATROSKA_ID_VIDEOFRAMERATE 0x2383E3 112 #define MATROSKA_ID_VIDEODISPLAYWIDTH 0x54B0 113 #define MATROSKA_ID_VIDEODISPLAYHEIGHT 0x54BA 114 #define MATROSKA_ID_VIDEOPIXELWIDTH 0xB0 115 #define MATROSKA_ID_VIDEOPIXELHEIGHT 0xBA 116 #define MATROSKA_ID_VIDEOPIXELCROPB 0x54AA 117 #define MATROSKA_ID_VIDEOPIXELCROPT 0x54BB 118 #define MATROSKA_ID_VIDEOPIXELCROPL 0x54CC 119 #define MATROSKA_ID_VIDEOPIXELCROPR 0x54DD 120 #define MATROSKA_ID_VIDEODISPLAYUNIT 0x54B2 121 #define MATROSKA_ID_VIDEOFLAGINTERLACED 0x9A 122 #define MATROSKA_ID_VIDEOFIELDORDER 0x9D 123 #define MATROSKA_ID_VIDEOSTEREOMODE 0x53B8 124 #define MATROSKA_ID_VIDEOALPHAMODE 0x53C0 125 #define MATROSKA_ID_VIDEOASPECTRATIO 0x54B3 126 #define MATROSKA_ID_VIDEOCOLORSPACE 0x2EB524 127 #define MATROSKA_ID_VIDEOCOLOR 0x55B0 128 129 #define MATROSKA_ID_VIDEOCOLORMATRIXCOEFF 0x55B1 130 #define MATROSKA_ID_VIDEOCOLORBITSPERCHANNEL 0x55B2 131 #define MATROSKA_ID_VIDEOCOLORCHROMASUBHORZ 0x55B3 132 #define MATROSKA_ID_VIDEOCOLORCHROMASUBVERT 0x55B4 133 #define MATROSKA_ID_VIDEOCOLORCBSUBHORZ 0x55B5 134 #define MATROSKA_ID_VIDEOCOLORCBSUBVERT 0x55B6 135 #define MATROSKA_ID_VIDEOCOLORCHROMASITINGHORZ 0x55B7 136 #define MATROSKA_ID_VIDEOCOLORCHROMASITINGVERT 0x55B8 137 #define MATROSKA_ID_VIDEOCOLORRANGE 0x55B9 138 #define MATROSKA_ID_VIDEOCOLORTRANSFERCHARACTERISTICS 0x55BA 139 140 #define MATROSKA_ID_VIDEOCOLORPRIMARIES 0x55BB 141 #define MATROSKA_ID_VIDEOCOLORMAXCLL 0x55BC 142 #define MATROSKA_ID_VIDEOCOLORMAXFALL 0x55BD 143 144 #define MATROSKA_ID_VIDEOCOLORMASTERINGMETA 0x55D0 145 #define MATROSKA_ID_VIDEOCOLOR_RX 0x55D1 146 #define MATROSKA_ID_VIDEOCOLOR_RY 0x55D2 147 #define MATROSKA_ID_VIDEOCOLOR_GX 0x55D3 148 #define MATROSKA_ID_VIDEOCOLOR_GY 0x55D4 149 #define MATROSKA_ID_VIDEOCOLOR_BX 0x55D5 150 #define MATROSKA_ID_VIDEOCOLOR_BY 0x55D6 151 #define MATROSKA_ID_VIDEOCOLOR_WHITEX 0x55D7 152 #define MATROSKA_ID_VIDEOCOLOR_WHITEY 0x55D8 153 #define MATROSKA_ID_VIDEOCOLOR_LUMINANCEMAX 0x55D9 154 #define MATROSKA_ID_VIDEOCOLOR_LUMINANCEMIN 0x55DA 155 156 #define MATROSKA_ID_VIDEOPROJECTION 0x7670 157 #define MATROSKA_ID_VIDEOPROJECTIONTYPE 0x7671 158 #define MATROSKA_ID_VIDEOPROJECTIONPRIVATE 0x7672 159 #define MATROSKA_ID_VIDEOPROJECTIONPOSEYAW 0x7673 160 #define MATROSKA_ID_VIDEOPROJECTIONPOSEPITCH 0x7674 161 #define MATROSKA_ID_VIDEOPROJECTIONPOSEROLL 0x7675 162 163 /* IDs in the trackaudio master */ 164 #define MATROSKA_ID_AUDIOSAMPLINGFREQ 0xB5 165 #define MATROSKA_ID_AUDIOOUTSAMPLINGFREQ 0x78B5 166 167 #define MATROSKA_ID_AUDIOBITDEPTH 0x6264 168 #define MATROSKA_ID_AUDIOCHANNELS 0x9F 169 170 /* IDs in the content encoding master */ 171 #define MATROSKA_ID_ENCODINGORDER 0x5031 172 #define MATROSKA_ID_ENCODINGSCOPE 0x5032 173 #define MATROSKA_ID_ENCODINGTYPE 0x5033 174 #define MATROSKA_ID_ENCODINGCOMPRESSION 0x5034 175 #define MATROSKA_ID_ENCODINGCOMPALGO 0x4254 176 #define MATROSKA_ID_ENCODINGCOMPSETTINGS 0x4255 177 178 #define MATROSKA_ID_ENCODINGENCRYPTION 0x5035 179 #define MATROSKA_ID_ENCODINGENCAESSETTINGS 0x47E7 180 #define MATROSKA_ID_ENCODINGENCALGO 0x47E1 181 #define MATROSKA_ID_ENCODINGENCKEYID 0x47E2 182 #define MATROSKA_ID_ENCODINGSIGALGO 0x47E5 183 #define MATROSKA_ID_ENCODINGSIGHASHALGO 0x47E6 184 #define MATROSKA_ID_ENCODINGSIGKEYID 0x47E4 185 #define MATROSKA_ID_ENCODINGSIGNATURE 0x47E3 186 187 /* ID in the cues master */ 188 #define MATROSKA_ID_POINTENTRY 0xBB 189 190 /* IDs in the pointentry master */ 191 #define MATROSKA_ID_CUETIME 0xB3 192 #define MATROSKA_ID_CUETRACKPOSITION 0xB7 193 194 /* IDs in the cuetrackposition master */ 195 #define MATROSKA_ID_CUETRACK 0xF7 196 #define MATROSKA_ID_CUECLUSTERPOSITION 0xF1 197 #define MATROSKA_ID_CUERELATIVEPOSITION 0xF0 198 #define MATROSKA_ID_CUEDURATION 0xB2 199 #define MATROSKA_ID_CUEBLOCKNUMBER 0x5378 200 201 /* IDs in the tags master */ 202 #define MATROSKA_ID_TAG 0x7373 203 #define MATROSKA_ID_SIMPLETAG 0x67C8 204 #define MATROSKA_ID_TAGNAME 0x45A3 205 #define MATROSKA_ID_TAGSTRING 0x4487 206 #define MATROSKA_ID_TAGLANG 0x447A 207 #define MATROSKA_ID_TAGDEFAULT 0x4484 208 #define MATROSKA_ID_TAGDEFAULT_BUG 0x44B4 209 #define MATROSKA_ID_TAGTARGETS 0x63C0 210 #define MATROSKA_ID_TAGTARGETS_TYPE 0x63CA 211 #define MATROSKA_ID_TAGTARGETS_TYPEVALUE 0x68CA 212 #define MATROSKA_ID_TAGTARGETS_TRACKUID 0x63C5 213 #define MATROSKA_ID_TAGTARGETS_CHAPTERUID 0x63C4 214 #define MATROSKA_ID_TAGTARGETS_ATTACHUID 0x63C6 215 216 /* IDs in the seekhead master */ 217 #define MATROSKA_ID_SEEKENTRY 0x4DBB 218 219 /* IDs in the seekpoint master */ 220 #define MATROSKA_ID_SEEKID 0x53AB 221 #define MATROSKA_ID_SEEKPOSITION 0x53AC 222 223 /* IDs in the cluster master */ 224 #define MATROSKA_ID_CLUSTERTIMECODE 0xE7 225 #define MATROSKA_ID_CLUSTERPOSITION 0xA7 226 #define MATROSKA_ID_CLUSTERPREVSIZE 0xAB 227 #define MATROSKA_ID_BLOCKGROUP 0xA0 228 #define MATROSKA_ID_BLOCKADDITIONS 0x75A1 229 #define MATROSKA_ID_BLOCKMORE 0xA6 230 #define MATROSKA_ID_BLOCKADDID 0xEE 231 #define MATROSKA_ID_BLOCKADDITIONAL 0xA5 232 #define MATROSKA_ID_SIMPLEBLOCK 0xA3 233 234 /* IDs in the blockgroup master */ 235 #define MATROSKA_ID_BLOCK 0xA1 236 #define MATROSKA_ID_BLOCKDURATION 0x9B 237 #define MATROSKA_ID_BLOCKREFERENCE 0xFB 238 #define MATROSKA_ID_CODECSTATE 0xA4 239 #define MATROSKA_ID_DISCARDPADDING 0x75A2 240 241 /* IDs in the attachments master */ 242 #define MATROSKA_ID_ATTACHEDFILE 0x61A7 243 #define MATROSKA_ID_FILEDESC 0x467E 244 #define MATROSKA_ID_FILENAME 0x466E 245 #define MATROSKA_ID_FILEMIMETYPE 0x4660 246 #define MATROSKA_ID_FILEDATA 0x465C 247 #define MATROSKA_ID_FILEUID 0x46AE 248 249 /* IDs in the chapters master */ 250 #define MATROSKA_ID_EDITIONENTRY 0x45B9 251 #define MATROSKA_ID_CHAPTERATOM 0xB6 252 #define MATROSKA_ID_CHAPTERTIMESTART 0x91 253 #define MATROSKA_ID_CHAPTERTIMEEND 0x92 254 #define MATROSKA_ID_CHAPTERDISPLAY 0x80 255 #define MATROSKA_ID_CHAPSTRING 0x85 256 #define MATROSKA_ID_CHAPLANG 0x437C 257 #define MATROSKA_ID_CHAPCOUNTRY 0x437E 258 #define MATROSKA_ID_EDITIONUID 0x45BC 259 #define MATROSKA_ID_EDITIONFLAGHIDDEN 0x45BD 260 #define MATROSKA_ID_EDITIONFLAGDEFAULT 0x45DB 261 #define MATROSKA_ID_EDITIONFLAGORDERED 0x45DD 262 #define MATROSKA_ID_CHAPTERUID 0x73C4 263 #define MATROSKA_ID_CHAPTERFLAGHIDDEN 0x98 264 #define MATROSKA_ID_CHAPTERFLAGENABLED 0x4598 265 #define MATROSKA_ID_CHAPTERPHYSEQUIV 0x63C3 266 267 typedef enum { 268 MATROSKA_TRACK_TYPE_NONE = 0x0, 269 MATROSKA_TRACK_TYPE_VIDEO = 0x1, 270 MATROSKA_TRACK_TYPE_AUDIO = 0x2, 271 MATROSKA_TRACK_TYPE_COMPLEX = 0x3, 272 MATROSKA_TRACK_TYPE_LOGO = 0x10, 273 MATROSKA_TRACK_TYPE_SUBTITLE = 0x11, 274 MATROSKA_TRACK_TYPE_CONTROL = 0x20, 275 MATROSKA_TRACK_TYPE_METADATA = 0x21, 276 } MatroskaTrackType; 277 278 typedef enum { 279 MATROSKA_TRACK_ENCODING_COMP_ZLIB = 0, 280 MATROSKA_TRACK_ENCODING_COMP_BZLIB = 1, 281 MATROSKA_TRACK_ENCODING_COMP_LZO = 2, 282 MATROSKA_TRACK_ENCODING_COMP_HEADERSTRIP = 3, 283 } MatroskaTrackEncodingCompAlgo; 284 285 typedef enum { 286 MATROSKA_VIDEO_INTERLACE_FLAG_UNDETERMINED = 0, 287 MATROSKA_VIDEO_INTERLACE_FLAG_INTERLACED = 1, 288 MATROSKA_VIDEO_INTERLACE_FLAG_PROGRESSIVE = 2 289 } MatroskaVideoInterlaceFlag; 290 291 typedef enum { 292 MATROSKA_VIDEO_FIELDORDER_PROGRESSIVE = 0, 293 MATROSKA_VIDEO_FIELDORDER_UNDETERMINED = 2, 294 MATROSKA_VIDEO_FIELDORDER_TT = 1, 295 MATROSKA_VIDEO_FIELDORDER_BB = 6, 296 MATROSKA_VIDEO_FIELDORDER_TB = 9, 297 MATROSKA_VIDEO_FIELDORDER_BT = 14, 298 } MatroskaVideoFieldOrder; 299 300 typedef enum { 301 MATROSKA_VIDEO_STEREOMODE_TYPE_MONO = 0, 302 MATROSKA_VIDEO_STEREOMODE_TYPE_LEFT_RIGHT = 1, 303 MATROSKA_VIDEO_STEREOMODE_TYPE_BOTTOM_TOP = 2, 304 MATROSKA_VIDEO_STEREOMODE_TYPE_TOP_BOTTOM = 3, 305 MATROSKA_VIDEO_STEREOMODE_TYPE_CHECKERBOARD_RL = 4, 306 MATROSKA_VIDEO_STEREOMODE_TYPE_CHECKERBOARD_LR = 5, 307 MATROSKA_VIDEO_STEREOMODE_TYPE_ROW_INTERLEAVED_RL = 6, 308 MATROSKA_VIDEO_STEREOMODE_TYPE_ROW_INTERLEAVED_LR = 7, 309 MATROSKA_VIDEO_STEREOMODE_TYPE_COL_INTERLEAVED_RL = 8, 310 MATROSKA_VIDEO_STEREOMODE_TYPE_COL_INTERLEAVED_LR = 9, 311 MATROSKA_VIDEO_STEREOMODE_TYPE_ANAGLYPH_CYAN_RED = 10, 312 MATROSKA_VIDEO_STEREOMODE_TYPE_RIGHT_LEFT = 11, 313 MATROSKA_VIDEO_STEREOMODE_TYPE_ANAGLYPH_GREEN_MAG = 12, 314 MATROSKA_VIDEO_STEREOMODE_TYPE_BOTH_EYES_BLOCK_LR = 13, 315 MATROSKA_VIDEO_STEREOMODE_TYPE_BOTH_EYES_BLOCK_RL = 14, 316 MATROSKA_VIDEO_STEREOMODE_TYPE_NB, 317 } MatroskaVideoStereoModeType; 318 319 typedef enum { 320 MATROSKA_VIDEO_DISPLAYUNIT_PIXELS = 0, 321 MATROSKA_VIDEO_DISPLAYUNIT_CENTIMETERS = 1, 322 MATROSKA_VIDEO_DISPLAYUNIT_INCHES = 2, 323 MATROSKA_VIDEO_DISPLAYUNIT_DAR = 3, 324 MATROSKA_VIDEO_DISPLAYUNIT_UNKNOWN = 4, 325 } MatroskaVideoDisplayUnit; 326 327 typedef enum { 328 MATROSKA_COLOUR_CHROMASITINGHORZ_UNDETERMINED = 0, 329 MATROSKA_COLOUR_CHROMASITINGHORZ_LEFT = 1, 330 MATROSKA_COLOUR_CHROMASITINGHORZ_HALF = 2, 331 MATROSKA_COLOUR_CHROMASITINGHORZ_NB 332 } MatroskaColourChromaSitingHorz; 333 334 typedef enum { 335 MATROSKA_COLOUR_CHROMASITINGVERT_UNDETERMINED = 0, 336 MATROSKA_COLOUR_CHROMASITINGVERT_TOP = 1, 337 MATROSKA_COLOUR_CHROMASITINGVERT_HALF = 2, 338 MATROSKA_COLOUR_CHROMASITINGVERT_NB 339 } MatroskaColourChromaSitingVert; 340 341 typedef enum { 342 MATROSKA_VIDEO_PROJECTION_TYPE_RECTANGULAR = 0, 343 MATROSKA_VIDEO_PROJECTION_TYPE_EQUIRECTANGULAR = 1, 344 MATROSKA_VIDEO_PROJECTION_TYPE_CUBEMAP = 2, 345 MATROSKA_VIDEO_PROJECTION_TYPE_MESH = 3, 346 } MatroskaVideoProjectionType; 347 348 /* 349 * Matroska Codec IDs, strings 350 */ 351 352 typedef struct CodecTags{ 353 char str[22]; 354 enum AVCodecID id; 355 }CodecTags; 356 357 /* max. depth in the EBML tree structure */ 358 #define EBML_MAX_DEPTH 16 359 360 #define MATROSKA_VIDEO_STEREO_PLANE_COUNT 3 361 362 extern const CodecTags ff_mkv_codec_tags[]; 363 extern const CodecTags ff_webm_codec_tags[]; 364 extern const CodecMime ff_mkv_mime_tags[]; 365 extern const CodecMime ff_mkv_image_mime_tags[]; 366 extern const AVMetadataConv ff_mkv_metadata_conv[]; 367 extern const char * const ff_matroska_video_stereo_mode[MATROSKA_VIDEO_STEREOMODE_TYPE_NB]; 368 extern const char * const ff_matroska_video_stereo_plane[MATROSKA_VIDEO_STEREO_PLANE_COUNT]; 369 370 /* AVStream Metadata tag keys for WebM Dash Manifest */ 371 #define INITIALIZATION_RANGE "webm_dash_manifest_initialization_range" 372 #define CUES_START "webm_dash_manifest_cues_start" 373 #define CUES_END "webm_dash_manifest_cues_end" 374 #define FILENAME "webm_dash_manifest_file_name" 375 #define BANDWIDTH "webm_dash_manifest_bandwidth" 376 #define DURATION "webm_dash_manifest_duration" 377 #define CLUSTER_KEYFRAME "webm_dash_manifest_cluster_keyframe" 378 #define CUE_TIMESTAMPS "webm_dash_manifest_cue_timestamps" 379 #define TRACK_NUMBER "webm_dash_manifest_track_number" 380 #define CODEC_PRIVATE_SIZE "webm_dash_manifest_codec_priv_size" 381 382 int ff_mkv_stereo3d_conv(AVStream *st, MatroskaVideoStereoModeType stereo_mode); 383 384 #endif /* AVFORMAT_MATROSKA_H */ 385