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