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