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