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