git.sesse.net Git - vlc/blob - modules/demux/mp4/libmp4.h

   1 /*****************************************************************************
   2  * libmp4.h : LibMP4 library for mp4 module for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2001 VideoLAN
   5  * $Id: libmp4.h,v 1.15 2003/08/17 20:45:50 fenrir Exp $
   6  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  21  *****************************************************************************/
  22
  23 #define FOURCC_uuid VLC_FOURCC( 'u', 'u', 'i', 'd' )
  24
  25 #define FOURCC_ftyp VLC_FOURCC( 'f', 't', 'y', 'p' )
  26 #define FOURCC_moov VLC_FOURCC( 'm', 'o', 'o', 'v' )
  27 #define FOURCC_foov VLC_FOURCC( 'f', 'o', 'o', 'v' )
  28 #define FOURCC_cmov VLC_FOURCC( 'c', 'm', 'o', 'v' )
  29 #define FOURCC_dcom VLC_FOURCC( 'd', 'c', 'o', 'm' )
  30 #define FOURCC_cmvd VLC_FOURCC( 'c', 'm', 'v', 'd' )
  31
  32 #define FOURCC_moof VLC_FOURCC( 'm', 'o', 'o', 'f' )
  33 #define FOURCC_mdat VLC_FOURCC( 'm', 'd', 'a', 't' )
  34 #define FOURCC_skip VLC_FOURCC( 's', 'k', 'i', 'p' )
  35 #define FOURCC_free VLC_FOURCC( 'f', 'r', 'e', 'e' )
  36 #define FOURCC_udta VLC_FOURCC( 'u', 'd', 't', 'a' )
  37 #define FOURCC_wide VLC_FOURCC( 'w', 'i', 'd', 'e' )
  38
  39 #define FOURCC_trak VLC_FOURCC( 't', 'r', 'a', 'k' )
  40 #define FOURCC_mvhd VLC_FOURCC( 'm', 'v', 'h', 'd' )
  41 #define FOURCC_tkhd VLC_FOURCC( 't', 'k', 'h', 'd' )
  42 #define FOURCC_tref VLC_FOURCC( 't', 'r', 'e', 'f' )
  43 #define FOURCC_mdia VLC_FOURCC( 'm', 'd', 'i', 'a' )
  44 #define FOURCC_mdhd VLC_FOURCC( 'm', 'd', 'h', 'd' )
  45 #define FOURCC_hdlr VLC_FOURCC( 'h', 'd', 'l', 'r' )
  46 #define FOURCC_minf VLC_FOURCC( 'm', 'i', 'n', 'f' )
  47 #define FOURCC_vmhd VLC_FOURCC( 'v', 'm', 'h', 'd' )
  48 #define FOURCC_smhd VLC_FOURCC( 's', 'm', 'h', 'd' )
  49 #define FOURCC_hmhd VLC_FOURCC( 'h', 'm', 'h', 'd' )
  50 #define FOURCC_dinf VLC_FOURCC( 'd', 'i', 'n', 'f' )
  51 #define FOURCC_url  VLC_FOURCC( 'u', 'r', 'l', ' ' )
  52 #define FOURCC_urn  VLC_FOURCC( 'u', 'r', 'n', ' ' )
  53 #define FOURCC_dref VLC_FOURCC( 'd', 'r', 'e', 'f' )
  54 #define FOURCC_stbl VLC_FOURCC( 's', 't', 'b', 'l' )
  55 #define FOURCC_stts VLC_FOURCC( 's', 't', 't', 's' )
  56 #define FOURCC_ctts VLC_FOURCC( 'c', 't', 't', 's' )
  57 #define FOURCC_stsd VLC_FOURCC( 's', 't', 's', 'd' )
  58 #define FOURCC_stsz VLC_FOURCC( 's', 't', 's', 'z' )
  59 #define FOURCC_stz2 VLC_FOURCC( 's', 't', 'z', '2' )
  60 #define FOURCC_stsc VLC_FOURCC( 's', 't', 's', 'c' )
  61 #define FOURCC_stco VLC_FOURCC( 's', 't', 'c', 'o' )
  62 #define FOURCC_co64 VLC_FOURCC( 'c', 'o', '6', '4' )
  63 #define FOURCC_stss VLC_FOURCC( 's', 't', 's', 's' )
  64 #define FOURCC_stsh VLC_FOURCC( 's', 't', 's', 'h' )
  65 #define FOURCC_stdp VLC_FOURCC( 's', 't', 'd', 'p' )
  66 #define FOURCC_padb VLC_FOURCC( 'p', 'a', 'd', 'b' )
  67 #define FOURCC_edts VLC_FOURCC( 'e', 'd', 't', 's' )
  68 #define FOURCC_elst VLC_FOURCC( 'e', 'l', 's', 't' )
  69 #define FOURCC_udta VLC_FOURCC( 'u', 'd', 't', 'a' )
  70 #define FOURCC_mvex VLC_FOURCC( 'm', 'v', 'e', 'x' )
  71 #define FOURCC_trex VLC_FOURCC( 't', 'r', 'e', 'x' )
  72 #define FOURCC_mfhd VLC_FOURCC( 'm', 'f', 'h', 'd' )
  73 #define FOURCC_traf VLC_FOURCC( 't', 'r', 'a', 'f' )
  74 #define FOURCC_tfhd VLC_FOURCC( 't', 'f', 'h', 'd' )
  75 #define FOURCC_trun VLC_FOURCC( 't', 'r', 'u', 'n' )
  76 #define FOURCC_cprt VLC_FOURCC( 'c', 'p', 'r', 't' )
  77 #define FOURCC_iods VLC_FOURCC( 'i', 'o', 'd', 's' )
  78
  79 #define FOURCC_nmhd VLC_FOURCC( 'n', 'm', 'h', 'd' )
  80 #define FOURCC_mp4v VLC_FOURCC( 'm', 'p', '4', 'v' )
  81 #define FOURCC_mp4a VLC_FOURCC( 'm', 'p', '4', 'a' )
  82 #define FOURCC_mp4s VLC_FOURCC( 'm', 'p', '4', 's' )
  83 #define FOURCC_vide VLC_FOURCC( 'v', 'i', 'd', 'e' )
  84 #define FOURCC_soun VLC_FOURCC( 's', 'o', 'u', 'n' )
  85 #define FOURCC_hint VLC_FOURCC( 'h', 'i', 'n', 't' )
  86
  87 #define FOURCC_dpnd VLC_FOURCC( 'd', 'p', 'n', 'd' )
  88 #define FOURCC_ipir VLC_FOURCC( 'i', 'p', 'i', 'r' )
  89 #define FOURCC_mpod VLC_FOURCC( 'm', 'p', 'o', 'd' )
  90 #define FOURCC_hnti VLC_FOURCC( 'h', 'n', 't', 'i' )
  91 #define FOURCC_rtp  VLC_FOURCC( 'r', 't', 'p', ' ' )
  92
  93 #define FOURCC_isom VLC_FOURCC( 'i', 's', 'o', 'm' )
  94 #define FOURCC_esds VLC_FOURCC( 'e', 's', 'd', 's' )
  95
  96 #define FOURCC__mp3 VLC_FOURCC( '.', 'm', 'p', '3' )
  97 #define FOURCC_ms02 VLC_FOURCC( 'm', 's', 0x0, 0x02 )
  98 #define FOURCC_ms11 VLC_FOURCC( 'm', 's', 0x0, 0x11 )
  99 #define FOURCC_ms55 VLC_FOURCC( 'm', 's', 0x0, 0x55 )
 100 #define FOURCC_twos VLC_FOURCC( 't', 'w', 'o', 's' )
 101 #define FOURCC_sowt VLC_FOURCC( 's', 'o', 'w', 't' )
 102 #define FOURCC_QDMC VLC_FOURCC( 'Q', 'D', 'M', 'C' )
 103 #define FOURCC_QDM2 VLC_FOURCC( 'Q', 'D', 'M', '2' )
 104 #define FOURCC_ima4 VLC_FOURCC( 'i', 'm', 'a', '4' )
 105 #define FOURCC_IMA4 VLC_FOURCC( 'I', 'M', 'A', '4' )
 106 #define FOURCC_dvi  VLC_FOURCC( 'd', 'v', 'i', ' ' )
 107 #define FOURCC_MAC3 VLC_FOURCC( 'M', 'A', 'C', '3' )
 108 #define FOURCC_MAC6 VLC_FOURCC( 'M', 'A', 'C', '6' )
 109 #define FOURCC_alaw VLC_FOURCC( 'a', 'l', 'a', 'w' )
 110 #define FOURCC_ulaw VLC_FOURCC( 'u', 'l', 'a', 'w' )
 111 #define FOURCC_Qclp VLC_FOURCC( 'Q', 'c', 'l', 'p' )
 112 #define FOURCC_samr VLC_FOURCC( 's', 'a', 'm', 'r' )
 113 #define FOURCC_OggS VLC_FOURCC( 'O', 'g', 'g', 'S' )
 114
 115 #define FOURCC_zlib VLC_FOURCC( 'z', 'l', 'i', 'b' )
 116 #define FOURCC_SVQ1 VLC_FOURCC( 'S', 'V', 'Q', '1' )
 117 #define FOURCC_SVQ3 VLC_FOURCC( 'S', 'V', 'Q', '3' )
 118 #define FOURCC_ZyGo VLC_FOURCC( 'Z', 'y', 'G', 'o' )
 119 #define FOURCC_3IV1 VLC_FOURCC( '3', 'I', 'V', '1' )
 120 #define FOURCC_3iv1 VLC_FOURCC( '3', 'i', 'v', '1' )
 121 #define FOURCC_3IV2 VLC_FOURCC( '3', 'I', 'V', '2' )
 122 #define FOURCC_3iv2 VLC_FOURCC( '3', 'i', 'v', '2' )
 123 #define FOURCC_3IVD VLC_FOURCC( '3', 'I', 'V', 'D' )
 124 #define FOURCC_3ivd VLC_FOURCC( '3', 'i', 'v', 'd' )
 125 #define FOURCC_3VID VLC_FOURCC( '3', 'V', 'I', 'D' )
 126 #define FOURCC_3vid VLC_FOURCC( '3', 'v', 'i', 'd' )
 127 #define FOURCC_h263 VLC_FOURCC( 'h', '2', '6', '3' )
 128 #define FOURCC_s263 VLC_FOURCC( 's', '2', '6', '3' )
 129 #define FOURCC_DIVX VLC_FOURCC( 'D', 'I', 'V', 'X' )
 130 #define FOURCC_cvid VLC_FOURCC( 'c', 'v', 'i', 'd' )
 131 #define FOURCC_mjpa VLC_FOURCC( 'm', 'j', 'p', 'a' )
 132 #define FOURCC_mjpb VLC_FOURCC( 'm', 'j', 'q', 't' )
 133 #define FOURCC_mjqt VLC_FOURCC( 'm', 'j', 'h', 't' )
 134 #define FOURCC_mjht VLC_FOURCC( 'm', 'j', 'p', 'b' )
 135 #define FOURCC_VP31 VLC_FOURCC( 'V', 'P', '3', '1' )
 136 #define FOURCC_vp31 VLC_FOURCC( 'v', 'p', '3', '1' )
 137
 138 #define FOURCC_dvc  VLC_FOURCC( 'd', 'v', 'c', ' ' )
 139 #define FOURCC_dvp  VLC_FOURCC( 'd', 'v', 'p', ' ' )
 140 #define FOURCC_raw  VLC_FOURCC( 'r', 'a', 'w', ' ' )
 141
 142 #define FOURCC_jpeg VLC_FOURCC( 'j', 'p', 'e', 'g' )
 143
 144
 145 #define FOURCC_rmra VLC_FOURCC( 'r', 'm', 'r', 'a' )
 146 #define FOURCC_rmda VLC_FOURCC( 'r', 'm', 'd', 'a' )
 147 #define FOURCC_rdrf VLC_FOURCC( 'r', 'd', 'r', 'f' )
 148 #define FOURCC_rmdr VLC_FOURCC( 'r', 'm', 'd', 'r' )
 149 #define FOURCC_rmvc VLC_FOURCC( 'r', 'm', 'v', 'c' )
 150 #define FOURCC_rmcd VLC_FOURCC( 'r', 'm', 'c', 'd' )
 151 #define FOURCC_rmqu VLC_FOURCC( 'r', 'm', 'q', 'u' )
 152 #define FOURCC_alis VLC_FOURCC( 'a', 'l', 'i', 's' )
 153
 154 #define FOURCC_gmhd VLC_FOURCC( 'g', 'm', 'h', 'd' )
 155
 156 /* Do you want some debug information on all read boxes ? */
 157 #define MP4_VERBOSE  1
 158
 159 /* memory stream and file stream object */
 160
 161 typedef struct MP4_Stream_s
 162 {
 163     int     b_memory;   /* do we uses a memory buffer */
 164
 165     input_thread_t *p_input;
 166
 167     off_t   i_start; /* in the buffer position for memory stream */
 168     off_t   i_stop;
 169     uint8_t *p_buffer;
 170
 171 } MP4_Stream_t;
 172
 173 struct MP4_Box_s;
 174
 175
 176 /* uuid Universal Unique IDentifiers */
 177 typedef struct UUID_s
 178 {
 179     uint8_t b[16];
 180 } UUID_t;
 181
 182 /* specific structure for all boxes */
 183
 184 typedef struct MP4_Box_data_ftyp_s
 185 {
 186     uint32_t i_major_brand;
 187     uint32_t i_minor_version;
 188
 189     uint32_t i_compatible_brands_count;
 190     uint32_t *i_compatible_brands;
 191
 192 } MP4_Box_data_ftyp_t;
 193
 194 typedef struct MP4_Box_data_mvhd_s
 195 {
 196     uint8_t  i_version;
 197     uint32_t i_flags;
 198
 199     uint64_t i_creation_time;
 200     uint64_t i_modification_time;
 201     uint32_t i_timescale;
 202     uint64_t i_duration;
 203
 204     int32_t  i_rate;
 205     int16_t  i_volume;
 206     int16_t  i_reserved1;
 207     uint32_t i_reserved2[2];
 208     int32_t  i_matrix[9];
 209     uint32_t i_predefined[6];
 210     uint32_t i_next_track_id;
 211
 212 } MP4_Box_data_mvhd_t;
 213
 214 #define MP4_TRACK_ENABLED    0x000001
 215 #define MP4_TRACK_IN_MOVIE   0x000002
 216 #define MP4_TRACK_IN_PREVIEW 0x000004
 217 typedef struct MP4_Box_data_tkhd_s
 218 {
 219     uint8_t  i_version;
 220     uint32_t i_flags;
 221
 222     uint64_t i_creation_time;
 223     uint64_t i_modification_time;
 224     uint32_t i_track_ID;
 225     uint32_t i_reserved;
 226     uint64_t i_duration;
 227
 228     uint32_t i_reserved2[2];
 229     int16_t  i_layer;
 230     int16_t  i_predefined;
 231
 232     int16_t  i_volume;
 233     uint16_t i_reserved3;
 234     int32_t  i_matrix[9];
 235     int32_t  i_width;
 236     int32_t  i_height;
 237
 238 } MP4_Box_data_tkhd_t;
 239
 240 typedef struct MP4_Box_data_mdhd_s
 241 {
 242     uint8_t  i_version;
 243     uint32_t i_flags;
 244
 245     uint64_t i_creation_time;
 246     uint64_t i_modification_time;
 247     uint32_t i_timescale;
 248     uint64_t i_duration;
 249
 250     /* one bit for pad */
 251     /* unsigned int(5)[3] language difference with 0x60*/
 252     unsigned char i_language[3];
 253     uint16_t i_predefined;
 254
 255 } MP4_Box_data_mdhd_t;
 256
 257 typedef struct MP4_Box_data_hdlr_s
 258 {
 259     uint8_t  i_version;
 260     uint32_t i_flags;
 261
 262     uint32_t i_predefined;
 263     uint32_t i_handler_type; /* "vide" "soun" "hint" "odsm"
 264                            "crsm" "sdsm" "m7sm" "ocsm"
 265                            "ipsm" "mjsm" */
 266
 267     unsigned char *psz_name; /* in UTF-8 */
 268
 269 } MP4_Box_data_hdlr_t;
 270
 271 typedef struct MP4_Box_data_vmhd_s
 272 {
 273     uint8_t  i_version;
 274     uint32_t i_flags;
 275
 276     int16_t  i_graphics_mode;
 277     int16_t  i_opcolor[3];
 278
 279 } MP4_Box_data_vmhd_t;
 280
 281 typedef struct MP4_Box_data_smhd_s
 282 {
 283     uint8_t  i_version;
 284     uint32_t i_flags;
 285
 286     int16_t  i_balance;
 287     int16_t  i_reserved;
 288
 289 } MP4_Box_data_smhd_t;
 290
 291 typedef struct MP4_Box_data_hmhd_s
 292 {
 293     uint8_t  i_version;
 294     uint32_t i_flags;
 295
 296     uint16_t i_max_PDU_size;
 297     uint16_t i_avg_PDU_size;
 298     uint32_t i_max_bitrate;
 299     uint32_t i_avg_bitrate;
 300     uint32_t i_reserved;
 301
 302 } MP4_Box_data_hmhd_t;
 303
 304 typedef struct MP4_Box_data_url_s
 305 {
 306     uint8_t  i_version;
 307     uint32_t i_flags;
 308
 309     unsigned char *psz_location;
 310
 311 } MP4_Box_data_url_t;
 312
 313 typedef struct MP4_Box_data_urn_s
 314 {
 315     uint8_t  i_version;
 316     uint32_t i_flags;
 317
 318     unsigned char *psz_name;
 319     unsigned char *psz_location;
 320
 321 } MP4_Box_data_urn_t;
 322
 323 typedef struct MP4_Box_data_dref_s
 324 {
 325     uint8_t  i_version;
 326     uint32_t i_flags;
 327
 328     uint32_t i_entry_count;
 329 /* XXX it's also a container with i_entry_count entry */
 330 } MP4_Box_data_dref_t;
 331
 332 typedef struct MP4_Box_data_stts_s
 333 {
 334     uint8_t  i_version;
 335     uint32_t i_flags;
 336
 337     uint32_t i_entry_count;
 338     uint32_t *i_sample_count; /* these are array */
 339     int32_t  *i_sample_delta;
 340
 341 } MP4_Box_data_stts_t;
 342
 343 typedef struct MP4_Box_data_ctts_s
 344 {
 345     uint8_t  i_version;
 346     uint32_t i_flags;
 347
 348     uint32_t i_entry_count;
 349
 350     uint32_t *i_sample_count; /* these are array */
 351     int32_t  *i_sample_offset;
 352
 353 } MP4_Box_data_ctts_t;
 354
 355
 356 typedef struct MP4_Box_data_sample_soun_s
 357 {
 358     uint8_t  i_reserved1[6];
 359     uint16_t i_data_reference_index;
 360
 361     //uint32_t i_reserved2[2];
 362     uint16_t i_qt_version;
 363     uint16_t i_qt_revision_level;
 364     uint32_t i_qt_vendor;
 365
 366     uint16_t i_channelcount;
 367     uint16_t i_samplesize;
 368     uint16_t i_predefined;
 369     uint16_t i_reserved3;
 370     uint16_t i_sampleratehi; /* timescale of track */
 371     uint16_t i_sampleratelo;
 372
 373     /* for version 1 (i_reserved1[0] == 1) */
 374     uint32_t i_sample_per_packet;
 375     uint32_t i_bytes_per_packet;
 376     uint32_t i_bytes_per_frame;
 377     uint32_t i_bytes_per_sample;
 378
 379     /* XXX hack */
 380     int     i_qt_description;
 381     uint8_t *p_qt_description;
 382
 383 } MP4_Box_data_sample_soun_t;
 384
 385 typedef struct MP4_Box_data_sample_vide_s
 386 {
 387     uint8_t  i_reserved1[6];
 388     uint16_t i_data_reference_index;
 389
 390     uint16_t i_qt_version;
 391     uint16_t i_qt_revision_level;
 392     uint32_t i_qt_vendor;
 393
 394     uint32_t i_qt_temporal_quality;
 395     uint32_t i_qt_spatial_quality;
 396
 397     int16_t  i_width;
 398     int16_t  i_height;
 399
 400     uint32_t i_horizresolution;
 401     uint32_t i_vertresolution;
 402
 403     uint32_t i_qt_data_size;
 404     uint16_t i_qt_frame_count;
 405
 406     uint8_t  i_compressorname[32];
 407     int16_t  i_depth;
 408
 409     int16_t  i_qt_color_table;
 410
 411     /* XXX hack ImageDescription */
 412     int     i_qt_image_description;
 413     uint8_t *p_qt_image_description;
 414
 415 } MP4_Box_data_sample_vide_t;
 416
 417 typedef struct MP4_Box_data_sample_hint_s
 418 {
 419     uint8_t  i_reserved1[6];
 420     uint16_t i_data_reference_index;
 421
 422     uint8_t *p_data;
 423
 424 } MP4_Box_data_sample_hint_t;
 425
 426 typedef struct MP4_Box_data_moviehintinformation_rtp_s
 427 {
 428     uint32_t i_description_format;
 429     unsigned char *psz_text;
 430
 431 } MP4_Box_data_moviehintinformation_rtp_t;
 432
 433
 434
 435 typedef struct MP4_Box_data_stsd_s
 436 {
 437     uint8_t  i_version;
 438     uint32_t i_flags;
 439
 440     uint32_t i_entry_count;
 441
 442     /* it contains SampleEntry handled as if it was Box */
 443
 444 } MP4_Box_data_stsd_t;
 445
 446
 447 typedef struct MP4_Box_data_stsz_s
 448 {
 449     uint8_t  i_version;
 450     uint32_t i_flags;
 451
 452     uint32_t i_sample_size;
 453     uint32_t i_sample_count;
 454
 455     uint32_t *i_entry_size; /* array , empty if i_sample_size != 0 */
 456
 457 } MP4_Box_data_stsz_t;
 458
 459 typedef struct MP4_Box_data_stz2_s
 460 {
 461     uint8_t  i_version;
 462     uint32_t i_flags;
 463
 464     uint32_t i_sample_size; /* 24 bits */
 465     uint8_t  i_field_size;
 466     uint32_t i_sample_count;
 467
 468     uint32_t *i_entry_size; /* array: unsigned int(i_field_size) entry_size */
 469
 470 } MP4_Box_data_stz2_t;
 471
 472 typedef struct MP4_Box_data_stsc_s
 473 {
 474     uint8_t  i_version;
 475     uint32_t i_flags;
 476
 477     uint32_t i_entry_count;
 478
 479     uint32_t *i_first_chunk; /* theses are arrays */
 480     uint32_t *i_samples_per_chunk;
 481     uint32_t *i_sample_description_index;
 482
 483 } MP4_Box_data_stsc_t;
 484
 485
 486 typedef struct MP4_Box_data_co64_s
 487 {
 488     uint8_t  i_version;
 489     uint32_t i_flags;
 490
 491     uint32_t i_entry_count;
 492
 493     uint64_t *i_chunk_offset;
 494
 495 } MP4_Box_data_co64_t;
 496
 497
 498 typedef struct MP4_Box_data_stss_s
 499 {
 500     uint8_t  i_version;
 501     uint32_t i_flags;
 502
 503     uint32_t i_entry_count;
 504
 505     uint32_t *i_sample_number;
 506
 507 } MP4_Box_data_stss_t;
 508
 509 typedef struct MP4_Box_data_stsh_s
 510 {
 511     uint8_t  i_version;
 512     uint32_t i_flags;
 513
 514     uint32_t i_entry_count;
 515
 516     uint32_t *i_shadowed_sample_number;
 517     uint32_t *i_sync_sample_number;
 518
 519 } MP4_Box_data_stsh_t;
 520
 521 typedef struct MP4_Box_data_stdp_s
 522 {
 523     uint8_t  i_version;
 524     uint32_t i_flags;
 525
 526     uint16_t *i_priority;
 527
 528 } MP4_Box_data_stdp_t;
 529
 530 typedef struct MP4_Box_data_padb_s
 531 {
 532     uint8_t  i_version;
 533     uint32_t i_flags;
 534
 535     uint32_t i_sample_count;
 536
 537     uint16_t *i_reserved1;   /* 1bit  */
 538     uint16_t *i_pad2;        /* 3bits */
 539     uint16_t *i_reserved2;   /* 1bit  */
 540     uint16_t *i_pad1;        /* 3bits */
 541
 542
 543 } MP4_Box_data_padb_t;
 544
 545
 546 typedef struct MP4_Box_data_elst_s
 547 {
 548     uint8_t  i_version;
 549     uint32_t i_flags;
 550
 551     uint32_t i_entry_count;
 552
 553     uint64_t *i_segment_duration;
 554     int64_t  *i_media_time;
 555     uint16_t *i_media_rate_integer;
 556     uint16_t *i_media_rate_fraction;
 557
 558
 559 } MP4_Box_data_elst_t;
 560
 561 typedef struct MP4_Box_data_cprt_s
 562 {
 563     uint8_t  i_version;
 564     uint32_t i_flags;
 565     /* 1 pad bit */
 566     unsigned char i_language[3];
 567
 568     unsigned char *psz_notice;
 569 } MP4_Box_data_cprt_t;
 570
 571
 572 /* DecoderConfigDescriptor */
 573 typedef struct MP4_descriptor_decoder_config_s
 574 {
 575     uint8_t i_objectTypeIndication;
 576     uint8_t i_streamType;
 577     int     b_upStream;
 578     int     i_buffer_sizeDB;
 579     int     i_max_bitrate;
 580     int     i_avg_bitrate;
 581
 582     int     i_decoder_specific_info_len;
 583     uint8_t *p_decoder_specific_info;
 584     /* some other stuff */
 585
 586 } MP4_descriptor_decoder_config_t;
 587
 588 typedef struct MP4_descriptor_SL_config_s
 589 {
 590
 591     int i_dummy; /* ANSI C forbids empty structures */
 592
 593 } MP4_descriptor_SL_config_t;
 594
 595
 596 typedef struct MP4_descriptor_ES_s
 597 {
 598     uint16_t i_ES_ID;
 599     int      b_stream_dependence;
 600     int      b_url;
 601     int      b_OCRstream;
 602     int      i_stream_priority;
 603
 604     int      i_depend_on_ES_ID; /* if b_stream_dependence set */
 605
 606     unsigned char *psz_URL;
 607
 608     uint16_t i_OCR_ES_ID;       /* if b_OCRstream */
 609     MP4_descriptor_decoder_config_t *p_decConfigDescr;
 610
 611     MP4_descriptor_SL_config_t *p_slConfigDescr;
 612
 613     /* some other stuff ... */
 614
 615 } MP4_descriptor_ES_t;
 616
 617 /* ES descriptor */
 618 typedef struct MP4_Box_data_esds_s
 619 {
 620     uint8_t  i_version;
 621     uint32_t i_flags;
 622
 623     MP4_descriptor_ES_t es_descriptor;
 624
 625 } MP4_Box_data_esds_t;
 626
 627
 628 typedef struct MP4_Box_data_dcom_s
 629 {
 630     uint32_t i_algorithm; /* fourcc */
 631
 632 } MP4_Box_data_dcom_t;
 633
 634 typedef struct MP4_Box_data_cmvd_s
 635 {
 636     uint32_t i_uncompressed_size;
 637     uint32_t i_compressed_size;
 638
 639     int     b_compressed; /* Set to 1 if compressed data, 0 if uncompressed */
 640     uint8_t *p_data;
 641
 642 } MP4_Box_data_cmvd_t;
 643
 644 typedef struct MP4_Box_data_cmov_s
 645 {
 646     struct MP4_Box_s *p_moov; /* uncompressed moov */
 647
 648 } MP4_Box_data_cmov_t;
 649
 650 typedef struct MP4_Box_data_rdrf_s
 651 {
 652     uint8_t  i_version;
 653     uint32_t i_flags;
 654
 655     uint32_t i_ref_type;
 656     char     *psz_ref;
 657
 658 } MP4_Box_data_rdrf_t;
 659
 660 typedef struct MP4_Box_data_rmdr_s
 661 {
 662     uint8_t  i_version;
 663     uint32_t i_flags;
 664
 665     uint32_t i_rate;
 666
 667 } MP4_Box_data_rmdr_t;
 668
 669 typedef struct MP4_Box_data_rmvc_s
 670 {
 671     uint8_t  i_version;
 672     uint32_t i_flags;
 673
 674     uint32_t i_gestaltType;
 675     uint32_t i_val1;
 676     uint32_t i_val2;
 677     uint16_t i_checkType;   /* 0: val1 is version min
 678                                1: gestalt value & val2 == val1 */
 679
 680 } MP4_Box_data_rmvc_t;
 681
 682 typedef struct MP4_Box_data_rmcd_s
 683 {
 684     uint8_t  i_version;
 685     uint32_t i_flags;
 686
 687
 688 } MP4_Box_data_rmcd_t;
 689
 690 typedef struct MP4_Box_data_rmqu_s
 691 {
 692     uint32_t i_quality;
 693
 694 } MP4_Box_data_rmqu_t;
 695
 696 /*
 697 typedef struct MP4_Box_data__s
 698 {
 699     uint8_t  i_version;
 700     uint32_t i_flags;
 701
 702 } MP4_Box_data__t;
 703
 704 */
 705
 706 typedef union MP4_Box_data_s
 707 {
 708     MP4_Box_data_ftyp_t *p_ftyp;
 709     MP4_Box_data_mvhd_t *p_mvhd;
 710     MP4_Box_data_tkhd_t *p_tkhd;
 711     MP4_Box_data_mdhd_t *p_mdhd;
 712     MP4_Box_data_hdlr_t *p_hdlr;
 713     MP4_Box_data_vmhd_t *p_vmhd;
 714     MP4_Box_data_smhd_t *p_smhd;
 715     MP4_Box_data_hmhd_t *p_hmhd;
 716     MP4_Box_data_url_t  *p_url;
 717     MP4_Box_data_urn_t  *p_urn;
 718     MP4_Box_data_dref_t *p_dref;
 719     MP4_Box_data_stts_t *p_stts;
 720     MP4_Box_data_ctts_t *p_ctts;
 721     MP4_Box_data_stsd_t *p_stsd;
 722         MP4_Box_data_sample_vide_t *p_sample_vide;
 723         MP4_Box_data_sample_soun_t *p_sample_soun;
 724         MP4_Box_data_sample_hint_t *p_sample_hint;
 725
 726         MP4_Box_data_esds_t *p_esds;
 727
 728     MP4_Box_data_stsz_t *p_stsz;
 729     MP4_Box_data_stz2_t *p_stz2;
 730     MP4_Box_data_stsc_t *p_stsc;
 731     MP4_Box_data_co64_t *p_co64;
 732     MP4_Box_data_stss_t *p_stss;
 733     MP4_Box_data_stsh_t *p_stsh;
 734     MP4_Box_data_stdp_t *p_stdp;
 735     MP4_Box_data_padb_t *p_padb;
 736     MP4_Box_data_elst_t *p_elst;
 737     MP4_Box_data_cprt_t *p_cprt;
 738
 739     MP4_Box_data_dcom_t *p_dcom;
 740     MP4_Box_data_cmvd_t *p_cmvd;
 741     MP4_Box_data_cmov_t *p_cmov;
 742
 743     MP4_Box_data_moviehintinformation_rtp_t p_moviehintinformation_rtp;
 744
 745     MP4_Box_data_rdrf_t *p_rdrf;
 746     MP4_Box_data_rmdr_t *p_rmdr;
 747     MP4_Box_data_rmqu_t *p_rmqu;
 748     MP4_Box_data_rmvc_t *p_rmvc;
 749
 750     void                *p_data; /* for unknow type */
 751 } MP4_Box_data_t;
 752
 753
 754
 755 /* the most basic structure */
 756 typedef struct MP4_Box_s
 757 {
 758     off_t        i_pos;      /* absolute position */
 759
 760     uint32_t     i_type;
 761     uint32_t     i_shortsize;
 762
 763     UUID_t       i_uuid;  /* Set if i_type == "uuid" */
 764
 765     uint64_t     i_size; /* always set so use it */
 766
 767     MP4_Box_data_t   data;   /* union of pointers on extended data depending
 768                                 on i_type (or i_usertype) */
 769
 770     struct MP4_Box_s *p_father; /* pointer on the father Box */
 771
 772     struct MP4_Box_s *p_first;  /* pointer on the first child Box */
 773     struct MP4_Box_s *p_last;
 774
 775     struct MP4_Box_s *p_next;   /* pointer on the next boxes at the same level */
 776
 777 } MP4_Box_t;
 778
 779 /*---------------------------------------------------------------------------*/
 780 /*                                                                           */
 781 /****----------------------- High level functions ------------------------****/
 782 /*                                                                           */
 783 /*---------------------------------------------------------------------------*/
 784
 785 /*****************************************************************************
 786  * Function for manipulate stream easily
 787  *****************************************************************************/
 788
 789 off_t MP4_TellAbsolute( input_thread_t *p_input );
 790 int   MP4_SeekAbsolute( input_thread_t *p_input, off_t i_pos);
 791 int   MP4_ReadData( input_thread_t *p_input, uint8_t *p_buff, int i_size );
 792
 793 /*****************************************************************************
 794  * MP4_BoxGetRoot : Parse the entire file, and create all boxes in memory
 795  *****************************************************************************
 796  *  The first box is a virtual box "root" and is the father for all first
 797  *  level boxes
 798  *
 799  *  RETURN : 1 if succes and 0 if it failed
 800  *****************************************************************************/
 801 int MP4_BoxGetRoot( input_thread_t *p_input, MP4_Box_t *p_root );
 802
 803 /*****************************************************************************
 804  * MP4_FreeBox : free memory allocated after read with MP4_ReadBox
 805  *               or MP4_BoxGetRoot, this means also children boxes
 806  * XXX : all children have to be allocated by a malloc !! and
 807  *         p_box isn't freeing
 808  *****************************************************************************/
 809 void MP4_BoxFree( input_thread_t *p_input, MP4_Box_t *p_box );
 810
 811 /*****************************************************************************
 812  * MP4_DumpBoxStructure: print the structure of the p_box
 813  *****************************************************************************
 814  * Usefull while debugging
 815  *****************************************************************************/
 816 void MP4_BoxDumpStructure( input_thread_t *p_input, MP4_Box_t *p_box );
 817
 818
 819 /*****************************************************************************
 820  * MP4_BoxGet: find a box given a path relative to p_box
 821  *****************************************************************************
 822  * Path Format: . .. / as usual
 823  *              [number] to specifie box number ex: trak[12]
 824  *
 825  * ex: /moov/trak[12]
 826  *     ../mdia
 827  *****************************************************************************/
 828 MP4_Box_t *MP4_BoxGet( MP4_Box_t *p_box, char *psz_fmt, ... );
 829
 830 /*****************************************************************************
 831  * MP4_BoxCount: find number of box given a path relative to p_box
 832  *****************************************************************************
 833  * Path Format: . .. / as usual
 834  *              [number] to specifie box number ex: trak[12]
 835  *
 836  * ex: /moov/trak
 837  *     ../mdia
 838  *****************************************************************************/
 839 int MP4_BoxCount( MP4_Box_t *p_box, char *psz_fmt, ... );
 840
 841
 842
 843 /*---------------------------------------------------------------------------*/
 844 /*                                                                           */
 845 /****---------------------- Medium level functions -----------------------****/
 846 /*                                                                           */
 847 /*---------------------------------------------------------------------------*/
 848
 849 #if 0
 850 /*****************************************************************************
 851  * MP4_CountBox: given a box, count how many child have the requested type
 852  * FIXME : support GUUID
 853  *****************************************************************************/
 854 int MP4_CountBox( MP4_Box_t *p_box, uint32_t i_type );
 855 #endif
 856
 857 /*****************************************************************************
 858  * MP4_FindBox:  find first box with i_type child of p_box
 859  *      return NULL if not found
 860  *****************************************************************************/
 861 MP4_Box_t *MP4_FindBox( MP4_Box_t *p_box, uint32_t i_type );
 862
 863 #if 0
 864 /*****************************************************************************
 865  * MP4_FindNextBox:  find next box with thesame type and at the same level
 866  *                  than p_box
 867  *****************************************************************************/
 868 MP4_Box_t *MP4_FindNextBox( MP4_Box_t *p_box );
 869
 870 /*****************************************************************************
 871  * MP4_FindNbBox:  find the box i_number
 872  *****************************************************************************/
 873 MP4_Box_t *MP4_FindNbBox( MP4_Box_t *p_box, uint32_t i_number );
 874 #endif
 875
 876 /*---------------------------------------------------------------------------*/
 877 /****----------------------- Lower level functions -----------------------****/
 878 /****                                                                     ****/
 879 /****------Use them only when you known what they really do and need------****/
 880 /****                                                                     ****/
 881 /****---------------------------------------------------------------------****/
 882 /*---------------------------------------------------------------------------*/
 883
 884
 885 /****  ------- First some function to make abstract from input --------  */
 886
 887 /****************************************************************************
 888  * MP4_InputStream create an stram with an input
 889  *
 890  ****************************************************************************/
 891 MP4_Stream_t *MP4_InputStream( input_thread_t *p_input );
 892
 893 /****************************************************************************
 894  * MP4_MemoryStream create a memory stream
 895  * if p_buffer == NULL, will allocate a buffer of i_size, else
 896  *     it uses p_buffer XXX you have to unallocate yourself !
 897  *
 898  ****************************************************************************/
 899 MP4_Stream_t *MP4_MemoryStream( input_thread_t *p_input,
 900                                 int i_size, uint8_t *p_buffer );
 901
 902 /****************************************************************************
 903  * MP4_ReadStream read from a MP4_Stream_t
 904  *
 905  ****************************************************************************/
 906 int MP4_ReadStream( MP4_Stream_t *p_stream, uint8_t *p_buff, int i_size );
 907
 908 /****************************************************************************
 909  * MP4_PeekStream guess it ;)
 910  *
 911  ****************************************************************************/
 912 int MP4_PeekStream( MP4_Stream_t *p_stream, uint8_t **pp_peek, int i_size );
 913
 914 /****************************************************************************
 915  * MP4_TellStream give absolute position in the stream
 916  * XXX for a memory stream give position from begining of the buffer
 917  ****************************************************************************/
 918 off_t MP4_TellStream( MP4_Stream_t *p_stream );
 919
 920 /****************************************************************************
 921  * MP4_SeekStream seek in a MP4_Stream_t
 922  *
 923  ****************************************************************************/
 924 int MP4_SeekStream( MP4_Stream_t *p_stream, off_t i_pos);
 925
 926
 927
 928 /*****************************************************************************
 929  * MP4_ReadBox : parse the actual box and the children if they exist
 930  *
 931  *  RETURN : 1 if succes and 0 if it failed
 932  *****************************************************************************/
 933 int MP4_ReadBox( MP4_Stream_t *p_stream, MP4_Box_t *p_box, MP4_Box_t *p_father );
 934
 935
 936 /*****************************************************************************
 937  * MP4_ReadBoxCommon : Load only common parameters for all boxes
 938  *****************************************************************************
 939  * p_box need to be an already allocated MP4_Box_t, and all data
 940  *  will only be peek not read
 941  *
 942  * RETURN : 0 if it fail, 1 otherwise
 943  *****************************************************************************/
 944 int MP4_ReadBoxCommon( MP4_Stream_t *p_stream, MP4_Box_t *p_box );
 945
 946
 947 /*****************************************************************************
 948  * MP4_MP4_GotoBox : Go to this particular box
 949  *****************************************************************************
 950  * RETURN : 0 if it fail, 1 otherwise
 951  *****************************************************************************/
 952 int MP4_GotoBox( MP4_Stream_t *p_stream, MP4_Box_t *p_box );
 953
 954
 955 /*****************************************************************************
 956  * MP4_MP4_NextBox : Go to the next box wiithin p_box->p_father
 957  *****************************************************************************
 958  * if p_box == NULL, go to the next box in witch we are( at the begining ).
 959  *****************************************************************************/
 960 int MP4_NextBox( MP4_Stream_t *p_stream, MP4_Box_t *p_box );
 961
 962