gst/matroska/matroska-ids.h

   1 /* GStreamer Matroska muxer/demuxer
   2  * (c) 2003 Ronald Bultje <rbultje@ronald.bitfreak.net>
   3  *
   4  * matroska-ids.h: matroska file/stream data IDs
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  19  * Boston, MA 02110-1301, USA.
  20  */
  21
  22 #ifndef __GST_MATROSKA_IDS_H__
  23 #define __GST_MATROSKA_IDS_H__
  24
  25 #include <gst/gst.h>
  26 #include <gst/video/video-info.h>
  27
  28 #include "ebml-ids.h"
  29
  30 /*
  31  * EBML DocType.
  32  */
  33
  34 #define GST_MATROSKA_DOCTYPE_MATROSKA              "matroska"
  35 #define GST_MATROSKA_DOCTYPE_WEBM                  "webm"
  36
  37 /*
  38  * Matroska element IDs. max. 32-bit.
  39  */
  40
  41 /* toplevel Segment */
  42 #define GST_MATROSKA_ID_SEGMENT                    0x18538067
  43
  44 /* matroska top-level master IDs, childs of Segment */
  45 #define GST_MATROSKA_ID_SEGMENTINFO                0x1549A966
  46 #define GST_MATROSKA_ID_TRACKS                     0x1654AE6B
  47 #define GST_MATROSKA_ID_CUES                       0x1C53BB6B
  48 #define GST_MATROSKA_ID_TAGS                       0x1254C367
  49 #define GST_MATROSKA_ID_SEEKHEAD                   0x114D9B74
  50 #define GST_MATROSKA_ID_CLUSTER                    0x1F43B675
  51 #define GST_MATROSKA_ID_ATTACHMENTS                0x1941A469
  52 #define GST_MATROSKA_ID_CHAPTERS                   0x1043A770
  53
  54 /* IDs in the SegmentInfo master */
  55 #define GST_MATROSKA_ID_TIMECODESCALE              0x2AD7B1
  56 #define GST_MATROSKA_ID_DURATION                   0x4489
  57 #define GST_MATROSKA_ID_WRITINGAPP                 0x5741
  58 #define GST_MATROSKA_ID_MUXINGAPP                  0x4D80
  59 #define GST_MATROSKA_ID_DATEUTC                    0x4461
  60 #define GST_MATROSKA_ID_SEGMENTUID                 0x73A4
  61 #define GST_MATROSKA_ID_SEGMENTFILENAME            0x7384
  62 #define GST_MATROSKA_ID_PREVUID                    0x3CB923
  63 #define GST_MATROSKA_ID_PREVFILENAME               0x3C83AB
  64 #define GST_MATROSKA_ID_NEXTUID                    0x3EB923
  65 #define GST_MATROSKA_ID_NEXTFILENAME               0x3E83BB
  66 #define GST_MATROSKA_ID_TITLE                      0x7BA9
  67 #define GST_MATROSKA_ID_SEGMENTFAMILY              0x4444
  68 #define GST_MATROSKA_ID_CHAPTERTRANSLATE           0x6924
  69
  70 /* IDs in the ChapterTranslate master */
  71 #define GST_MATROSKA_ID_CHAPTERTRANSLATEEDITIONUID 0x69FC
  72 #define GST_MATROSKA_ID_CHAPTERTRANSLATECODEC      0x69BF
  73 #define GST_MATROSKA_ID_CHAPTERTRANSLATEID         0x69A5
  74
  75 /* ID in the Tracks master */
  76 #define GST_MATROSKA_ID_TRACKENTRY                 0xAE
  77
  78 /* IDs in the TrackEntry master */
  79 #define GST_MATROSKA_ID_TRACKNUMBER                0xD7
  80 #define GST_MATROSKA_ID_TRACKUID                   0x73C5
  81 #define GST_MATROSKA_ID_TRACKTYPE                  0x83
  82 #define GST_MATROSKA_ID_TRACKAUDIO                 0xE1
  83 #define GST_MATROSKA_ID_TRACKVIDEO                 0xE0
  84 #define GST_MATROSKA_ID_CONTENTENCODINGS           0x6D80
  85 #define GST_MATROSKA_ID_CODECID                    0x86
  86 #define GST_MATROSKA_ID_CODECPRIVATE               0x63A2
  87 #define GST_MATROSKA_ID_CODECNAME                  0x258688
  88 #define GST_MATROSKA_ID_TRACKNAME                  0x536E
  89 #define GST_MATROSKA_ID_TRACKLANGUAGE              0x22B59C
  90 #define GST_MATROSKA_ID_TRACKFLAGENABLED           0xB9
  91 #define GST_MATROSKA_ID_TRACKFLAGDEFAULT           0x88
  92 #define GST_MATROSKA_ID_TRACKFLAGFORCED            0x55AA
  93 #define GST_MATROSKA_ID_TRACKFLAGLACING            0x9C
  94 #define GST_MATROSKA_ID_TRACKMINCACHE              0x6DE7
  95 #define GST_MATROSKA_ID_TRACKMAXCACHE              0x6DF8
  96 #define GST_MATROSKA_ID_TRACKDEFAULTDURATION       0x23E383
  97 #define GST_MATROSKA_ID_TRACKTIMECODESCALE         0x23314F
  98 #define GST_MATROSKA_ID_MAXBLOCKADDITIONID         0x55EE
  99 #define GST_MATROSKA_ID_TRACKATTACHMENTLINK        0x7446
 100 #define GST_MATROSKA_ID_TRACKOVERLAY               0x6FAB
 101 #define GST_MATROSKA_ID_TRACKTRANSLATE             0x6624
 102 /* semi-draft */
 103 #define GST_MATROSKA_ID_TRACKOFFSET                0x537F
 104 /* semi-draft */
 105 #define GST_MATROSKA_ID_CODECSETTINGS              0x3A9697
 106 /* semi-draft */
 107 #define GST_MATROSKA_ID_CODECINFOURL               0x3B4040
 108 /* semi-draft */
 109 #define GST_MATROSKA_ID_CODECDOWNLOADURL           0x26B240
 110 /* semi-draft */
 111 #define GST_MATROSKA_ID_CODECDECODEALL             0xAA
 112 #define GST_MATROSKA_ID_SEEKPREROLL                0x56BB
 113 #define GST_MATROSKA_ID_CODECDELAY                 0x56AA
 114
 115 /* IDs in the TrackTranslate master */
 116 #define GST_MATROSKA_ID_TRACKTRANSLATEEDITIONUID   0x66FC
 117 #define GST_MATROSKA_ID_TRACKTRANSLATECODEC        0x66BF
 118 #define GST_MATROSKA_ID_TRACKTRANSLATETRACKID      0x66A5
 119
 120
 121 /* IDs in the TrackVideo master */
 122 /* NOTE: This one is here only for backward compatibility.
 123  * Use _TRACKDEFAULDURATION */
 124 #define GST_MATROSKA_ID_VIDEOFRAMERATE             0x2383E3
 125 #define GST_MATROSKA_ID_VIDEODISPLAYWIDTH          0x54B0
 126 #define GST_MATROSKA_ID_VIDEODISPLAYHEIGHT         0x54BA
 127 #define GST_MATROSKA_ID_VIDEODISPLAYUNIT           0x54B2
 128 #define GST_MATROSKA_ID_VIDEOPIXELWIDTH            0xB0
 129 #define GST_MATROSKA_ID_VIDEOPIXELHEIGHT           0xBA
 130 #define GST_MATROSKA_ID_VIDEOPIXELCROPBOTTOM       0x54AA
 131 #define GST_MATROSKA_ID_VIDEOPIXELCROPTOP          0x54BB
 132 #define GST_MATROSKA_ID_VIDEOPIXELCROPLEFT         0x54CC
 133 #define GST_MATROSKA_ID_VIDEOPIXELCROPRIGHT        0x54DD
 134 #define GST_MATROSKA_ID_VIDEOFLAGINTERLACED        0x9A
 135 /* semi-draft */
 136 #define GST_MATROSKA_ID_VIDEOSTEREOMODE            0x53B8
 137 #define GST_MATROSKA_ID_VIDEOASPECTRATIOTYPE       0x54B3
 138 #define GST_MATROSKA_ID_VIDEOCOLOURSPACE           0x2EB524
 139 /* semi-draft */
 140 #define GST_MATROSKA_ID_VIDEOGAMMAVALUE            0x2FB523
 141
 142 /* IDs in the TrackAudio master */
 143 #define GST_MATROSKA_ID_AUDIOSAMPLINGFREQ          0xB5
 144 #define GST_MATROSKA_ID_AUDIOBITDEPTH              0x6264
 145 #define GST_MATROSKA_ID_AUDIOCHANNELS              0x9F
 146 /* semi-draft */
 147 #define GST_MATROSKA_ID_AUDIOCHANNELPOSITIONS      0x7D7B
 148 #define GST_MATROSKA_ID_AUDIOOUTPUTSAMPLINGFREQ    0x78B5
 149
 150 /* IDs in the TrackContentEncoding master */
 151 #define GST_MATROSKA_ID_CONTENTENCODING            0x6240
 152
 153 /* IDs in the ContentEncoding master */
 154 #define GST_MATROSKA_ID_CONTENTENCODINGORDER       0x5031
 155 #define GST_MATROSKA_ID_CONTENTENCODINGSCOPE       0x5032
 156 #define GST_MATROSKA_ID_CONTENTENCODINGTYPE        0x5033
 157 #define GST_MATROSKA_ID_CONTENTCOMPRESSION         0x5034
 158 #define GST_MATROSKA_ID_CONTENTENCRYPTION          0x5035
 159
 160 /* IDs in the ContentCompression master */
 161 #define GST_MATROSKA_ID_CONTENTCOMPALGO            0x4254
 162 #define GST_MATROSKA_ID_CONTENTCOMPSETTINGS        0x4255
 163
 164 /* IDs in the ContentEncryption master */
 165 #define GST_MATROSKA_ID_CONTENTENCALGO             0x47E1
 166 #define GST_MATROSKA_ID_CONTENTENCKEYID            0x47E2
 167 #define GST_MATROSKA_ID_CONTENTSIGNATURE           0x47E3
 168 #define GST_MATROSKA_ID_CONTENTSIGKEYID            0x47E4
 169 #define GST_MATROSKA_ID_CONTENTSIGALGO             0x47E5
 170 #define GST_MATROSKA_ID_CONTENTSIGHASHALGO         0x47E6
 171
 172 /* ID in the CUEs master */
 173 #define GST_MATROSKA_ID_POINTENTRY                 0xBB
 174
 175 /* IDs in the pointentry master */
 176 #define GST_MATROSKA_ID_CUETIME                    0xB3
 177 #define GST_MATROSKA_ID_CUETRACKPOSITIONS          0xB7
 178
 179 /* IDs in the CueTrackPositions master */
 180 #define GST_MATROSKA_ID_CUETRACK                   0xF7
 181 #define GST_MATROSKA_ID_CUECLUSTERPOSITION         0xF1
 182 #define GST_MATROSKA_ID_CUEBLOCKNUMBER             0x5378
 183 /* semi-draft */
 184 #define GST_MATROSKA_ID_CUECODECSTATE              0xEA
 185 /* semi-draft */
 186 #define GST_MATROSKA_ID_CUEREFERENCE               0xDB
 187
 188 /* IDs in the CueReference master */
 189 /* semi-draft */
 190 #define GST_MATROSKA_ID_CUEREFTIME                 0x96
 191 /* semi-draft */
 192 #define GST_MATROSKA_ID_CUEREFCLUSTER              0x97
 193 /* semi-draft */
 194 #define GST_MATROSKA_ID_CUEREFNUMBER               0x535F
 195 /* semi-draft */
 196 #define GST_MATROSKA_ID_CUEREFCODECSTATE           0xEB
 197
 198 /* IDs in the Tags master */
 199 #define GST_MATROSKA_ID_TAG                        0x7373
 200
 201 /* in the Tag master */
 202 #define GST_MATROSKA_ID_SIMPLETAG                  0x67C8
 203 #define GST_MATROSKA_ID_TARGETS                    0x63C0
 204
 205 /* in the SimpleTag master */
 206 #define GST_MATROSKA_ID_TAGNAME                    0x45A3
 207 #define GST_MATROSKA_ID_TAGSTRING                  0x4487
 208 #define GST_MATROSKA_ID_TAGLANGUAGE                0x447A
 209 #define GST_MATROSKA_ID_TAGDEFAULT                 0x4484
 210 #define GST_MATROSKA_ID_TAGBINARY                  0x4485
 211
 212 /* in the Targets master */
 213 #define GST_MATROSKA_ID_TARGETTYPEVALUE            0x68CA
 214 #define GST_MATROSKA_ID_TARGETTYPE                 0x63CA
 215 #define GST_MATROSKA_ID_TARGETTRACKUID             0x63C5
 216 #define GST_MATROSKA_ID_TARGETEDITIONUID           0x63C9
 217 #define GST_MATROSKA_ID_TARGETCHAPTERUID           0x63C4
 218 #define GST_MATROSKA_ID_TARGETATTACHMENTUID        0x63C6
 219
 220 /* IDs in the SeekHead master */
 221 #define GST_MATROSKA_ID_SEEKENTRY                  0x4DBB
 222
 223 /* IDs in the SeekEntry master */
 224 #define GST_MATROSKA_ID_SEEKID                     0x53AB
 225 #define GST_MATROSKA_ID_SEEKPOSITION               0x53AC
 226
 227 /* IDs in the Cluster master */
 228 #define GST_MATROSKA_ID_CLUSTERTIMECODE            0xE7
 229 #define GST_MATROSKA_ID_BLOCKGROUP                 0xA0
 230 #define GST_MATROSKA_ID_SIMPLEBLOCK                0xA3
 231 #define GST_MATROSKA_ID_REFERENCEBLOCK             0xFB
 232 #define GST_MATROSKA_ID_POSITION                   0xA7
 233 #define GST_MATROSKA_ID_PREVSIZE                   0xAB
 234 /* semi-draft */
 235 #define GST_MATROSKA_ID_ENCRYPTEDBLOCK             0xAF
 236 #define GST_MATROSKA_ID_SILENTTRACKS               0x5854
 237
 238 /* IDs in the SilentTracks master */
 239 #define GST_MATROSKA_ID_SILENTTRACKNUMBER          0x58D7
 240
 241 /* IDs in the BlockGroup master */
 242 #define GST_MATROSKA_ID_BLOCK                      0xA1
 243 #define GST_MATROSKA_ID_BLOCKDURATION              0x9B
 244 /* semi-draft */
 245 #define GST_MATROSKA_ID_BLOCKVIRTUAL               0xA2
 246 #define GST_MATROSKA_ID_REFERENCEBLOCK             0xFB
 247 #define GST_MATROSKA_ID_BLOCKADDITIONS             0x75A1
 248 #define GST_MATROSKA_ID_REFERENCEPRIORITY          0xFA
 249 /* semi-draft */
 250 #define GST_MATROSKA_ID_REFERENCEVIRTUAL           0xFD
 251 /* semi-draft */
 252 #define GST_MATROSKA_ID_CODECSTATE                 0xA4
 253 #define GST_MATROSKA_ID_SLICES                     0x8E
 254 #define GST_MATROSKA_ID_DISCARDPADDING             0x75A2
 255
 256 /* IDs in the BlockAdditions master */
 257 #define GST_MATROSKA_ID_BLOCKMORE                  0xA6
 258
 259 /* IDs in the BlockMore master */
 260 #define GST_MATROSKA_ID_BLOCKADDID                 0xEE
 261 #define GST_MATROSKA_ID_BLOCKADDITIONAL            0xA5
 262
 263 /* IDs in the Slices master */
 264 #define GST_MATROSKA_ID_TIMESLICE                  0xE8
 265
 266 /* IDs in the TimeSlice master */
 267 #define GST_MATROSKA_ID_LACENUMBER                 0xCC
 268 /* semi-draft */
 269 #define GST_MATROSKA_ID_FRAMENUMBER                0xCD
 270 /* semi-draft */
 271 #define GST_MATROSKA_ID_BLOCKADDITIONID            0xCB
 272 /* semi-draft */
 273 #define GST_MATROSKA_ID_TIMESLICEDELAY             0xCE
 274 #define GST_MATROSKA_ID_TIMESLICEDURATION          0xCF
 275
 276 /* IDs in the Attachments master */
 277 #define GST_MATROSKA_ID_ATTACHEDFILE               0x61A7
 278
 279 /* IDs in the AttachedFile master */
 280 #define GST_MATROSKA_ID_FILEDESCRIPTION            0x467E
 281 #define GST_MATROSKA_ID_FILENAME                   0x466E
 282 #define GST_MATROSKA_ID_FILEMIMETYPE               0x4660
 283 #define GST_MATROSKA_ID_FILEDATA                   0x465C
 284 #define GST_MATROSKA_ID_FILEUID                    0x46AE
 285 /* semi-draft */
 286 #define GST_MATROSKA_ID_FILEREFERRAL               0x4675
 287
 288 /* IDs in the Chapters master */
 289 #define GST_MATROSKA_ID_EDITIONENTRY               0x45B9
 290
 291 /* IDs in the EditionEntry master */
 292 #define GST_MATROSKA_ID_EDITIONUID                 0x45BC
 293 #define GST_MATROSKA_ID_EDITIONFLAGHIDDEN          0x45BD
 294 #define GST_MATROSKA_ID_EDITIONFLAGDEFAULT         0x45DB
 295 #define GST_MATROSKA_ID_EDITIONFLAGORDERED         0x45DD
 296 #define GST_MATROSKA_ID_CHAPTERATOM                0xB6
 297
 298 /* IDs in the ChapterAtom master */
 299 #define GST_MATROSKA_ID_CHAPTERUID                 0x73C4
 300 #define GST_MATROSKA_ID_CHAPTERTIMESTART           0x91
 301 #define GST_MATROSKA_ID_CHAPTERTIMESTOP            0x92
 302 #define GST_MATROSKA_ID_CHAPTERFLAGHIDDEN          0x98
 303 #define GST_MATROSKA_ID_CHAPTERFLAGENABLED         0x4598
 304 #define GST_MATROSKA_ID_CHAPTERSEGMENTUID          0x6E67
 305 #define GST_MATROSKA_ID_CHAPTERSEGMENTEDITIONUID   0x6EBC
 306 #define GST_MATROSKA_ID_CHAPTERPHYSICALEQUIV       0x63C3
 307 #define GST_MATROSKA_ID_CHAPTERTRACK               0x8F
 308 #define GST_MATROSKA_ID_CHAPTERDISPLAY             0x80
 309 #define GST_MATROSKA_ID_CHAPPROCESS                0x6944
 310
 311 /* IDs in the ChapProcess master */
 312 #define GST_MATROSKA_ID_CHAPPROCESSCODECID         0x6955
 313 #define GST_MATROSKA_ID_CHAPPROCESSPRIVATE         0x450D
 314 #define GST_MATROSKA_ID_CHAPPROCESSCOMMAND         0x6911
 315
 316 /* IDs in the ChapProcessCommand master */
 317 #define GST_MATROSKA_ID_CHAPPROCESSTIME            0x6922
 318 #define GST_MATROSKA_ID_CHAPPROCESSDATA            0x6933
 319
 320 /* IDs in the ChapterDisplay master */
 321 #define GST_MATROSKA_ID_CHAPSTRING                 0x85
 322 #define GST_MATROSKA_ID_CHAPLANGUAGE               0x437C
 323 #define GST_MATROSKA_ID_CHAPCOUNTRY                0x437E
 324
 325 /* IDs in the ChapterTrack master */
 326 #define GST_MATROSKA_ID_CHAPTERTRACKNUMBER         0x89
 327
 328 /*
 329  * Matroska Codec IDs. Strings.
 330  */
 331
 332 #define GST_MATROSKA_CODEC_ID_VIDEO_VFW_FOURCC   "V_MS/VFW/FOURCC"
 333 #define GST_MATROSKA_CODEC_ID_VIDEO_UNCOMPRESSED "V_UNCOMPRESSED"
 334 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEG4_SP     "V_MPEG4/ISO/SP"
 335 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEG4_ASP    "V_MPEG4/ISO/ASP"
 336 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEG4_AP     "V_MPEG4/ISO/AP"
 337 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEG4_AVC    "V_MPEG4/ISO/AVC"
 338 #define GST_MATROSKA_CODEC_ID_VIDEO_MSMPEG4V3    "V_MPEG4/MS/V3"
 339 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEG1        "V_MPEG1"
 340 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEG2        "V_MPEG2"
 341 /* FIXME: not (yet) in the spec! */
 342 #define GST_MATROSKA_CODEC_ID_VIDEO_MJPEG        "V_MJPEG"
 343 #define GST_MATROSKA_CODEC_ID_VIDEO_REALVIDEO1   "V_REAL/RV10"
 344 #define GST_MATROSKA_CODEC_ID_VIDEO_REALVIDEO2   "V_REAL/RV20"
 345 #define GST_MATROSKA_CODEC_ID_VIDEO_REALVIDEO3   "V_REAL/RV30"
 346 #define GST_MATROSKA_CODEC_ID_VIDEO_REALVIDEO4   "V_REAL/RV40"
 347 #define GST_MATROSKA_CODEC_ID_VIDEO_THEORA       "V_THEORA"
 348 #define GST_MATROSKA_CODEC_ID_VIDEO_QUICKTIME    "V_QUICKTIME"
 349 #define GST_MATROSKA_CODEC_ID_VIDEO_SNOW         "V_SNOW"
 350 #define GST_MATROSKA_CODEC_ID_VIDEO_DIRAC        "V_DIRAC"
 351 #define GST_MATROSKA_CODEC_ID_VIDEO_VP8          "V_VP8"
 352 #define GST_MATROSKA_CODEC_ID_VIDEO_VP9          "V_VP9"
 353 #define GST_MATROSKA_CODEC_ID_VIDEO_MPEGH_HEVC   "V_MPEGH/ISO/HEVC"
 354 #define GST_MATROSKA_CODEC_ID_VIDEO_PRORES       "V_PRORES"
 355
 356 #define GST_MATROSKA_CODEC_ID_AUDIO_MPEG1_L1       "A_MPEG/L1"
 357 #define GST_MATROSKA_CODEC_ID_AUDIO_MPEG1_L2       "A_MPEG/L2"
 358 #define GST_MATROSKA_CODEC_ID_AUDIO_MPEG1_L3       "A_MPEG/L3"
 359 #define GST_MATROSKA_CODEC_ID_AUDIO_PCM_INT_BE     "A_PCM/INT/BIG"
 360 #define GST_MATROSKA_CODEC_ID_AUDIO_PCM_INT_LE     "A_PCM/INT/LIT"
 361 #define GST_MATROSKA_CODEC_ID_AUDIO_PCM_FLOAT      "A_PCM/FLOAT/IEEE"
 362 #define GST_MATROSKA_CODEC_ID_AUDIO_AC3            "A_AC3"
 363 #define GST_MATROSKA_CODEC_ID_AUDIO_AC3_BSID9      "A_AC3/BSID9"
 364 #define GST_MATROSKA_CODEC_ID_AUDIO_AC3_BSID10     "A_AC3/BSID10"
 365 #define GST_MATROSKA_CODEC_ID_AUDIO_EAC3           "A_EAC3"
 366 #define GST_MATROSKA_CODEC_ID_AUDIO_TRUEHD         "A_TRUEHD"
 367 #define GST_MATROSKA_CODEC_ID_AUDIO_DTS            "A_DTS"
 368 #define GST_MATROSKA_CODEC_ID_AUDIO_VORBIS         "A_VORBIS"
 369 #define GST_MATROSKA_CODEC_ID_AUDIO_FLAC           "A_FLAC"
 370 /* FIXME: not yet in the spec */
 371 #define GST_MATROSKA_CODEC_ID_AUDIO_SPEEX          "A_SPEEX"
 372 #define GST_MATROSKA_CODEC_ID_AUDIO_ACM            "A_MS/ACM"
 373 #define GST_MATROSKA_CODEC_ID_AUDIO_TTA            "A_TTA1"
 374 #define GST_MATROSKA_CODEC_ID_AUDIO_WAVPACK4       "A_WAVPACK4"
 375 #define GST_MATROSKA_CODEC_ID_AUDIO_REAL_14_4      "A_REAL/14_4"
 376 #define GST_MATROSKA_CODEC_ID_AUDIO_REAL_28_8      "A_REAL/28_8"
 377 #define GST_MATROSKA_CODEC_ID_AUDIO_REAL_COOK      "A_REAL/COOK"
 378 #define GST_MATROSKA_CODEC_ID_AUDIO_REAL_SIPR      "A_REAL/SIPR"
 379 #define GST_MATROSKA_CODEC_ID_AUDIO_REAL_RALF      "A_REAL/RALF"
 380 #define GST_MATROSKA_CODEC_ID_AUDIO_REAL_ATRC      "A_REAL/ATRC"
 381 #define GST_MATROSKA_CODEC_ID_AUDIO_AAC            "A_AAC"
 382 #define GST_MATROSKA_CODEC_ID_AUDIO_AAC_MPEG2      "A_AAC/MPEG2/"
 383 #define GST_MATROSKA_CODEC_ID_AUDIO_AAC_MPEG4      "A_AAC/MPEG4/"
 384 #define GST_MATROSKA_CODEC_ID_AUDIO_QUICKTIME_QDMC "A_QUICKTIME/QDMC"
 385 #define GST_MATROSKA_CODEC_ID_AUDIO_QUICKTIME_QDM2 "A_QUICKTIME/QDM2"
 386 #define GST_MATROSKA_CODEC_ID_AUDIO_OPUS           "A_OPUS"
 387 /* Undefined for now:
 388 #define GST_MATROSKA_CODEC_ID_AUDIO_MPC            "A_MPC"
 389 */
 390
 391 #define GST_MATROSKA_CODEC_ID_SUBTITLE_ASCII     "S_TEXT/ASCII"
 392 #define GST_MATROSKA_CODEC_ID_SUBTITLE_UTF8      "S_TEXT/UTF8"
 393 #define GST_MATROSKA_CODEC_ID_SUBTITLE_SSA       "S_TEXT/SSA"
 394 #define GST_MATROSKA_CODEC_ID_SUBTITLE_ASS       "S_TEXT/ASS"
 395 #define GST_MATROSKA_CODEC_ID_SUBTITLE_USF       "S_TEXT/USF"
 396 #define GST_MATROSKA_CODEC_ID_SUBTITLE_VOBSUB    "S_VOBSUB"
 397 #define GST_MATROSKA_CODEC_ID_SUBTITLE_HDMVPGS   "S_HDMV/PGS"
 398 #define GST_MATROSKA_CODEC_ID_SUBTITLE_BMP       "S_IMAGE/BMP"
 399 #define GST_MATROSKA_CODEC_ID_SUBTITLE_KATE      "S_KATE"
 400
 401 /*
 402  * Matroska tags. Strings.
 403  */
 404
 405 #define GST_MATROSKA_TAG_ID_TITLE    "TITLE"
 406 #define GST_MATROSKA_TAG_ID_AUTHOR   "AUTHOR"
 407 #define GST_MATROSKA_TAG_ID_ARTIST   "ARTIST"
 408 #define GST_MATROSKA_TAG_ID_ALBUM    "ALBUM"
 409 #define GST_MATROSKA_TAG_ID_COMMENTS "COMMENTS"
 410 #define GST_MATROSKA_TAG_ID_COMMENT  "COMMENT"
 411 #define GST_MATROSKA_TAG_ID_BITSPS   "BITSPS"
 412 #define GST_MATROSKA_TAG_ID_BPS      "BPS"
 413 #define GST_MATROSKA_TAG_ID_ENCODER  "ENCODER"
 414 #define GST_MATROSKA_TAG_ID_ISRC     "ISRC"
 415 #define GST_MATROSKA_TAG_ID_COPYRIGHT "COPYRIGHT"
 416 #define GST_MATROSKA_TAG_ID_BPM       "BPM"
 417 #define GST_MATROSKA_TAG_ID_TERMS_OF_USE "TERMS_OF_USE"
 418 #define GST_MATROSKA_TAG_ID_DATE      "DATE"
 419 #define GST_MATROSKA_TAG_ID_COMPOSER  "COMPOSER"
 420 #define GST_MATROSKA_TAG_ID_LEAD_PERFORMER  "LEAD_PERFOMER"
 421 #define GST_MATROSKA_TAG_ID_GENRE     "GENRE"
 422 #define GST_MATROSKA_TAG_ID_TOTAL_PARTS "TOTAL_PARTS"
 423 #define GST_MATROSKA_TAG_ID_PART_NUMBER "PART_NUMBER"
 424 #define GST_MATROSKA_TAG_ID_SUBTITLE "SUBTITLE"
 425 #define GST_MATROSKA_TAG_ID_ACCOMPANIMENT "ACCOMPANIMENT"
 426 #define GST_MATROSKA_TAG_ID_LYRICS "LYRICS"
 427 #define GST_MATROSKA_TAG_ID_CONDUCTOR "CONDUCTOR"
 428 #define GST_MATROSKA_TAG_ID_ENCODED_BY "ENCODED_BY"
 429 #define GST_MATROSKA_TAG_ID_DESCRIPTION "DESCRIPTION"
 430 #define GST_MATROSKA_TAG_ID_KEYWORDS "KEYWORDS"
 431 #define GST_MATROSKA_TAG_ID_DATE_RELEASED "DATE_RELEASED"
 432 #define GST_MATROSKA_TAG_ID_DATE_RECORDED "DATE_RECORDED"
 433 #define GST_MATROSKA_TAG_ID_DATE_ENCODED "DATE_ENCODED"
 434 #define GST_MATROSKA_TAG_ID_DATE_TAGGED "DATE_TAGGED"
 435 #define GST_MATROSKA_TAG_ID_DATE_DIGITIZED "DATE_DIGITIZED"
 436 #define GST_MATROSKA_TAG_ID_DATE_WRITTEN "DATE_WRITTEN"
 437 #define GST_MATROSKA_TAG_ID_DATE_PURCHASED "DATE_PURCHASED"
 438 #define GST_MATROSKA_TAG_ID_RECORDING_LOCATION "RECORDING_LOCATION"
 439 #define GST_MATROSKA_TAG_ID_PRODUCTION_COPYRIGHT "PRODUCTION_COPYRIGHT"
 440 #define GST_MATROSKA_TAG_ID_LICENSE "LICENSE"
 441
 442 /*
 443  * TODO: add this tag & mappings
 444  * "REPLAYGAIN_GAIN" -> GST_TAG_*_GAIN   see http://replaygain.hydrogenaudio.org/rg_data_format.html
 445  * "REPLAYGAIN_PEAK" -> GST_TAG_*_PEAK   see http://replaygain.hydrogenaudio.org/peak_data_format.html
 446  * both are depending on the target (track, album?)
 447  *
 448  * "TOTAL_PARTS" -> GST_TAG_TRACK_COUNT    depending on target
 449  * "PART_NUMBER" -> GST_TAG_TRACK_NUMBER   depending on target
 450  *
 451  * "SORT_WITH" -> nested in other elements, GST_TAG_TITLE_SORTNAME, etc
 452  *
 453  * TODO: maybe add custom gstreamer tags for other standard matroska tags,
 454  * see http://matroska.org/technical/specs/tagging/index.html
 455  *
 456  * TODO: handle tag targets and nesting correctly
 457  */
 458
 459 /*
 460  * Enumerations for various types (mapping from binary
 461  * value to what it actually means).
 462  */
 463
 464 typedef enum {
 465   GST_MATROSKA_TRACK_TYPE_VIDEO    = 0x1,
 466   GST_MATROSKA_TRACK_TYPE_AUDIO    = 0x2,
 467   GST_MATROSKA_TRACK_TYPE_COMPLEX  = 0x3,
 468   GST_MATROSKA_TRACK_TYPE_LOGO     = 0x10,
 469   GST_MATROSKA_TRACK_TYPE_SUBTITLE = 0x11,
 470   GST_MATROSKA_TRACK_TYPE_BUTTONS  = 0x12,
 471   GST_MATROSKA_TRACK_TYPE_CONTROL  = 0x20,
 472 } GstMatroskaTrackType;
 473
 474 typedef enum {
 475   GST_MATROSKA_ASPECT_RATIO_MODE_FREE  = 0x0,
 476   GST_MATROSKA_ASPECT_RATIO_MODE_KEEP  = 0x1,
 477   GST_MATROSKA_ASPECT_RATIO_MODE_FIXED = 0x2,
 478 } GstMatroskaAspectRatioMode;
 479
 480 /*
 481  * These aren't in any way "matroska-form" things,
 482  * it's just something I use in the muxer/demuxer.
 483  */
 484
 485 typedef enum {
 486   GST_MATROSKA_TRACK_ENABLED = (1<<0),
 487   GST_MATROSKA_TRACK_DEFAULT = (1<<1),
 488   GST_MATROSKA_TRACK_LACING  = (1<<2),
 489   GST_MATROSKA_TRACK_FORCED  = (1<<3),
 490   GST_MATROSKA_TRACK_SHIFT   = (1<<16)
 491 } GstMatroskaTrackFlags;
 492
 493 typedef enum {
 494   GST_MATROSKA_VIDEOTRACK_INTERLACED = (GST_MATROSKA_TRACK_SHIFT<<0)
 495 } GstMatroskaVideoTrackFlags;
 496
 497 typedef enum {
 498   GST_MATROSKA_STEREO_MODE_SBS_LR      = 0x1,
 499   GST_MATROSKA_STEREO_MODE_TB_RL       = 0x2,
 500   GST_MATROSKA_STEREO_MODE_TB_LR       = 0x3,
 501   GST_MATROSKA_STEREO_MODE_CHECKER_RL  = 0x4,
 502   GST_MATROSKA_STEREO_MODE_CHECKER_LR  = 0x5,
 503   GST_MATROSKA_STEREO_MODE_SBS_RL      = 0x9,
 504   GST_MATROSKA_STEREO_MODE_FBF_LR      = 0xD,
 505   GST_MATROSKA_STEREO_MODE_FBF_RL      = 0xE
 506 } GstMatroskaStereoMode;
 507
 508 typedef struct _GstMatroskaTrackContext GstMatroskaTrackContext;
 509
 510 /* TODO: check if all fields are used */
 511 struct _GstMatroskaTrackContext {
 512   GstPad       *pad;
 513   GstCaps      *caps;
 514   guint         index;
 515   /* reverse playback */
 516   GstClockTime  from_time;
 517   gint64                   from_offset;
 518   gint64                   to_offset;
 519
 520   GArray       *index_table;
 521
 522   gint          index_writer_id;
 523
 524   /* some often-used info */
 525   gchar        *codec_id, *codec_name, *name, *language;
 526   gpointer      codec_priv;
 527   gsize         codec_priv_size;
 528   gpointer      codec_state;
 529   gsize         codec_state_size;
 530   GstMatroskaTrackType type;
 531   guint64       uid, num;
 532   GstMatroskaTrackFlags flags;
 533   guint64       default_duration;
 534   guint64       pos;
 535   gdouble       timecodescale;
 536   guint64       seek_preroll;
 537   guint64       codec_delay;
 538
 539   gboolean      set_discont; /* TRUE = set DISCONT flag on next buffer */
 540
 541   /* Stream header buffer, to put into caps and send before any other buffers */
 542   GstBufferList * stream_headers;
 543   gboolean        send_stream_headers;
 544
 545   /* Special flag for VobSub, for which we have to send colour table info
 546    * (if available) first before sending any data, and just testing
 547    * for time == 0 is not enough to detect that. Used by demuxer */
 548   gboolean      send_dvd_event;
 549
 550   /* Special counter for muxer to skip the first N vorbis/theora headers -
 551    * they are put into codec private data, not muxed into the stream */
 552   guint         xiph_headers_to_skip;
 553
 554   /* Used for postprocessing a frame before it is pushed from the demuxer */
 555   GstFlowReturn (*postprocess_frame) (GstElement *element,
 556                                       GstMatroskaTrackContext *context,
 557                                       GstBuffer **buffer);
 558
 559   /* List of tags for this stream */
 560   GstTagList   *tags;
 561   /* Tags changed and should be pushed again */
 562   gboolean      tags_changed;
 563
 564   /* A GArray of GstMatroskaTrackEncoding structures which contain the
 565    * encoding (compression/encryption) settings for this track, if any */
 566   GArray       *encodings;
 567
 568   /* Whether the stream is EOS */
 569   gboolean      eos;
 570
 571   /* any alignment we need our output buffers to have */
 572   gint          alignment;
 573
 574   /* for compatibility with VFW files, where timestamp represents DTS */
 575   gboolean      dts_only;
 576
 577   /* indicate that the track is raw (jpeg,raw variants) and so pts=dts */
 578   gboolean              intra_only;
 579 };
 580
 581 typedef struct _GstMatroskaTrackVideoContext {
 582   GstMatroskaTrackContext parent;
 583
 584   guint         pixel_width, pixel_height;
 585   guint         display_width, display_height;
 586   gdouble       default_fps;
 587   GstMatroskaAspectRatioMode asr_mode;
 588   guint32       fourcc;
 589
 590   GstVideoMultiviewMode multiview_mode;
 591   GstVideoMultiviewFlags multiview_flags;
 592
 593   /* QoS */
 594   GstClockTime  earliest_time;
 595
 596   GstBuffer     *dirac_unit;
 597 } GstMatroskaTrackVideoContext;
 598
 599 typedef struct _GstMatroskaTrackAudioContext {
 600   GstMatroskaTrackContext parent;
 601
 602   guint         samplerate, channels, bitdepth;
 603
 604   guint32       wvpk_block_index;
 605 } GstMatroskaTrackAudioContext;
 606
 607 typedef struct _GstMatroskaTrackSubtitleContext {
 608   GstMatroskaTrackContext parent;
 609
 610   gboolean    check_utf8;     /* buffers should be valid UTF-8 */
 611   gboolean    check_markup;   /* check if buffers contain markup
 612                                * or plaintext and escape characters */
 613   gboolean    invalid_utf8;   /* work around broken files      */
 614   gboolean    seen_markup_tag;  /* markup found in text */
 615 } GstMatroskaTrackSubtitleContext;
 616
 617 typedef struct _GstMatroskaIndex {
 618   guint64        pos;      /* of the corresponding *cluster*! */
 619   guint16        track;    /* reference to 'num' */
 620   GstClockTime   time;     /* in nanoseconds */
 621   guint32        block;    /* number of the block in the cluster */
 622 } GstMatroskaIndex;
 623
 624 typedef struct _Wavpack4Header {
 625   guchar  ck_id [4];     /* "wvpk"                                         */
 626   guint32 ck_size;       /* size of entire frame (minus 8, of course)      */
 627   guint16 version;       /* 0x403 for now                                  */
 628   guint8  track_no;      /* track number (0 if not used, like now)         */
 629   guint8  index_no;      /* remember these? (0 if not used, like now)      */
 630   guint32 total_samples; /* for entire file (-1 if unknown)                */
 631   guint32 block_index;   /* index of first sample in block (to file begin) */
 632   guint32 block_samples; /* # samples in this block                        */
 633   guint32 flags;         /* various flags for id and decoding              */
 634   guint32 crc;           /* crc for actual decoded data                    */
 635 } Wavpack4Header;
 636
 637 typedef enum {
 638   GST_MATROSKA_TRACK_ENCODING_SCOPE_FRAME = (1<<0),
 639   GST_MATROSKA_TRACK_ENCODING_SCOPE_CODEC_DATA = (1<<1),
 640   GST_MATROSKA_TRACK_ENCODING_SCOPE_NEXT_CONTENT_ENCODING = (1<<2)
 641 } GstMatroskaTrackEncodingScope;
 642
 643 typedef enum {
 644   GST_MATROSKA_TRACK_COMPRESSION_ALGORITHM_ZLIB = 0,
 645   GST_MATROSKA_TRACK_COMPRESSION_ALGORITHM_BZLIB = 1,
 646   GST_MATROSKA_TRACK_COMPRESSION_ALGORITHM_LZO1X = 2,
 647   GST_MATROSKA_TRACK_COMPRESSION_ALGORITHM_HEADERSTRIP = 3
 648 } GstMatroskaTrackCompressionAlgorithm;
 649
 650 typedef struct _GstMatroskaTrackEncoding {
 651   guint   order;
 652   guint   scope     : 3;
 653   guint   type      : 1;
 654   guint   comp_algo : 2;
 655   guint8 *comp_settings;
 656   guint   comp_settings_length;
 657 } GstMatroskaTrackEncoding;
 658
 659 gboolean gst_matroska_track_init_video_context    (GstMatroskaTrackContext ** p_context);
 660 gboolean gst_matroska_track_init_audio_context    (GstMatroskaTrackContext ** p_context);
 661 gboolean gst_matroska_track_init_subtitle_context (GstMatroskaTrackContext ** p_context);
 662
 663 void gst_matroska_register_tags (void);
 664
 665 GstBufferList * gst_matroska_parse_xiph_stream_headers  (gpointer codec_data,
 666                                                          gsize codec_data_size);
 667
 668 GstBufferList * gst_matroska_parse_speex_stream_headers (gpointer codec_data,
 669                                                          gsize codec_data_size);
 670
 671 GstBufferList * gst_matroska_parse_opus_stream_headers  (gpointer codec_data,
 672                                                          gsize codec_data_size);
 673
 674 GstBufferList * gst_matroska_parse_flac_stream_headers  (gpointer codec_data,
 675                                                          gsize codec_data_size);
 676 void gst_matroska_track_free (GstMatroskaTrackContext * track);
 677 GstClockTime gst_matroska_track_get_buffer_timestamp (GstMatroskaTrackContext * track, GstBuffer *buf);
 678
 679 #endif /* __GST_MATROSKA_IDS_H__ */