modules/demux/mp4/libmp4.h

   1 /*****************************************************************************
   2  * libmp4.h : LibMP4 library for mp4 module for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2001-2004 the VideoLAN team
   5  * $Id$
   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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  21  *****************************************************************************/
  22 #ifndef _VLC_MP4_H
  23 #define _VLC_MP4_H 1
  24
  25
  26 #define FOURCC_uuid VLC_FOURCC( 'u', 'u', 'i', 'd' )
  27
  28 #define FOURCC_ftyp VLC_FOURCC( 'f', 't', 'y', 'p' )
  29 #define FOURCC_moov VLC_FOURCC( 'm', 'o', 'o', 'v' )
  30 #define FOURCC_foov VLC_FOURCC( 'f', 'o', 'o', 'v' )
  31 #define FOURCC_cmov VLC_FOURCC( 'c', 'm', 'o', 'v' )
  32 #define FOURCC_dcom VLC_FOURCC( 'd', 'c', 'o', 'm' )
  33 #define FOURCC_cmvd VLC_FOURCC( 'c', 'm', 'v', 'd' )
  34
  35 #define FOURCC_moof VLC_FOURCC( 'm', 'o', 'o', 'f' )
  36 #define FOURCC_mdat VLC_FOURCC( 'm', 'd', 'a', 't' )
  37 #define FOURCC_skip VLC_FOURCC( 's', 'k', 'i', 'p' )
  38 #define FOURCC_free VLC_FOURCC( 'f', 'r', 'e', 'e' )
  39 #define FOURCC_udta VLC_FOURCC( 'u', 'd', 't', 'a' )
  40 #define FOURCC_wide VLC_FOURCC( 'w', 'i', 'd', 'e' )
  41
  42 #define FOURCC_trak VLC_FOURCC( 't', 'r', 'a', 'k' )
  43 #define FOURCC_mvhd VLC_FOURCC( 'm', 'v', 'h', 'd' )
  44 #define FOURCC_tkhd VLC_FOURCC( 't', 'k', 'h', 'd' )
  45 #define FOURCC_tref VLC_FOURCC( 't', 'r', 'e', 'f' )
  46 #define FOURCC_mdia VLC_FOURCC( 'm', 'd', 'i', 'a' )
  47 #define FOURCC_mdhd VLC_FOURCC( 'm', 'd', 'h', 'd' )
  48 #define FOURCC_hdlr VLC_FOURCC( 'h', 'd', 'l', 'r' )
  49 #define FOURCC_minf VLC_FOURCC( 'm', 'i', 'n', 'f' )
  50 #define FOURCC_vmhd VLC_FOURCC( 'v', 'm', 'h', 'd' )
  51 #define FOURCC_smhd VLC_FOURCC( 's', 'm', 'h', 'd' )
  52 #define FOURCC_hmhd VLC_FOURCC( 'h', 'm', 'h', 'd' )
  53 #define FOURCC_dinf VLC_FOURCC( 'd', 'i', 'n', 'f' )
  54 #define FOURCC_url  VLC_FOURCC( 'u', 'r', 'l', ' ' )
  55 #define FOURCC_urn  VLC_FOURCC( 'u', 'r', 'n', ' ' )
  56 #define FOURCC_dref VLC_FOURCC( 'd', 'r', 'e', 'f' )
  57 #define FOURCC_stbl VLC_FOURCC( 's', 't', 'b', 'l' )
  58 #define FOURCC_stts VLC_FOURCC( 's', 't', 't', 's' )
  59 #define FOURCC_ctts VLC_FOURCC( 'c', 't', 't', 's' )
  60 #define FOURCC_stsd VLC_FOURCC( 's', 't', 's', 'd' )
  61 #define FOURCC_stsz VLC_FOURCC( 's', 't', 's', 'z' )
  62 #define FOURCC_stz2 VLC_FOURCC( 's', 't', 'z', '2' )
  63 #define FOURCC_stsc VLC_FOURCC( 's', 't', 's', 'c' )
  64 #define FOURCC_stco VLC_FOURCC( 's', 't', 'c', 'o' )
  65 #define FOURCC_co64 VLC_FOURCC( 'c', 'o', '6', '4' )
  66 #define FOURCC_stss VLC_FOURCC( 's', 't', 's', 's' )
  67 #define FOURCC_stsh VLC_FOURCC( 's', 't', 's', 'h' )
  68 #define FOURCC_stdp VLC_FOURCC( 's', 't', 'd', 'p' )
  69 #define FOURCC_padb VLC_FOURCC( 'p', 'a', 'd', 'b' )
  70 #define FOURCC_edts VLC_FOURCC( 'e', 'd', 't', 's' )
  71 #define FOURCC_elst VLC_FOURCC( 'e', 'l', 's', 't' )
  72 #define FOURCC_udta VLC_FOURCC( 'u', 'd', 't', 'a' )
  73 #define FOURCC_mvex VLC_FOURCC( 'm', 'v', 'e', 'x' )
  74 #define FOURCC_trex VLC_FOURCC( 't', 'r', 'e', 'x' )
  75 #define FOURCC_mfhd VLC_FOURCC( 'm', 'f', 'h', 'd' )
  76 #define FOURCC_traf VLC_FOURCC( 't', 'r', 'a', 'f' )
  77 #define FOURCC_tfhd VLC_FOURCC( 't', 'f', 'h', 'd' )
  78 #define FOURCC_trun VLC_FOURCC( 't', 'r', 'u', 'n' )
  79 #define FOURCC_cprt VLC_FOURCC( 'c', 'p', 'r', 't' )
  80 #define FOURCC_iods VLC_FOURCC( 'i', 'o', 'd', 's' )
  81
  82 #define FOURCC_nmhd VLC_FOURCC( 'n', 'm', 'h', 'd' )
  83 #define FOURCC_mp2v VLC_FOURCC( 'm', 'p', '2', 'v' )
  84 #define FOURCC_mp4v VLC_FOURCC( 'm', 'p', '4', 'v' )
  85 #define FOURCC_mp4a VLC_FOURCC( 'm', 'p', '4', 'a' )
  86 #define FOURCC_mp4s VLC_FOURCC( 'm', 'p', '4', 's' )
  87 #define FOURCC_vide VLC_FOURCC( 'v', 'i', 'd', 'e' )
  88 #define FOURCC_soun VLC_FOURCC( 's', 'o', 'u', 'n' )
  89 #define FOURCC_hint VLC_FOURCC( 'h', 'i', 'n', 't' )
  90 #define FOURCC_hdv2 VLC_FOURCC( 'h', 'd', 'v', '2' )
  91
  92 #define FOURCC_dpnd VLC_FOURCC( 'd', 'p', 'n', 'd' )
  93 #define FOURCC_ipir VLC_FOURCC( 'i', 'p', 'i', 'r' )
  94 #define FOURCC_mpod VLC_FOURCC( 'm', 'p', 'o', 'd' )
  95 #define FOURCC_hnti VLC_FOURCC( 'h', 'n', 't', 'i' )
  96 #define FOURCC_rtp  VLC_FOURCC( 'r', 't', 'p', ' ' )
  97
  98 #define FOURCC_isom VLC_FOURCC( 'i', 's', 'o', 'm' )
  99 #define FOURCC_esds VLC_FOURCC( 'e', 's', 'd', 's' )
 100
 101 #define FOURCC__mp3 VLC_FOURCC( '.', 'm', 'p', '3' )
 102 #define FOURCC_ms02 VLC_FOURCC( 'm', 's', 0x0, 0x02 )
 103 #define FOURCC_ms11 VLC_FOURCC( 'm', 's', 0x0, 0x11 )
 104 #define FOURCC_ms55 VLC_FOURCC( 'm', 's', 0x0, 0x55 )
 105 #define FOURCC_twos VLC_FOURCC( 't', 'w', 'o', 's' )
 106 #define FOURCC_sowt VLC_FOURCC( 's', 'o', 'w', 't' )
 107 #define FOURCC_QDMC VLC_FOURCC( 'Q', 'D', 'M', 'C' )
 108 #define FOURCC_QDM2 VLC_FOURCC( 'Q', 'D', 'M', '2' )
 109 #define FOURCC_ima4 VLC_FOURCC( 'i', 'm', 'a', '4' )
 110 #define FOURCC_IMA4 VLC_FOURCC( 'I', 'M', 'A', '4' )
 111 #define FOURCC_dvi  VLC_FOURCC( 'd', 'v', 'i', ' ' )
 112 #define FOURCC_MAC3 VLC_FOURCC( 'M', 'A', 'C', '3' )
 113 #define FOURCC_MAC6 VLC_FOURCC( 'M', 'A', 'C', '6' )
 114 #define FOURCC_alaw VLC_FOURCC( 'a', 'l', 'a', 'w' )
 115 #define FOURCC_ulaw VLC_FOURCC( 'u', 'l', 'a', 'w' )
 116 #define FOURCC_Qclp VLC_FOURCC( 'Q', 'c', 'l', 'p' )
 117 #define FOURCC_samr VLC_FOURCC( 's', 'a', 'm', 'r' )
 118 #define FOURCC_sawb VLC_FOURCC( 's', 'a', 'w', 'b' )
 119 #define FOURCC_OggS VLC_FOURCC( 'O', 'g', 'g', 'S' )
 120 #define FOURCC_alac VLC_FOURCC( 'a', 'l', 'a', 'c' )
 121 #define FOURCC_dac3 VLC_FOURCC( 'd', 'a', 'c', '3' )
 122 #define FOURCC_dec3 VLC_FOURCC( 'd', 'e', 'c', '3' )
 123 #define FOURCC_enda VLC_FOURCC( 'e', 'n', 'd', 'a' )
 124 #define FOURCC_gnre VLC_FOURCC( 'g', 'n', 'r', 'e' )
 125
 126 #define FOURCC_zlib VLC_FOURCC( 'z', 'l', 'i', 'b' )
 127 #define FOURCC_SVQ1 VLC_FOURCC( 'S', 'V', 'Q', '1' )
 128 #define FOURCC_SVQ3 VLC_FOURCC( 'S', 'V', 'Q', '3' )
 129 #define FOURCC_ZyGo VLC_FOURCC( 'Z', 'y', 'G', 'o' )
 130 #define FOURCC_3IV1 VLC_FOURCC( '3', 'I', 'V', '1' )
 131 #define FOURCC_3iv1 VLC_FOURCC( '3', 'i', 'v', '1' )
 132 #define FOURCC_3IV2 VLC_FOURCC( '3', 'I', 'V', '2' )
 133 #define FOURCC_3iv2 VLC_FOURCC( '3', 'i', 'v', '2' )
 134 #define FOURCC_3IVD VLC_FOURCC( '3', 'I', 'V', 'D' )
 135 #define FOURCC_3ivd VLC_FOURCC( '3', 'i', 'v', 'd' )
 136 #define FOURCC_3VID VLC_FOURCC( '3', 'V', 'I', 'D' )
 137 #define FOURCC_3vid VLC_FOURCC( '3', 'v', 'i', 'd' )
 138 #define FOURCC_h263 VLC_FOURCC( 'h', '2', '6', '3' )
 139 #define FOURCC_s263 VLC_FOURCC( 's', '2', '6', '3' )
 140 #define FOURCC_DIVX VLC_FOURCC( 'D', 'I', 'V', 'X' )
 141 #define FOURCC_XVID VLC_FOURCC( 'X', 'V', 'I', 'D' )
 142 #define FOURCC_cvid VLC_FOURCC( 'c', 'v', 'i', 'd' )
 143 #define FOURCC_mjpa VLC_FOURCC( 'm', 'j', 'p', 'a' )
 144 #define FOURCC_mjpb VLC_FOURCC( 'm', 'j', 'q', 't' )
 145 #define FOURCC_mjqt VLC_FOURCC( 'm', 'j', 'h', 't' )
 146 #define FOURCC_mjht VLC_FOURCC( 'm', 'j', 'p', 'b' )
 147 #define FOURCC_VP31 VLC_FOURCC( 'V', 'P', '3', '1' )
 148 #define FOURCC_vp31 VLC_FOURCC( 'v', 'p', '3', '1' )
 149 #define FOURCC_h264 VLC_FOURCC( 'h', '2', '6', '4' )
 150 #define FOURCC_qdrw VLC_FOURCC( 'q', 'd', 'r', 'w' )
 151
 152 #define FOURCC_avc1 VLC_FOURCC( 'a', 'v', 'c', '1' )
 153 #define FOURCC_avcC VLC_FOURCC( 'a', 'v', 'c', 'C' )
 154 #define FOURCC_m4ds VLC_FOURCC( 'm', '4', 'd', 's' )
 155
 156 #define FOURCC_dvc  VLC_FOURCC( 'd', 'v', 'c', ' ' )
 157 #define FOURCC_dvp  VLC_FOURCC( 'd', 'v', 'p', ' ' )
 158 #define FOURCC_dv5n VLC_FOURCC( 'd', 'v', '5', 'n' )
 159 #define FOURCC_dv5p VLC_FOURCC( 'd', 'v', '5', 'p' )
 160 #define FOURCC_raw  VLC_FOURCC( 'r', 'a', 'w', ' ' )
 161
 162 #define FOURCC_jpeg VLC_FOURCC( 'j', 'p', 'e', 'g' )
 163
 164 #define FOURCC_yv12 VLC_FOURCC( 'y', 'v', '1', '2' )
 165 #define FOURCC_yuv2 VLC_FOURCC( 'y', 'u', 'v', '2' )
 166
 167 #define FOURCC_rmra VLC_FOURCC( 'r', 'm', 'r', 'a' )
 168 #define FOURCC_rmda VLC_FOURCC( 'r', 'm', 'd', 'a' )
 169 #define FOURCC_rdrf VLC_FOURCC( 'r', 'd', 'r', 'f' )
 170 #define FOURCC_rmdr VLC_FOURCC( 'r', 'm', 'd', 'r' )
 171 #define FOURCC_rmvc VLC_FOURCC( 'r', 'm', 'v', 'c' )
 172 #define FOURCC_rmcd VLC_FOURCC( 'r', 'm', 'c', 'd' )
 173 #define FOURCC_rmqu VLC_FOURCC( 'r', 'm', 'q', 'u' )
 174 #define FOURCC_alis VLC_FOURCC( 'a', 'l', 'i', 's' )
 175
 176 #define FOURCC_gmhd VLC_FOURCC( 'g', 'm', 'h', 'd' )
 177 #define FOURCC_wave VLC_FOURCC( 'w', 'a', 'v', 'e' )
 178
 179 #define FOURCC_drms VLC_FOURCC( 'd', 'r', 'm', 's' )
 180 #define FOURCC_sinf VLC_FOURCC( 's', 'i', 'n', 'f' )
 181 #define FOURCC_schi VLC_FOURCC( 's', 'c', 'h', 'i' )
 182 #define FOURCC_user VLC_FOURCC( 'u', 's', 'e', 'r' )
 183 #define FOURCC_key  VLC_FOURCC( 'k', 'e', 'y', ' ' )
 184 #define FOURCC_iviv VLC_FOURCC( 'i', 'v', 'i', 'v' )
 185 #define FOURCC_name VLC_FOURCC( 'n', 'a', 'm', 'e' )
 186 #define FOURCC_priv VLC_FOURCC( 'p', 'r', 'i', 'v' )
 187 #define FOURCC_drmi VLC_FOURCC( 'd', 'r', 'm', 'i' )
 188 #define FOURCC_frma VLC_FOURCC( 'f', 'r', 'm', 'a' )
 189 #define FOURCC_skcr VLC_FOURCC( 's', 'k', 'c', 'r' )
 190
 191 #define FOURCC_text VLC_FOURCC( 't', 'e', 'x', 't' )
 192 #define FOURCC_tx3g VLC_FOURCC( 't', 'x', '3', 'g' )
 193 #define FOURCC_subp VLC_FOURCC( 's', 'u', 'b', 'p' )
 194 #define FOURCC_sbtl VLC_FOURCC( 's', 'b', 't', 'l' )
 195
 196 #define FOURCC_0xa9nam VLC_FOURCC( 0xa9, 'n', 'a', 'm' )
 197 #define FOURCC_0xa9aut VLC_FOURCC( 0xa9, 'a', 'u', 't' )
 198 #define FOURCC_0xa9swr VLC_FOURCC( 0xa9, 's', 'w', 'r' )
 199 #define FOURCC_0xa9cpy VLC_FOURCC( 0xa9, 'c', 'p', 'y' )
 200 #define FOURCC_0xa9inf VLC_FOURCC( 0xa9, 'i', 'n', 'f' )
 201 #define FOURCC_0xa9ART VLC_FOURCC( 0xa9, 'A', 'R', 'T' )
 202 #define FOURCC_0xa9des VLC_FOURCC( 0xa9, 'd', 'e', 's' )
 203 #define FOURCC_0xa9dir VLC_FOURCC( 0xa9, 'd', 'i', 'r' )
 204 #define FOURCC_0xa9cmt VLC_FOURCC( 0xa9, 'c', 'm', 't' )
 205 #define FOURCC_0xa9req VLC_FOURCC( 0xa9, 'r', 'e', 'q' )
 206 #define FOURCC_0xa9day VLC_FOURCC( 0xa9, 'd', 'a', 'y' )
 207 #define FOURCC_0xa9fmt VLC_FOURCC( 0xa9, 'f', 'm', 't' )
 208 #define FOURCC_0xa9prd VLC_FOURCC( 0xa9, 'p', 'r', 'd' )
 209 #define FOURCC_0xa9prf VLC_FOURCC( 0xa9, 'p', 'r', 'f' )
 210 #define FOURCC_0xa9src VLC_FOURCC( 0xa9, 's', 'r', 'c' )
 211 #define FOURCC_0xa9alb VLC_FOURCC( 0xa9, 'a', 'l', 'b' )
 212 #define FOURCC_0xa9dis VLC_FOURCC( 0xa9, 'd', 'i', 's' )
 213 #define FOURCC_0xa9enc VLC_FOURCC( 0xa9, 'e', 'n', 'c' )
 214 #define FOURCC_0xa9trk VLC_FOURCC( 0xa9, 't', 'r', 'k' )
 215 #define FOURCC_0xa9url VLC_FOURCC( 0xa9, 'u', 'r', 'l' )
 216 #define FOURCC_0xa9dsa VLC_FOURCC( 0xa9, 'd', 's', 'a' )
 217 #define FOURCC_0xa9hst VLC_FOURCC( 0xa9, 'h', 's', 't' )
 218 #define FOURCC_0xa9ope VLC_FOURCC( 0xa9, 'o', 'p', 'e' )
 219 #define FOURCC_0xa9wrt VLC_FOURCC( 0xa9, 'w', 'r', 't' )
 220 #define FOURCC_0xa9com VLC_FOURCC( 0xa9, 'c', 'o', 'm' )
 221 #define FOURCC_0xa9gen VLC_FOURCC( 0xa9, 'g', 'e', 'n' )
 222 #define FOURCC_chpl VLC_FOURCC( 'c', 'h', 'p', 'l' )
 223 #define FOURCC_WLOC VLC_FOURCC( 'W', 'L', 'O', 'C' )
 224
 225 #define FOURCC_meta VLC_FOURCC( 'm', 'e', 't', 'a' )
 226 #define FOURCC_ilst VLC_FOURCC( 'i', 'l', 's', 't' )
 227
 228 #define FOURCC_chap VLC_FOURCC( 'c', 'h', 'a', 'p' )
 229
 230 /* Do you want some debug information on all read boxes ? */
 231 #define MP4_VERBOSE  1
 232
 233
 234 struct MP4_Box_s;
 235
 236
 237 /* uuid Universal Unique IDentifiers */
 238 typedef struct UUID_s
 239 {
 240     uint8_t b[16];
 241 } UUID_t;
 242
 243 /* specific structure for all boxes */
 244
 245 typedef struct MP4_Box_data_ftyp_s
 246 {
 247     uint32_t i_major_brand;
 248     uint32_t i_minor_version;
 249
 250     uint32_t i_compatible_brands_count;
 251     uint32_t *i_compatible_brands;
 252
 253 } MP4_Box_data_ftyp_t;
 254
 255 typedef struct MP4_Box_data_mvhd_s
 256 {
 257     uint8_t  i_version;
 258     uint32_t i_flags;
 259
 260     uint64_t i_creation_time;
 261     uint64_t i_modification_time;
 262     uint32_t i_timescale;
 263     uint64_t i_duration;
 264
 265     int32_t  i_rate;
 266     int16_t  i_volume;
 267     int16_t  i_reserved1;
 268     uint32_t i_reserved2[2];
 269     int32_t  i_matrix[9];
 270     uint32_t i_predefined[6];
 271     uint32_t i_next_track_id;
 272
 273 } MP4_Box_data_mvhd_t;
 274
 275 #define MP4_TRACK_ENABLED    0x000001
 276 #define MP4_TRACK_IN_MOVIE   0x000002
 277 #define MP4_TRACK_IN_PREVIEW 0x000004
 278 typedef struct MP4_Box_data_tkhd_s
 279 {
 280     uint8_t  i_version;
 281     uint32_t i_flags;
 282
 283     uint64_t i_creation_time;
 284     uint64_t i_modification_time;
 285     uint32_t i_track_ID;
 286     uint32_t i_reserved;
 287     uint64_t i_duration;
 288
 289     uint32_t i_reserved2[2];
 290     int16_t  i_layer;
 291     int16_t  i_predefined;
 292
 293     int16_t  i_volume;
 294     uint16_t i_reserved3;
 295     int32_t  i_matrix[9];
 296     int32_t  i_width;
 297     int32_t  i_height;
 298
 299 } MP4_Box_data_tkhd_t;
 300
 301 typedef struct MP4_Box_data_mdhd_s
 302 {
 303     uint8_t  i_version;
 304     uint32_t i_flags;
 305
 306     uint64_t i_creation_time;
 307     uint64_t i_modification_time;
 308     uint32_t i_timescale;
 309     uint64_t i_duration;
 310
 311     /* one bit for pad */
 312     uint16_t      i_language_code;
 313     /* unsigned int(5)[3] language difference with 0x60*/
 314     unsigned char i_language[3];
 315     uint16_t i_predefined;
 316
 317 } MP4_Box_data_mdhd_t;
 318
 319 typedef struct MP4_Box_data_hdlr_s
 320 {
 321     uint8_t  i_version;
 322     uint32_t i_flags;
 323
 324     uint32_t i_predefined;
 325     uint32_t i_handler_type; /* "vide" "soun" "hint" "odsm"
 326                            "crsm" "sdsm" "m7sm" "ocsm"
 327                            "ipsm" "mjsm" */
 328
 329     unsigned char *psz_name; /* in UTF-8 */
 330
 331 } MP4_Box_data_hdlr_t;
 332
 333 typedef struct MP4_Box_data_vmhd_s
 334 {
 335     uint8_t  i_version;
 336     uint32_t i_flags;
 337
 338     int16_t  i_graphics_mode;
 339     int16_t  i_opcolor[3];
 340
 341 } MP4_Box_data_vmhd_t;
 342
 343 typedef struct MP4_Box_data_smhd_s
 344 {
 345     uint8_t  i_version;
 346     uint32_t i_flags;
 347
 348     int16_t  i_balance;
 349     int16_t  i_reserved;
 350
 351 } MP4_Box_data_smhd_t;
 352
 353 typedef struct MP4_Box_data_hmhd_s
 354 {
 355     uint8_t  i_version;
 356     uint32_t i_flags;
 357
 358     uint16_t i_max_PDU_size;
 359     uint16_t i_avg_PDU_size;
 360     uint32_t i_max_bitrate;
 361     uint32_t i_avg_bitrate;
 362     uint32_t i_reserved;
 363
 364 } MP4_Box_data_hmhd_t;
 365
 366 typedef struct MP4_Box_data_url_s
 367 {
 368     uint8_t  i_version;
 369     uint32_t i_flags;
 370
 371     char *psz_location;
 372
 373 } MP4_Box_data_url_t;
 374
 375 typedef struct MP4_Box_data_urn_s
 376 {
 377     uint8_t  i_version;
 378     uint32_t i_flags;
 379
 380     char *psz_name;
 381     char *psz_location;
 382
 383 } MP4_Box_data_urn_t;
 384
 385 typedef struct MP4_Box_data_dref_s
 386 {
 387     uint8_t  i_version;
 388     uint32_t i_flags;
 389
 390     uint32_t i_entry_count;
 391 /* XXX it's also a container with i_entry_count entry */
 392 } MP4_Box_data_dref_t;
 393
 394 typedef struct MP4_Box_data_stts_s
 395 {
 396     uint8_t  i_version;
 397     uint32_t i_flags;
 398
 399     uint32_t i_entry_count;
 400     uint32_t *i_sample_count; /* these are array */
 401     int32_t  *i_sample_delta;
 402
 403 } MP4_Box_data_stts_t;
 404
 405 typedef struct MP4_Box_data_ctts_s
 406 {
 407     uint8_t  i_version;
 408     uint32_t i_flags;
 409
 410     uint32_t i_entry_count;
 411
 412     uint32_t *i_sample_count; /* these are array */
 413     int32_t  *i_sample_offset;
 414
 415 } MP4_Box_data_ctts_t;
 416
 417
 418 typedef struct MP4_Box_data_sample_soun_s
 419 {
 420     uint8_t  i_reserved1[6];
 421     uint16_t i_data_reference_index;
 422
 423     //uint32_t i_reserved2[2];
 424     uint16_t i_qt_version;
 425     uint16_t i_qt_revision_level;
 426     uint32_t i_qt_vendor;
 427
 428     uint16_t i_channelcount;
 429     uint16_t i_samplesize;
 430     uint16_t i_predefined;
 431     uint16_t i_reserved3;
 432     uint16_t i_sampleratehi; /* timescale of track */
 433     uint16_t i_sampleratelo;
 434
 435     /* for version 1 (i_reserved1[0] == 1) */
 436     uint32_t i_sample_per_packet;
 437     uint32_t i_bytes_per_packet;
 438     uint32_t i_bytes_per_frame;
 439     uint32_t i_bytes_per_sample;
 440
 441     /* XXX hack */
 442     int     i_qt_description;
 443     uint8_t *p_qt_description;
 444
 445     void    *p_drms;
 446
 447 } MP4_Box_data_sample_soun_t;
 448
 449 typedef struct MP4_Box_data_sample_vide_s
 450 {
 451     uint8_t  i_reserved1[6];
 452     uint16_t i_data_reference_index;
 453
 454     uint16_t i_qt_version;
 455     uint16_t i_qt_revision_level;
 456     uint32_t i_qt_vendor;
 457
 458     uint32_t i_qt_temporal_quality;
 459     uint32_t i_qt_spatial_quality;
 460
 461     int16_t  i_width;
 462     int16_t  i_height;
 463
 464     uint32_t i_horizresolution;
 465     uint32_t i_vertresolution;
 466
 467     uint32_t i_qt_data_size;
 468     uint16_t i_qt_frame_count;
 469
 470     uint8_t  i_compressorname[32];
 471     int16_t  i_depth;
 472
 473     int16_t  i_qt_color_table;
 474
 475     /* XXX hack ImageDescription */
 476     int     i_qt_image_description;
 477     uint8_t *p_qt_image_description;
 478
 479     void    *p_drms;
 480
 481 } MP4_Box_data_sample_vide_t;
 482
 483 #define MP4_TEXT_DISPLAY_FLAG_DONT_DISPLAY       (1<<0)
 484 #define MP4_TEXT_DISPLAY_FLAG_AUTO_SCALE         (1<<1)
 485 #define MP4_TEXT_DISPLAY_FLAG_CLIP_TO_TEXT_BOX   (1<<2)
 486 #define MP4_TEXT_DISPLAY_FLAG_USE_MOVIE_BG_COLOR (1<<3)
 487 #define MP4_TEXT_DISPLAY_FLAG_SHRINK_TEXT_BOX_TO_FIT (1<<4)
 488 #define MP4_TEXT_DISPLAY_FLAG_SCROLL_IN          (1<<5)
 489 #define MP4_TEXT_DISPLAY_FLAG_SCROLL_OUT         (1<<6)
 490 #define MP4_TEXT_DISPLAY_FLAG_HORIZONTAL_SCROLL  (1<<7)
 491 #define MP4_TEXT_DISPLAY_FLAG_REVERSE_SCROLL     (1<<8)
 492 #define MP4_TEXT_DISPLAY_FLAG_CONTINUOUS_SCROLL  (1<<9)
 493 #define MP4_TEXT_DISPLAY_FLAG_FLOW_HORIZONTAL    (1<<10)
 494 #define MP4_TEXT_DISPLAY_FLAG_CONTINUOUS_KARAOKE (1<<11)
 495 #define MP4_TEXT_DISPLAY_FLAG_DROP_SHADOW        (1<<12)
 496 #define MP4_TEXT_DISPLAY_FLAG_ANTI_ALIAS         (1<<13)
 497 #define MP4_TEXT_DISPLAY_FLAG_KEYED_TEXT         (1<<14)
 498 #define MP4_TEXT_DISPLAY_FLAG_INVERSE_HILITE     (1<<15)
 499 #define MP4_TEXT_DISPLAY_FLAG_COLOR_HILITE       (1<<16)
 500 #define MP4_TEXT_DISPLAY_FLAG_WRITE_VERTICALLY   (1<<17)
 501
 502 typedef struct
 503 {
 504     uint32_t i_reserved1;
 505     uint16_t i_reserved2;
 506
 507     uint16_t i_data_reference_index;
 508
 509     uint32_t i_display_flags;   // TextDescription and Tx3gDescription
 510
 511     int8_t i_justification_horizontal; // left(0), centered(1), right(-1)
 512     int8_t i_justification_vertical;   // top(0), centered(1), bottom(-1)
 513
 514     uint16_t i_background_color[4];
 515
 516     uint16_t i_text_box_top;
 517     uint16_t i_text_box_left;
 518     uint16_t i_text_box_bottom;
 519     uint16_t i_text_box_right;
 520
 521     // TODO to complete
 522 } MP4_Box_data_sample_text_t;
 523
 524 typedef struct MP4_Box_data_sample_hint_s
 525 {
 526     uint8_t  i_reserved1[6];
 527     uint16_t i_data_reference_index;
 528
 529     uint8_t *p_data;
 530
 531 } MP4_Box_data_sample_hint_t;
 532
 533 typedef struct MP4_Box_data_moviehintinformation_rtp_s
 534 {
 535     uint32_t i_description_format;
 536     unsigned char *psz_text;
 537
 538 } MP4_Box_data_moviehintinformation_rtp_t;
 539
 540
 541
 542 typedef struct MP4_Box_data_stsd_s
 543 {
 544     uint8_t  i_version;
 545     uint32_t i_flags;
 546
 547     uint32_t i_entry_count;
 548
 549     /* it contains SampleEntry handled as if it was Box */
 550
 551 } MP4_Box_data_stsd_t;
 552
 553
 554 typedef struct MP4_Box_data_stsz_s
 555 {
 556     uint8_t  i_version;
 557     uint32_t i_flags;
 558
 559     uint32_t i_sample_size;
 560     uint32_t i_sample_count;
 561
 562     uint32_t *i_entry_size; /* array , empty if i_sample_size != 0 */
 563
 564 } MP4_Box_data_stsz_t;
 565
 566 typedef struct MP4_Box_data_stz2_s
 567 {
 568     uint8_t  i_version;
 569     uint32_t i_flags;
 570
 571     uint32_t i_sample_size; /* 24 bits */
 572     uint8_t  i_field_size;
 573     uint32_t i_sample_count;
 574
 575     uint32_t *i_entry_size; /* array: unsigned int(i_field_size) entry_size */
 576
 577 } MP4_Box_data_stz2_t;
 578
 579 typedef struct MP4_Box_data_stsc_s
 580 {
 581     uint8_t  i_version;
 582     uint32_t i_flags;
 583
 584     uint32_t i_entry_count;
 585
 586     uint32_t *i_first_chunk; /* theses are arrays */
 587     uint32_t *i_samples_per_chunk;
 588     uint32_t *i_sample_description_index;
 589
 590 } MP4_Box_data_stsc_t;
 591
 592
 593 typedef struct MP4_Box_data_co64_s
 594 {
 595     uint8_t  i_version;
 596     uint32_t i_flags;
 597
 598     uint32_t i_entry_count;
 599
 600     uint64_t *i_chunk_offset;
 601
 602 } MP4_Box_data_co64_t;
 603
 604
 605 typedef struct MP4_Box_data_stss_s
 606 {
 607     uint8_t  i_version;
 608     uint32_t i_flags;
 609
 610     uint32_t i_entry_count;
 611
 612     uint32_t *i_sample_number;
 613
 614 } MP4_Box_data_stss_t;
 615
 616 typedef struct MP4_Box_data_stsh_s
 617 {
 618     uint8_t  i_version;
 619     uint32_t i_flags;
 620
 621     uint32_t i_entry_count;
 622
 623     uint32_t *i_shadowed_sample_number;
 624     uint32_t *i_sync_sample_number;
 625
 626 } MP4_Box_data_stsh_t;
 627
 628 typedef struct MP4_Box_data_stdp_s
 629 {
 630     uint8_t  i_version;
 631     uint32_t i_flags;
 632
 633     uint16_t *i_priority;
 634
 635 } MP4_Box_data_stdp_t;
 636
 637 typedef struct MP4_Box_data_padb_s
 638 {
 639     uint8_t  i_version;
 640     uint32_t i_flags;
 641
 642     uint32_t i_sample_count;
 643
 644     uint16_t *i_reserved1;   /* 1bit  */
 645     uint16_t *i_pad2;        /* 3bits */
 646     uint16_t *i_reserved2;   /* 1bit  */
 647     uint16_t *i_pad1;        /* 3bits */
 648
 649
 650 } MP4_Box_data_padb_t;
 651
 652
 653 typedef struct MP4_Box_data_elst_s
 654 {
 655     uint8_t  i_version;
 656     uint32_t i_flags;
 657
 658     uint32_t i_entry_count;
 659
 660     uint64_t *i_segment_duration;
 661     int64_t  *i_media_time;
 662     uint16_t *i_media_rate_integer;
 663     uint16_t *i_media_rate_fraction;
 664
 665
 666 } MP4_Box_data_elst_t;
 667
 668 typedef struct MP4_Box_data_cprt_s
 669 {
 670     uint8_t  i_version;
 671     uint32_t i_flags;
 672     /* 1 pad bit */
 673     unsigned char i_language[3];
 674
 675     char *psz_notice;
 676 } MP4_Box_data_cprt_t;
 677
 678
 679 /* DecoderConfigDescriptor */
 680 typedef struct MP4_descriptor_decoder_config_s
 681 {
 682     uint8_t i_objectTypeIndication;
 683     uint8_t i_streamType;
 684     int     b_upStream;
 685     int     i_buffer_sizeDB;
 686     int     i_max_bitrate;
 687     int     i_avg_bitrate;
 688
 689     int     i_decoder_specific_info_len;
 690     uint8_t *p_decoder_specific_info;
 691     /* some other stuff */
 692
 693 } MP4_descriptor_decoder_config_t;
 694
 695 typedef struct MP4_descriptor_SL_config_s
 696 {
 697
 698     int i_dummy; /* ANSI C forbids empty structures */
 699
 700 } MP4_descriptor_SL_config_t;
 701
 702
 703 typedef struct MP4_descriptor_ES_s
 704 {
 705     uint16_t i_ES_ID;
 706     int      b_stream_dependence;
 707     int      b_url;
 708     int      b_OCRstream;
 709     int      i_stream_priority;
 710
 711     int      i_depend_on_ES_ID; /* if b_stream_dependence set */
 712
 713     unsigned char *psz_URL;
 714
 715     uint16_t i_OCR_ES_ID;       /* if b_OCRstream */
 716     MP4_descriptor_decoder_config_t *p_decConfigDescr;
 717
 718     MP4_descriptor_SL_config_t *p_slConfigDescr;
 719
 720     /* some other stuff ... */
 721
 722 } MP4_descriptor_ES_t;
 723
 724 /* ES descriptor */
 725 typedef struct MP4_Box_data_esds_s
 726 {
 727     uint8_t  i_version;
 728     uint32_t i_flags;
 729
 730     MP4_descriptor_ES_t es_descriptor;
 731
 732 } MP4_Box_data_esds_t;
 733
 734
 735 typedef struct MP4_Box_data_dcom_s
 736 {
 737     uint32_t i_algorithm; /* fourcc */
 738
 739 } MP4_Box_data_dcom_t;
 740
 741 typedef struct MP4_Box_data_cmvd_s
 742 {
 743     uint32_t i_uncompressed_size;
 744     uint32_t i_compressed_size;
 745
 746     int     b_compressed; /* Set to 1 if compressed data, 0 if uncompressed */
 747     uint8_t *p_data;
 748
 749 } MP4_Box_data_cmvd_t;
 750
 751 typedef struct MP4_Box_data_cmov_s
 752 {
 753     struct MP4_Box_s *p_moov; /* uncompressed moov */
 754
 755 } MP4_Box_data_cmov_t;
 756
 757 typedef struct
 758 {
 759     uint32_t i_type;
 760 } MP4_Box_data_frma_t;
 761
 762 typedef struct
 763 {
 764     uint32_t i_init;
 765     uint32_t i_encr;
 766     uint32_t i_decr;
 767 } MP4_Box_data_skcr_t;
 768
 769 typedef struct
 770 {
 771     uint8_t  i_version;
 772     uint32_t i_flags;
 773
 774     uint32_t i_ref_type;
 775     char     *psz_ref;
 776
 777 } MP4_Box_data_rdrf_t;
 778
 779 typedef struct
 780 {
 781     uint8_t  i_version;
 782     uint32_t i_flags;
 783
 784     uint32_t i_rate;
 785
 786 } MP4_Box_data_rmdr_t;
 787
 788 typedef struct
 789 {
 790     uint8_t  i_version;
 791     uint32_t i_flags;
 792
 793     uint32_t i_gestaltType;
 794     uint32_t i_val1;
 795     uint32_t i_val2;
 796     uint16_t i_checkType;   /* 0: val1 is version min
 797                                1: gestalt value & val2 == val1 */
 798
 799 } MP4_Box_data_rmvc_t;
 800
 801 typedef struct
 802 {
 803     uint8_t  i_version;
 804     uint32_t i_flags;
 805
 806
 807 } MP4_Box_data_rmcd_t;
 808
 809 typedef struct
 810 {
 811     uint32_t i_quality;
 812
 813 } MP4_Box_data_rmqu_t;
 814
 815 typedef struct
 816 {
 817     char *psz_text;
 818
 819 } MP4_Box_data_0xa9xxx_t;
 820
 821 typedef struct
 822 {
 823     uint32_t i_entry_count;
 824     uint32_t *i_track_ID;
 825
 826 } MP4_Box_data_tref_generic_t;
 827
 828 typedef struct
 829 {
 830     uint8_t  i_version;
 831     uint32_t i_flags;
 832
 833     uint8_t i_chapter;
 834     struct
 835     {
 836         char    *psz_name;
 837         int64_t  i_start;
 838     } chapter[256];
 839 } MP4_Box_data_chpl_t;
 840
 841 typedef struct
 842 {
 843     uint8_t i_version;
 844     uint8_t i_profile;
 845     uint8_t i_profile_compatibility;
 846     uint8_t i_level;
 847
 848     uint8_t i_reserved1;     /* 6 bits */
 849     uint8_t i_length_size;
 850
 851     uint8_t i_reserved2;    /* 3 bits */
 852     uint8_t  i_sps;
 853     uint16_t *i_sps_length;
 854     uint8_t  **sps;
 855
 856     uint8_t  i_pps;
 857     uint16_t *i_pps_length;
 858     uint8_t  **pps;
 859
 860     /* XXX: Hack raw avcC atom payload */
 861     int     i_avcC;
 862     uint8_t *p_avcC;
 863
 864 } MP4_Box_data_avcC_t;
 865
 866 typedef struct
 867 {
 868     uint8_t i_fscod;
 869     uint8_t i_bsid;
 870     uint8_t i_bsmod;
 871     uint8_t i_acmod;
 872     uint8_t i_lfeon;
 873     uint8_t i_bitrate_code;
 874
 875 } MP4_Box_data_dac3_t;
 876
 877 typedef struct
 878 {
 879     uint16_t i_little_endian;
 880
 881 } MP4_Box_data_enda_t;
 882
 883 typedef struct
 884 {
 885     uint16_t i_genre;
 886
 887 } MP4_Box_data_gnre_t;
 888
 889 /*
 890 typedef struct MP4_Box_data__s
 891 {
 892     uint8_t  i_version;
 893     uint32_t i_flags;
 894
 895 } MP4_Box_data__t;
 896
 897 */
 898
 899 typedef union MP4_Box_data_s
 900 {
 901     MP4_Box_data_ftyp_t *p_ftyp;
 902     MP4_Box_data_mvhd_t *p_mvhd;
 903     MP4_Box_data_tkhd_t *p_tkhd;
 904     MP4_Box_data_mdhd_t *p_mdhd;
 905     MP4_Box_data_hdlr_t *p_hdlr;
 906     MP4_Box_data_vmhd_t *p_vmhd;
 907     MP4_Box_data_smhd_t *p_smhd;
 908     MP4_Box_data_hmhd_t *p_hmhd;
 909     MP4_Box_data_url_t  *p_url;
 910     MP4_Box_data_urn_t  *p_urn;
 911     MP4_Box_data_dref_t *p_dref;
 912     MP4_Box_data_stts_t *p_stts;
 913     MP4_Box_data_ctts_t *p_ctts;
 914     MP4_Box_data_stsd_t *p_stsd;
 915         MP4_Box_data_sample_vide_t *p_sample_vide;
 916         MP4_Box_data_sample_soun_t *p_sample_soun;
 917         MP4_Box_data_sample_text_t *p_sample_text;
 918         MP4_Box_data_sample_hint_t *p_sample_hint;
 919
 920         MP4_Box_data_esds_t *p_esds;
 921         MP4_Box_data_avcC_t *p_avcC;
 922         MP4_Box_data_dac3_t *p_dac3;
 923         MP4_Box_data_enda_t *p_enda;
 924         MP4_Box_data_gnre_t *p_gnre;
 925
 926     MP4_Box_data_stsz_t *p_stsz;
 927     MP4_Box_data_stz2_t *p_stz2;
 928     MP4_Box_data_stsc_t *p_stsc;
 929     MP4_Box_data_co64_t *p_co64;
 930     MP4_Box_data_stss_t *p_stss;
 931     MP4_Box_data_stsh_t *p_stsh;
 932     MP4_Box_data_stdp_t *p_stdp;
 933     MP4_Box_data_padb_t *p_padb;
 934     MP4_Box_data_elst_t *p_elst;
 935     MP4_Box_data_cprt_t *p_cprt;
 936
 937     MP4_Box_data_dcom_t *p_dcom;
 938     MP4_Box_data_cmvd_t *p_cmvd;
 939     MP4_Box_data_cmov_t *p_cmov;
 940
 941     MP4_Box_data_moviehintinformation_rtp_t p_moviehintinformation_rtp;
 942
 943     MP4_Box_data_frma_t *p_frma;
 944     MP4_Box_data_skcr_t *p_skcr;
 945
 946     MP4_Box_data_rdrf_t *p_rdrf;
 947     MP4_Box_data_rmdr_t *p_rmdr;
 948     MP4_Box_data_rmqu_t *p_rmqu;
 949     MP4_Box_data_rmvc_t *p_rmvc;
 950
 951     MP4_Box_data_0xa9xxx_t *p_0xa9xxx;
 952     MP4_Box_data_chpl_t *p_chpl;
 953     MP4_Box_data_tref_generic_t *p_tref_generic;
 954
 955     void                *p_data; /* for unknow type */
 956 } MP4_Box_data_t;
 957
 958
 959
 960 /* the most basic structure */
 961 typedef struct MP4_Box_s
 962 {
 963     off_t        i_pos;      /* absolute position */
 964
 965     uint32_t     i_type;
 966     uint32_t     i_shortsize;
 967
 968     UUID_t       i_uuid;  /* Set if i_type == "uuid" */
 969
 970     uint64_t     i_size; /* always set so use it */
 971
 972     MP4_Box_data_t   data;   /* union of pointers on extended data depending
 973                                 on i_type (or i_usertype) */
 974
 975     struct MP4_Box_s *p_father; /* pointer on the father Box */
 976
 977     struct MP4_Box_s *p_first;  /* pointer on the first child Box */
 978     struct MP4_Box_s *p_last;
 979
 980     struct MP4_Box_s *p_next;   /* pointer on the next boxes at the same level */
 981
 982 } MP4_Box_t;
 983
 984
 985
 986 /*****************************************************************************
 987  * MP4_BoxGetRoot : Parse the entire file, and create all boxes in memory
 988  *****************************************************************************
 989  *  The first box is a virtual box "root" and is the father for all first
 990  *  level boxes
 991  *****************************************************************************/
 992 MP4_Box_t *MP4_BoxGetRoot( stream_t * );
 993
 994 /*****************************************************************************
 995  * MP4_FreeBox : free memory allocated after read with MP4_ReadBox
 996  *               or MP4_BoxGetRoot, this means also children boxes
 997  * XXX : all children have to be allocated by a malloc !! and
 998  *         p_box is freed
 999  *****************************************************************************/
