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