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