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