]> git.sesse.net Git - vlc/blob - modules/demux/mp4/libmp4.h
* Stringreview !!!
[vlc] / modules / demux / mp4 / libmp4.h
1 /*****************************************************************************
2  * libmp4.h : LibMP4 library for mp4 module for vlc
3  *****************************************************************************
4  * Copyright (C) 2001-2004 VideoLAN
5  * $Id: libmp4.h,v 1.20 2004/01/25 20:05:28 hartman 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 #define FOURCC_wave VLC_FOURCC( 'w', 'a', 'v', 'e' )
156
157 #define FOURCC_drms VLC_FOURCC( 'd', 'r', 'm', 's' )
158 #define FOURCC_sinf VLC_FOURCC( 's', 'i', 'n', 'f' )
159 #define FOURCC_schi VLC_FOURCC( 's', 'c', 'h', 'i' )
160 #define FOURCC_user VLC_FOURCC( 'u', 's', 'e', 'r' )
161 #define FOURCC_key  VLC_FOURCC( 'k', 'e', 'y', ' ' )
162 #define FOURCC_iviv VLC_FOURCC( 'i', 'v', 'i', 'v' )
163 #define FOURCC_name VLC_FOURCC( 'n', 'a', 'm', 'e' )
164 #define FOURCC_priv VLC_FOURCC( 'p', 'r', 'i', 'v' )
165
166 /* Do you want some debug information on all read boxes ? */
167 #define MP4_VERBOSE  1
168
169 /* memory stream and file stream object */
170
171 typedef struct MP4_Stream_s
172 {
173     int     b_memory;   /* do we uses a memory buffer */
174
175     input_thread_t *p_input;
176
177     off_t   i_start; /* in the buffer position for memory stream */
178     off_t   i_stop;
179     uint8_t *p_buffer;
180
181 } MP4_Stream_t;
182
183 struct MP4_Box_s;
184
185
186 /* uuid Universal Unique IDentifiers */
187 typedef struct UUID_s
188 {
189     uint8_t b[16];
190 } UUID_t;
191
192 /* specific structure for all boxes */
193
194 typedef struct MP4_Box_data_ftyp_s
195 {
196     uint32_t i_major_brand;
197     uint32_t i_minor_version;
198
199     uint32_t i_compatible_brands_count;
200     uint32_t *i_compatible_brands;
201
202 } MP4_Box_data_ftyp_t;
203
204 typedef struct MP4_Box_data_mvhd_s
205 {
206     uint8_t  i_version;
207     uint32_t i_flags;
208
209     uint64_t i_creation_time;
210     uint64_t i_modification_time;
211     uint32_t i_timescale;
212     uint64_t i_duration;
213
214     int32_t  i_rate;
215     int16_t  i_volume;
216     int16_t  i_reserved1;
217     uint32_t i_reserved2[2];
218     int32_t  i_matrix[9];
219     uint32_t i_predefined[6];
220     uint32_t i_next_track_id;
221
222 } MP4_Box_data_mvhd_t;
223
224 #define MP4_TRACK_ENABLED    0x000001
225 #define MP4_TRACK_IN_MOVIE   0x000002
226 #define MP4_TRACK_IN_PREVIEW 0x000004
227 typedef struct MP4_Box_data_tkhd_s
228 {
229     uint8_t  i_version;
230     uint32_t i_flags;
231
232     uint64_t i_creation_time;
233     uint64_t i_modification_time;
234     uint32_t i_track_ID;
235     uint32_t i_reserved;
236     uint64_t i_duration;
237
238     uint32_t i_reserved2[2];
239     int16_t  i_layer;
240     int16_t  i_predefined;
241
242     int16_t  i_volume;
243     uint16_t i_reserved3;
244     int32_t  i_matrix[9];
245     int32_t  i_width;
246     int32_t  i_height;
247
248 } MP4_Box_data_tkhd_t;
249
250 typedef struct MP4_Box_data_mdhd_s
251 {
252     uint8_t  i_version;
253     uint32_t i_flags;
254
255     uint64_t i_creation_time;
256     uint64_t i_modification_time;
257     uint32_t i_timescale;
258     uint64_t i_duration;
259
260     /* one bit for pad */
261     /* unsigned int(5)[3] language difference with 0x60*/
262     unsigned char i_language[3];
263     uint16_t i_predefined;
264
265 } MP4_Box_data_mdhd_t;
266
267 typedef struct MP4_Box_data_hdlr_s
268 {
269     uint8_t  i_version;
270     uint32_t i_flags;
271
272     uint32_t i_predefined;
273     uint32_t i_handler_type; /* "vide" "soun" "hint" "odsm"
274                            "crsm" "sdsm" "m7sm" "ocsm"
275                            "ipsm" "mjsm" */
276
277     unsigned char *psz_name; /* in UTF-8 */
278
279 } MP4_Box_data_hdlr_t;
280
281 typedef struct MP4_Box_data_vmhd_s
282 {
283     uint8_t  i_version;
284     uint32_t i_flags;
285
286     int16_t  i_graphics_mode;
287     int16_t  i_opcolor[3];
288
289 } MP4_Box_data_vmhd_t;
290
291 typedef struct MP4_Box_data_smhd_s
292 {
293     uint8_t  i_version;
294     uint32_t i_flags;
295
296     int16_t  i_balance;
297     int16_t  i_reserved;
298
299 } MP4_Box_data_smhd_t;
300
301 typedef struct MP4_Box_data_hmhd_s
302 {
303     uint8_t  i_version;
304     uint32_t i_flags;
305
306     uint16_t i_max_PDU_size;
307     uint16_t i_avg_PDU_size;
308     uint32_t i_max_bitrate;
309     uint32_t i_avg_bitrate;
310     uint32_t i_reserved;
311
312 } MP4_Box_data_hmhd_t;
313
314 typedef struct MP4_Box_data_url_s
315 {
316     uint8_t  i_version;
317     uint32_t i_flags;
318
319     unsigned char *psz_location;
320
321 } MP4_Box_data_url_t;
322
323 typedef struct MP4_Box_data_urn_s
324 {
325     uint8_t  i_version;
326     uint32_t i_flags;
327
328     unsigned char *psz_name;
329     unsigned char *psz_location;
330
331 } MP4_Box_data_urn_t;
332
333 typedef struct MP4_Box_data_dref_s
334 {
335     uint8_t  i_version;
336     uint32_t i_flags;
337
338     uint32_t i_entry_count;
339 /* XXX it's also a container with i_entry_count entry */
340 } MP4_Box_data_dref_t;
341
342 typedef struct MP4_Box_data_stts_s
343 {
344     uint8_t  i_version;
345     uint32_t i_flags;
346
347     uint32_t i_entry_count;
348     uint32_t *i_sample_count; /* these are array */
349     int32_t  *i_sample_delta;
350
351 } MP4_Box_data_stts_t;
352
353 typedef struct MP4_Box_data_ctts_s
354 {
355     uint8_t  i_version;
356     uint32_t i_flags;
357
358     uint32_t i_entry_count;
359
360     uint32_t *i_sample_count; /* these are array */
361     int32_t  *i_sample_offset;
362
363 } MP4_Box_data_ctts_t;
364
365
366 typedef struct MP4_Box_data_sample_soun_s
367 {
368     uint8_t  i_reserved1[6];
369     uint16_t i_data_reference_index;
370
371     //uint32_t i_reserved2[2];
372     uint16_t i_qt_version;
373     uint16_t i_qt_revision_level;
374     uint32_t i_qt_vendor;
375
376     uint16_t i_channelcount;
377     uint16_t i_samplesize;
378     uint16_t i_predefined;
379     uint16_t i_reserved3;
380     uint16_t i_sampleratehi; /* timescale of track */
381     uint16_t i_sampleratelo;
382
383     /* for version 1 (i_reserved1[0] == 1) */
384     uint32_t i_sample_per_packet;
385     uint32_t i_bytes_per_packet;
386     uint32_t i_bytes_per_frame;
387     uint32_t i_bytes_per_sample;
388
389     /* XXX hack */
390     int     i_qt_description;
391     uint8_t *p_qt_description;
392
393     void    *p_drms;
394
395 } MP4_Box_data_sample_soun_t;
396
397 typedef struct MP4_Box_data_sample_vide_s
398 {
399     uint8_t  i_reserved1[6];
400     uint16_t i_data_reference_index;
401
402     uint16_t i_qt_version;
403     uint16_t i_qt_revision_level;
404     uint32_t i_qt_vendor;
405
406     uint32_t i_qt_temporal_quality;
407     uint32_t i_qt_spatial_quality;
408
409     int16_t  i_width;
410     int16_t  i_height;
411
412     uint32_t i_horizresolution;
413     uint32_t i_vertresolution;
414
415     uint32_t i_qt_data_size;
416     uint16_t i_qt_frame_count;
417
418     uint8_t  i_compressorname[32];
419     int16_t  i_depth;
420
421     int16_t  i_qt_color_table;
422
423     /* XXX hack ImageDescription */
424     int     i_qt_image_description;
425     uint8_t *p_qt_image_description;
426
427 } MP4_Box_data_sample_vide_t;
428
429 typedef struct MP4_Box_data_sample_hint_s
430 {
431     uint8_t  i_reserved1[6];
432     uint16_t i_data_reference_index;
433
434     uint8_t *p_data;
435
436 } MP4_Box_data_sample_hint_t;
437
438 typedef struct MP4_Box_data_moviehintinformation_rtp_s
439 {
440     uint32_t i_description_format;
441     unsigned char *psz_text;
442
443 } MP4_Box_data_moviehintinformation_rtp_t;
444
445
446
447 typedef struct MP4_Box_data_stsd_s
448 {
449     uint8_t  i_version;
450     uint32_t i_flags;
451
452     uint32_t i_entry_count;
453
454     /* it contains SampleEntry handled as if it was Box */
455
456 } MP4_Box_data_stsd_t;
457
458
459 typedef struct MP4_Box_data_stsz_s
460 {
461     uint8_t  i_version;
462     uint32_t i_flags;
463
464     uint32_t i_sample_size;
465     uint32_t i_sample_count;
466
467     uint32_t *i_entry_size; /* array , empty if i_sample_size != 0 */
468
469 } MP4_Box_data_stsz_t;
470
471 typedef struct MP4_Box_data_stz2_s
472 {
473     uint8_t  i_version;
474     uint32_t i_flags;
475
476     uint32_t i_sample_size; /* 24 bits */
477     uint8_t  i_field_size;
478     uint32_t i_sample_count;
479
480     uint32_t *i_entry_size; /* array: unsigned int(i_field_size) entry_size */
481
482 } MP4_Box_data_stz2_t;
483
484 typedef struct MP4_Box_data_stsc_s
485 {
486     uint8_t  i_version;
487     uint32_t i_flags;
488
489     uint32_t i_entry_count;
490
491     uint32_t *i_first_chunk; /* theses are arrays */
492     uint32_t *i_samples_per_chunk;
493     uint32_t *i_sample_description_index;
494
495 } MP4_Box_data_stsc_t;
496
497
498 typedef struct MP4_Box_data_co64_s
499 {
500     uint8_t  i_version;
501     uint32_t i_flags;
502
503     uint32_t i_entry_count;
504
505     uint64_t *i_chunk_offset;
506
507 } MP4_Box_data_co64_t;
508
509
510 typedef struct MP4_Box_data_stss_s
511 {
512     uint8_t  i_version;
513     uint32_t i_flags;
514
515     uint32_t i_entry_count;
516
517     uint32_t *i_sample_number;
518
519 } MP4_Box_data_stss_t;
520
521 typedef struct MP4_Box_data_stsh_s
522 {
523     uint8_t  i_version;
524     uint32_t i_flags;
525
526     uint32_t i_entry_count;
527
528     uint32_t *i_shadowed_sample_number;
529     uint32_t *i_sync_sample_number;
530
531 } MP4_Box_data_stsh_t;
532
533 typedef struct MP4_Box_data_stdp_s
534 {
535     uint8_t  i_version;
536     uint32_t i_flags;
537
538     uint16_t *i_priority;
539
540 } MP4_Box_data_stdp_t;
541
542 typedef struct MP4_Box_data_padb_s
543 {
544     uint8_t  i_version;
545     uint32_t i_flags;
546
547     uint32_t i_sample_count;
548
549     uint16_t *i_reserved1;   /* 1bit  */
550     uint16_t *i_pad2;        /* 3bits */
551     uint16_t *i_reserved2;   /* 1bit  */
552     uint16_t *i_pad1;        /* 3bits */
553
554
555 } MP4_Box_data_padb_t;
556
557
558 typedef struct MP4_Box_data_elst_s
559 {
560     uint8_t  i_version;
561     uint32_t i_flags;
562
563     uint32_t i_entry_count;
564
565     uint64_t *i_segment_duration;
566     int64_t  *i_media_time;
567     uint16_t *i_media_rate_integer;
568     uint16_t *i_media_rate_fraction;
569
570
571 } MP4_Box_data_elst_t;
572
573 typedef struct MP4_Box_data_cprt_s
574 {
575     uint8_t  i_version;
576     uint32_t i_flags;
577     /* 1 pad bit */
578     unsigned char i_language[3];
579
580     unsigned char *psz_notice;
581 } MP4_Box_data_cprt_t;
582
583
584 /* DecoderConfigDescriptor */
585 typedef struct MP4_descriptor_decoder_config_s
586 {
587     uint8_t i_objectTypeIndication;
588     uint8_t i_streamType;
589     int     b_upStream;
590     int     i_buffer_sizeDB;
591     int     i_max_bitrate;
592     int     i_avg_bitrate;
593
594     int     i_decoder_specific_info_len;
595     uint8_t *p_decoder_specific_info;
596     /* some other stuff */
597
598 } MP4_descriptor_decoder_config_t;
599
600 typedef struct MP4_descriptor_SL_config_s
601 {
602
603     int i_dummy; /* ANSI C forbids empty structures */
604
605 } MP4_descriptor_SL_config_t;
606
607
608 typedef struct MP4_descriptor_ES_s
609 {
610     uint16_t i_ES_ID;
611     int      b_stream_dependence;
612     int      b_url;
613     int      b_OCRstream;
614     int      i_stream_priority;
615
616     int      i_depend_on_ES_ID; /* if b_stream_dependence set */
617
618     unsigned char *psz_URL;
619
620     uint16_t i_OCR_ES_ID;       /* if b_OCRstream */
621     MP4_descriptor_decoder_config_t *p_decConfigDescr;
622
623     MP4_descriptor_SL_config_t *p_slConfigDescr;
624
625     /* some other stuff ... */
626
627 } MP4_descriptor_ES_t;
628
629 /* ES descriptor */
630 typedef struct MP4_Box_data_esds_s
631 {
632     uint8_t  i_version;
633     uint32_t i_flags;
634
635     MP4_descriptor_ES_t es_descriptor;
636
637 } MP4_Box_data_esds_t;
638
639
640 typedef struct MP4_Box_data_dcom_s
641 {
642     uint32_t i_algorithm; /* fourcc */
643
644 } MP4_Box_data_dcom_t;
645
646 typedef struct MP4_Box_data_cmvd_s
647 {
648     uint32_t i_uncompressed_size;
649     uint32_t i_compressed_size;
650
651     int     b_compressed; /* Set to 1 if compressed data, 0 if uncompressed */
652     uint8_t *p_data;
653
654 } MP4_Box_data_cmvd_t;
655
656 typedef struct MP4_Box_data_cmov_s
657 {
658     struct MP4_Box_s *p_moov; /* uncompressed moov */
659
660 } MP4_Box_data_cmov_t;
661
662 typedef struct MP4_Box_data_rdrf_s
663 {
664     uint8_t  i_version;
665     uint32_t i_flags;
666
667     uint32_t i_ref_type;
668     char     *psz_ref;
669
670 } MP4_Box_data_rdrf_t;
671
672 typedef struct MP4_Box_data_rmdr_s
673 {
674     uint8_t  i_version;
675     uint32_t i_flags;
676
677     uint32_t i_rate;
678
679 } MP4_Box_data_rmdr_t;
680
681 typedef struct MP4_Box_data_rmvc_s
682 {
683     uint8_t  i_version;
684     uint32_t i_flags;
685
686     uint32_t i_gestaltType;
687     uint32_t i_val1;
688     uint32_t i_val2;
689     uint16_t i_checkType;   /* 0: val1 is version min
690                                1: gestalt value & val2 == val1 */
691
692 } MP4_Box_data_rmvc_t;
693
694 typedef struct MP4_Box_data_rmcd_s
695 {
696     uint8_t  i_version;
697     uint32_t i_flags;
698
699
700 } MP4_Box_data_rmcd_t;
701
702 typedef struct MP4_Box_data_rmqu_s
703 {
704     uint32_t i_quality;
705
706 } MP4_Box_data_rmqu_t;
707
708 /*
709 typedef struct MP4_Box_data__s
710 {
711     uint8_t  i_version;
712     uint32_t i_flags;
713
714 } MP4_Box_data__t;
715
716 */
717
718 typedef union MP4_Box_data_s
719 {
720     MP4_Box_data_ftyp_t *p_ftyp;
721     MP4_Box_data_mvhd_t *p_mvhd;
722     MP4_Box_data_tkhd_t *p_tkhd;
723     MP4_Box_data_mdhd_t *p_mdhd;
724     MP4_Box_data_hdlr_t *p_hdlr;
725     MP4_Box_data_vmhd_t *p_vmhd;
726     MP4_Box_data_smhd_t *p_smhd;
727     MP4_Box_data_hmhd_t *p_hmhd;
728     MP4_Box_data_url_t  *p_url;
729     MP4_Box_data_urn_t  *p_urn;
730     MP4_Box_data_dref_t *p_dref;
731     MP4_Box_data_stts_t *p_stts;
732     MP4_Box_data_ctts_t *p_ctts;
733     MP4_Box_data_stsd_t *p_stsd;
734         MP4_Box_data_sample_vide_t *p_sample_vide;
735         MP4_Box_data_sample_soun_t *p_sample_soun;
736         MP4_Box_data_sample_hint_t *p_sample_hint;
737
738         MP4_Box_data_esds_t *p_esds;
739
740     MP4_Box_data_stsz_t *p_stsz;
741     MP4_Box_data_stz2_t *p_stz2;
742     MP4_Box_data_stsc_t *p_stsc;
743     MP4_Box_data_co64_t *p_co64;
744     MP4_Box_data_stss_t *p_stss;
745     MP4_Box_data_stsh_t *p_stsh;
746     MP4_Box_data_stdp_t *p_stdp;
747     MP4_Box_data_padb_t *p_padb;
748     MP4_Box_data_elst_t *p_elst;
749     MP4_Box_data_cprt_t *p_cprt;
750
751     MP4_Box_data_dcom_t *p_dcom;
752     MP4_Box_data_cmvd_t *p_cmvd;
753     MP4_Box_data_cmov_t *p_cmov;
754
755     MP4_Box_data_moviehintinformation_rtp_t p_moviehintinformation_rtp;
756
757     MP4_Box_data_rdrf_t *p_rdrf;
758     MP4_Box_data_rmdr_t *p_rmdr;
759     MP4_Box_data_rmqu_t *p_rmqu;
760     MP4_Box_data_rmvc_t *p_rmvc;
761
762     void                *p_data; /* for unknow type */
763 } MP4_Box_data_t;
764
765
766
767 /* the most basic structure */
768 typedef struct MP4_Box_s
769 {
770     off_t        i_pos;      /* absolute position */
771
772     uint32_t     i_type;
773     uint32_t     i_shortsize;
774
775     UUID_t       i_uuid;  /* Set if i_type == "uuid" */
776
777     uint64_t     i_size; /* always set so use it */
778
779     MP4_Box_data_t   data;   /* union of pointers on extended data depending
780                                 on i_type (or i_usertype) */
781
782     struct MP4_Box_s *p_father; /* pointer on the father Box */
783
784     struct MP4_Box_s *p_first;  /* pointer on the first child Box */
785     struct MP4_Box_s *p_last;
786
787     struct MP4_Box_s *p_next;   /* pointer on the next boxes at the same level */
788
789 } MP4_Box_t;
790
791
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 MP4_Box_t *MP4_BoxGetRoot( input_thread_t *p_input );
800
801 /*****************************************************************************
802  * MP4_FreeBox : free memory allocated after read with MP4_ReadBox
803  *               or MP4_BoxGetRoot, this means also children boxes
804  * XXX : all children have to be allocated by a malloc !! and
805  *         p_box is freed
806  *****************************************************************************/
807 void MP4_BoxFree( input_thread_t *p_input, MP4_Box_t *p_box );
808
809 /*****************************************************************************
810  * MP4_DumpBoxStructure: print the structure of the p_box
811  *****************************************************************************
812  * Usefull while debugging
813  *****************************************************************************/
814 void MP4_BoxDumpStructure( input_thread_t *p_input, MP4_Box_t *p_box );
815
816
817 /*****************************************************************************
818  * MP4_BoxGet: find a box given a path relative to p_box
819  *****************************************************************************
820  * Path Format: . .. / as usual
821  *              [number] to specifie box number ex: trak[12]
822  *
823  * ex: /moov/trak[12]
824  *     ../mdia
825  *****************************************************************************/
826 MP4_Box_t *MP4_BoxGet( MP4_Box_t *p_box, char *psz_fmt, ... );
827
828 /*****************************************************************************
829  * MP4_BoxCount: find number of box given a path relative to p_box
830  *****************************************************************************
831  * Path Format: . .. / as usual
832  *              [number] to specifie box number ex: trak[12]
833  *
834  * ex: /moov/trak
835  *     ../mdia
836  *****************************************************************************/
837 int MP4_BoxCount( MP4_Box_t *p_box, char *psz_fmt, ... );
838