1000 void MP4_BoxFree( stream_t *, MP4_Box_t *p_box );
1001
1002 /*****************************************************************************
1003  * MP4_DumpBoxStructure: print the structure of the p_box
1004  *****************************************************************************
1005  * Usefull while debugging
1006  *****************************************************************************/
1007 void MP4_BoxDumpStructure( stream_t *p_input, MP4_Box_t *p_box );
1008
1009
1010 /*****************************************************************************
1011  * MP4_BoxGet: find a box given a path relative to p_box
1012  *****************************************************************************
1013  * Path Format: . .. / as usual
1014  *              [number] to specifie box number ex: trak[12]
1015  *
1016  * ex: /moov/trak[12]
1017  *     ../mdia
1018  *****************************************************************************/
1019 MP4_Box_t *MP4_BoxGet( MP4_Box_t *p_box, const char *psz_fmt, ... );
1020
1021 /*****************************************************************************
1022  * MP4_BoxCount: find number of box given a path relative to p_box
1023  *****************************************************************************
1024  * Path Format: . .. / as usual
1025  *              [number] to specifie box number ex: trak[12]
1026  *
1027  * ex: /moov/trak
1028  *     ../mdia
1029  *****************************************************************************/
1030 int MP4_BoxCount( MP4_Box_t *p_box, const char *psz_fmt, ... );
1031
1032 int MP4_ReadBoxCommon( stream_t *p_stream, MP4_Box_t *p_box );
1033 int MP4_ReadBox_sample_vide( stream_t *p_stream, MP4_Box_t *p_box );
1034 void MP4_FreeBox_sample_vide( MP4_Box_t *p_box );
1035
1036 #endif