]> git.sesse.net Git - vlc/blob - modules/demux/mp4/libmp4.h
MP4: update Copyright
[vlc] / modules / demux / mp4 / libmp4.h
1 /*****************************************************************************
2  * libmp4.h : LibMP4 library for mp4 module for vlc
3  *****************************************************************************
4  * Copyright (C) 2001-2004, 2010 the VideoLAN team
5  * $Id$
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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
21  *****************************************************************************/
22 #ifndef _VLC_MP4_H
23 #define _VLC_MP4_H 1
24
25
26 #define FOURCC_uuid VLC_FOURCC( 'u', 'u', 'i', 'd' )
27
28 #define FOURCC_ftyp VLC_FOURCC( 'f', 't', 'y', 'p' )
29 #define FOURCC_moov VLC_FOURCC( 'm', 'o', 'o', 'v' )
30 #define FOURCC_foov VLC_FOURCC( 'f', 'o', 'o', 'v' )
31 #define FOURCC_cmov VLC_FOURCC( 'c', 'm', 'o', 'v' )
32 #define FOURCC_dcom VLC_FOURCC( 'd', 'c', 'o', 'm' )
33 #define FOURCC_cmvd VLC_FOURCC( 'c', 'm', 'v', 'd' )
34
35 #define FOURCC_moof VLC_FOURCC( 'm', 'o', 'o', 'f' )
36 #define FOURCC_mdat VLC_FOURCC( 'm', 'd', 'a', 't' )
37 #define FOURCC_skip VLC_FOURCC( 's', 'k', 'i', 'p' )
38 #define FOURCC_free VLC_FOURCC( 'f', 'r', 'e', 'e' )
39 #define FOURCC_udta VLC_FOURCC( 'u', 'd', 't', 'a' )
40 #define FOURCC_wide VLC_FOURCC( 'w', 'i', 'd', 'e' )
41
42 #define FOURCC_trak VLC_FOURCC( 't', 'r', 'a', 'k' )
43 #define FOURCC_mvhd VLC_FOURCC( 'm', 'v', 'h', 'd' )
44 #define FOURCC_tkhd VLC_FOURCC( 't', 'k', 'h', 'd' )
45 #define FOURCC_tref VLC_FOURCC( 't', 'r', 'e', 'f' )
46 #define FOURCC_mdia VLC_FOURCC( 'm', 'd', 'i', 'a' )
47 #define FOURCC_mdhd VLC_FOURCC( 'm', 'd', 'h', 'd' )
48 #define FOURCC_hdlr VLC_FOURCC( 'h', 'd', 'l', 'r' )
49 #define FOURCC_minf VLC_FOURCC( 'm', 'i', 'n', 'f' )
50 #define FOURCC_vmhd VLC_FOURCC( 'v', 'm', 'h', 'd' )
51 #define FOURCC_smhd VLC_FOURCC( 's', 'm', 'h', 'd' )
52 #define FOURCC_hmhd VLC_FOURCC( 'h', 'm', 'h', 'd' )
53 #define FOURCC_dinf VLC_FOURCC( 'd', 'i', 'n', 'f' )
54 #define FOURCC_url  VLC_FOURCC( 'u', 'r', 'l', ' ' )
55 #define FOURCC_urn  VLC_FOURCC( 'u', 'r', 'n', ' ' )
56 #define FOURCC_dref VLC_FOURCC( 'd', 'r', 'e', 'f' )
57 #define FOURCC_stbl VLC_FOURCC( 's', 't', 'b', 'l' )
58 #define FOURCC_stts VLC_FOURCC( 's', 't', 't', 's' )
59 #define FOURCC_ctts VLC_FOURCC( 'c', 't', 't', 's' )
60 #define FOURCC_stsd VLC_FOURCC( 's', 't', 's', 'd' )
61 #define FOURCC_stsz VLC_FOURCC( 's', 't', 's', 'z' )
62 #define FOURCC_stz2 VLC_FOURCC( 's', 't', 'z', '2' )
63 #define FOURCC_stsc VLC_FOURCC( 's', 't', 's', 'c' )
64 #define FOURCC_stco VLC_FOURCC( 's', 't', 'c', 'o' )
65 #define FOURCC_co64 VLC_FOURCC( 'c', 'o', '6', '4' )
66 #define FOURCC_stss VLC_FOURCC( 's', 't', 's', 's' )
67 #define FOURCC_stsh VLC_FOURCC( 's', 't', 's', 'h' )
68 #define FOURCC_stdp VLC_FOURCC( 's', 't', 'd', 'p' )
69 #define FOURCC_padb VLC_FOURCC( 'p', 'a', 'd', 'b' )
70 #define FOURCC_edts VLC_FOURCC( 'e', 'd', 't', 's' )
71 #define FOURCC_elst VLC_FOURCC( 'e', 'l', 's', 't' )
72 #define FOURCC_udta VLC_FOURCC( 'u', 'd', 't', 'a' )
73 #define FOURCC_mvex VLC_FOURCC( 'm', 'v', 'e', 'x' )
74 #define FOURCC_trex VLC_FOURCC( 't', 'r', 'e', 'x' )
75 #define FOURCC_mfhd VLC_FOURCC( 'm', 'f', 'h', 'd' )
76 #define FOURCC_traf VLC_FOURCC( 't', 'r', 'a', 'f' )
77 #define FOURCC_tfhd VLC_FOURCC( 't', 'f', 'h', 'd' )
78 #define FOURCC_trun VLC_FOURCC( 't', 'r', 'u', 'n' )
79 #define FOURCC_cprt VLC_FOURCC( 'c', 'p', 'r', 't' )
80 #define FOURCC_iods VLC_FOURCC( 'i', 'o', 'd', 's' )
81
82 #define FOURCC_nmhd VLC_FOURCC( 'n', 'm', 'h', 'd' )
83 #define FOURCC_mp2v VLC_FOURCC( 'm', 'p', '2', 'v' )
84 #define FOURCC_mp4v VLC_FOURCC( 'm', 'p', '4', 'v' )
85 #define FOURCC_mp4a VLC_FOURCC( 'm', 'p', '4', 'a' )
86 #define FOURCC_mp4s VLC_FOURCC( 'm', 'p', '4', 's' )
87 #define FOURCC_vide VLC_FOURCC( 'v', 'i', 'd', 'e' )
88 #define FOURCC_soun VLC_FOURCC( 's', 'o', 'u', 'n' )
89 #define FOURCC_hint VLC_FOURCC( 'h', 'i', 'n', 't' )
90 #define FOURCC_hdv2 VLC_FOURCC( 'h', 'd', 'v', '2' )
91
92 #define FOURCC_dpnd VLC_FOURCC( 'd', 'p', 'n', 'd' )
93 #define FOURCC_ipir VLC_FOURCC( 'i', 'p', 'i', 'r' )
94 #define FOURCC_mpod VLC_FOURCC( 'm', 'p', 'o', 'd' )
95 #define FOURCC_hnti VLC_FOURCC( 'h', 'n', 't', 'i' )
96 #define FOURCC_rtp  VLC_FOURCC( 'r', 't', 'p', ' ' )
97
98 #define FOURCC_isom VLC_FOURCC( 'i', 's', 'o', 'm' )
99 #define FOURCC_esds VLC_FOURCC( 'e', 's', 'd', 's' )
100
101 #define FOURCC__mp3 VLC_FOURCC( '.', 'm', 'p', '3' )
102 #define FOURCC_ms02 VLC_FOURCC( 'm', 's', 0x0, 0x02 )
103 #define FOURCC_ms11 VLC_FOURCC( 'm', 's', 0x0, 0x11 )
104 #define FOURCC_ms55 VLC_FOURCC( 'm', 's', 0x0, 0x55 )
105 #define FOURCC_twos VLC_FOURCC( 't', 'w', 'o', 's' )
106 #define FOURCC_sowt VLC_FOURCC( 's', 'o', 'w', 't' )
107 #define FOURCC_QDMC VLC_FOURCC( 'Q', 'D', 'M', 'C' )
108 #define FOURCC_QDM2 VLC_FOURCC( 'Q', 'D', 'M', '2' )
109 #define FOURCC_ima4 VLC_FOURCC( 'i', 'm', 'a', '4' )
110 #define FOURCC_IMA4 VLC_FOURCC( 'I', 'M', 'A', '4' )
111 #define FOURCC_dvi  VLC_FOURCC( 'd', 'v', 'i', ' ' )
112 #define FOURCC_MAC3 VLC_FOURCC( 'M', 'A', 'C', '3' )
113 #define FOURCC_MAC6 VLC_FOURCC( 'M', 'A', 'C', '6' )
114 #define FOURCC_alaw VLC_FOURCC( 'a', 'l', 'a', 'w' )
115 #define FOURCC_ulaw VLC_FOURCC( 'u', 'l', 'a', 'w' )
116 #define FOURCC_Qclp VLC_FOURCC( 'Q', 'c', 'l', 'p' )
117 #define FOURCC_samr VLC_FOURCC( 's', 'a', 'm', 'r' )
118 #define FOURCC_sawb VLC_FOURCC( 's', 'a', 'w', 'b' )
119 #define FOURCC_OggS VLC_FOURCC( 'O', 'g', 'g', 'S' )
120 #define FOURCC_alac VLC_FOURCC( 'a', 'l', 'a', 'c' )
121 #define FOURCC_dac3 VLC_FOURCC( 'd', 'a', 'c', '3' )
122 #define FOURCC_dec3 VLC_FOURCC( 'd', 'e', 'c', '3' )
123 #define FOURCC_enda VLC_FOURCC( 'e', 'n', 'd', 'a' )
124 #define FOURCC_gnre VLC_FOURCC( 'g', 'n', 'r', 'e' )
125 #define FOURCC_trkn VLC_FOURCC( 't', 'r', 'k', 'n' )
126
127 #define FOURCC_zlib VLC_FOURCC( 'z', 'l', 'i', 'b' )
128 #define FOURCC_SVQ1 VLC_FOURCC( 'S', 'V', 'Q', '1' )
129 #define FOURCC_SVQ3 VLC_FOURCC( 'S', 'V', 'Q', '3' )
130 #define FOURCC_ZyGo VLC_FOURCC( 'Z', 'y', 'G', 'o' )
131 #define FOURCC_3IV1 VLC_FOURCC( '3', 'I', 'V', '1' )
132 #define FOURCC_3iv1 VLC_FOURCC( '3', 'i', 'v', '1' )
133 #define FOURCC_3IV2 VLC_FOURCC( '3', 'I', 'V', '2' )
134 #define FOURCC_3iv2 VLC_FOURCC( '3', 'i', 'v', '2' )
135 #define FOURCC_3IVD VLC_FOURCC( '3', 'I', 'V', 'D' )
136 #define FOURCC_3ivd VLC_FOURCC( '3', 'i', 'v', 'd' )
137 #define FOURCC_3VID VLC_FOURCC( '3', 'V', 'I', 'D' )
138 #define FOURCC_3vid VLC_FOURCC( '3', 'v', 'i', 'd' )
139 #define FOURCC_h263 VLC_FOURCC( 'h', '2', '6', '3' )
140 #define FOURCC_s263 VLC_FOURCC( 's', '2', '6', '3' )
141 #define FOURCC_DIVX VLC_FOURCC( 'D', 'I', 'V', 'X' )
142 #define FOURCC_XVID VLC_FOURCC( 'X', 'V', 'I', 'D' )
143 #define FOURCC_cvid VLC_FOURCC( 'c', 'v', 'i', 'd' )
144 #define FOURCC_mjpa VLC_FOURCC( 'm', 'j', 'p', 'a' )
145 #define FOURCC_mjpb VLC_FOURCC( 'm', 'j', 'q', 't' )
146 #define FOURCC_mjqt VLC_FOURCC( 'm', 'j', 'h', 't' )
147 #define FOURCC_mjht VLC_FOURCC( 'm', 'j', 'p', 'b' )
148 #define FOURCC_VP31 VLC_FOURCC( 'V', 'P', '3', '1' )
149 #define FOURCC_vp31 VLC_FOURCC( 'v', 'p', '3', '1' )
150 #define FOURCC_h264 VLC_FOURCC( 'h', '2', '6', '4' )
151 #define FOURCC_qdrw VLC_FOURCC( 'q', 'd', 'r', 'w' )
152
153 #define FOURCC_avc1 VLC_FOURCC( 'a', 'v', 'c', '1' )
154 #define FOURCC_avcC VLC_FOURCC( 'a', 'v', 'c', 'C' )
155 #define FOURCC_m4ds VLC_FOURCC( 'm', '4', 'd', 's' )
156
157 #define FOURCC_dvc  VLC_FOURCC( 'd', 'v', 'c', ' ' )
158 #define FOURCC_dvp  VLC_FOURCC( 'd', 'v', 'p', ' ' )
159 #define FOURCC_dv5n VLC_FOURCC( 'd', 'v', '5', 'n' )
160 #define FOURCC_dv5p VLC_FOURCC( 'd', 'v', '5', 'p' )
161 #define FOURCC_raw  VLC_FOURCC( 'r', 'a', 'w', ' ' )
162
163 #define FOURCC_jpeg VLC_FOURCC( 'j', 'p', 'e', 'g' )
164
165 #define FOURCC_yv12 VLC_FOURCC( 'y', 'v', '1', '2' )
166 #define FOURCC_yuv2 VLC_FOURCC( 'y', 'u', 'v', '2' )
167
168 #define FOURCC_rmra VLC_FOURCC( 'r', 'm', 'r', 'a' )
169 #define FOURCC_rmda VLC_FOURCC( 'r', 'm', 'd', 'a' )
170 #define FOURCC_rdrf VLC_FOURCC( 'r', 'd', 'r', 'f' )
171 #define FOURCC_rmdr VLC_FOURCC( 'r', 'm', 'd', 'r' )
172 #define FOURCC_rmvc VLC_FOURCC( 'r', 'm', 'v', 'c' )
173 #define FOURCC_rmcd VLC_FOURCC( 'r', 'm', 'c', 'd' )
174 #define FOURCC_rmqu VLC_FOURCC( 'r', 'm', 'q', 'u' )
175 #define FOURCC_alis VLC_FOURCC( 'a', 'l', 'i', 's' )
176
177 #define FOURCC_gmhd VLC_FOURCC( 'g', 'm', 'h', 'd' )
178 #define FOURCC_wave VLC_FOURCC( 'w', 'a', 'v', 'e' )
179
180 #define FOURCC_drms VLC_FOURCC( 'd', 'r', 'm', 's' )
181 #define FOURCC_sinf VLC_FOURCC( 's', 'i', 'n', 'f' )
182 #define FOURCC_schi VLC_FOURCC( 's', 'c', 'h', 'i' )
183 #define FOURCC_user VLC_FOURCC( 'u', 's', 'e', 'r' )
184 #define FOURCC_key  VLC_FOURCC( 'k', 'e', 'y', ' ' )
185 #define FOURCC_iviv VLC_FOURCC( 'i', 'v', 'i', 'v' )
186 #define FOURCC_name VLC_FOURCC( 'n', 'a', 'm', 'e' )
187 #define FOURCC_priv VLC_FOURCC( 'p', 'r', 'i', 'v' )
188 #define FOURCC_drmi VLC_FOURCC( 'd', 'r', 'm', 'i' )
189 #define FOURCC_frma VLC_FOURCC( 'f', 'r', 'm', 'a' )
190 #define FOURCC_skcr VLC_FOURCC( 's', 'k', 'c', 'r' )
191
192 #define FOURCC_text VLC_FOURCC( 't', 'e', 'x', 't' )
193 #define FOURCC_tx3g VLC_FOURCC( 't', 'x', '3', 'g' )
194 #define FOURCC_subp VLC_FOURCC( 's', 'u', 'b', 'p' )
195 #define FOURCC_sbtl VLC_FOURCC( 's', 'b', 't', 'l' )
196
197 #define FOURCC_0xa9nam VLC_FOURCC( 0xa9, 'n', 'a', 'm' )
198 #define FOURCC_0xa9aut VLC_FOURCC( 0xa9, 'a', 'u', 't' )
199 #define FOURCC_0xa9cpy VLC_FOURCC( 0xa9, 'c', 'p', 'y' )
200 #define FOURCC_0xa9inf VLC_FOURCC( 0xa9, 'i', 'n', 'f' )
201 #define FOURCC_0xa9ART VLC_FOURCC( 0xa9, 'A', 'R', 'T' )
202 #define FOURCC_0xa9des VLC_FOURCC( 0xa9, 'd', 'e', 's' )
203 #define FOURCC_0xa9dir VLC_FOURCC( 0xa9, 'd', 'i', 'r' )
204 #define FOURCC_0xa9cmt VLC_FOURCC( 0xa9, 'c', 'm', 't' )
205 #define FOURCC_0xa9req VLC_FOURCC( 0xa9, 'r', 'e', 'q' )
206 #define FOURCC_0xa9day VLC_FOURCC( 0xa9, 'd', 'a', 'y' )
207 #define FOURCC_0xa9fmt VLC_FOURCC( 0xa9, 'f', 'm', 't' )
208 #define FOURCC_0xa9prd VLC_FOURCC( 0xa9, 'p', 'r', 'd' )
209 #define FOURCC_0xa9prf VLC_FOURCC( 0xa9, 'p', 'r', 'f' )
210 #define FOURCC_0xa9src VLC_FOURCC( 0xa9, 's', 'r', 'c' )
211 #define FOURCC_0xa9alb VLC_FOURCC( 0xa9, 'a', 'l', 'b' )
212 #define FOURCC_0xa9dis VLC_FOURCC( 0xa9, 'd', 'i', 's' )
213 #define FOURCC_0xa9enc VLC_FOURCC( 0xa9, 'e', 'n', 'c' )
214 #define FOURCC_0xa9trk VLC_FOURCC( 0xa9, 't', 'r', 'k' )
215 #define FOURCC_0xa9url VLC_FOURCC( 0xa9, 'u', 'r', 'l' )
216 #define FOURCC_0xa9dsa VLC_FOURCC( 0xa9, 'd', 's', 'a' )
217 #define FOURCC_0xa9hst VLC_FOURCC( 0xa9, 'h', 's', 't' )
218 #define FOURCC_0xa9ope VLC_FOURCC( 0xa9, 'o', 'p', 'e' )
219 #define FOURCC_0xa9wrt VLC_FOURCC( 0xa9, 'w', 'r', 't' )
220 #define FOURCC_0xa9com VLC_FOURCC( 0xa9, 'c', 'o', 'm' )
221 #define FOURCC_0xa9gen VLC_FOURCC( 0xa9, 'g', 'e', 'n' )
222 #define FOURCC_0xa9too VLC_FOURCC( 0xa9, 't', 'o', 'o' )
223 #define FOURCC_0xa9wrn VLC_FOURCC( 0xa9, 'w', 'r', 'n' )
224 #define FOURCC_0xa9swr VLC_FOURCC( 0xa9, 's', 'w', 'r' )
225 #define FOURCC_0xa9mak VLC_FOURCC( 0xa9, 'm', 'a', 'k' )
226 #define FOURCC_0xa9mod VLC_FOURCC( 0xa9, 'm', 'o', 'd' )
227 #define FOURCC_0xa9PRD VLC_FOURCC( 0xa9, 'P', 'R', 'D' )
228 #define FOURCC_0xa9grp VLC_FOURCC( 0xa9, 'g', 'r', 'p' )
229 #define FOURCC_0xa9lyr VLC_FOURCC( 0xa9, 'g', 'r', 'p' )
230 #define FOURCC_chpl VLC_FOURCC( 'c', 'h', 'p', 'l' )
231 #define FOURCC_WLOC VLC_FOURCC( 'W', 'L', 'O', 'C' )
232
233 #define FOURCC_meta VLC_FOURCC( 'm', 'e', 't', 'a' )
234 #define FOURCC_ilst VLC_FOURCC( 'i', 'l', 's', 't' )
235
236 #define FOURCC_chap VLC_FOURCC( 'c', 'h', 'a', 'p' )
237
238 /* Do you want some debug information on all read boxes ? */
239 #define MP4_VERBOSE  1
240
241
242 struct MP4_Box_s;
243
244
245 /* uuid Universal Unique IDentifiers */
246 typedef struct UUID_s
247 {
248     uint8_t b[16];
249 } UUID_t;
250
251 /* specific structure for all boxes */
252
253 typedef struct MP4_Box_data_ftyp_s
254 {
255     uint32_t i_major_brand;
256     uint32_t i_minor_version;
257
258     uint32_t i_compatible_brands_count;
259     uint32_t *i_compatible_brands;
260
261 } MP4_Box_data_ftyp_t;
262
263 typedef struct MP4_Box_data_mvhd_s
264 {
265     uint8_t  i_version;
266     uint32_t i_flags;
267
268     uint64_t i_creation_time;
269     uint64_t i_modification_time;
270     uint32_t i_timescale;
271     uint64_t i_duration;
272
273     int32_t  i_rate;
274     int16_t  i_volume;
275     int16_t  i_reserved1;
276     uint32_t i_reserved2[2];
277     int32_t  i_matrix[9];
278     uint32_t i_predefined[6];
279     uint32_t i_next_track_id;
280
281 } MP4_Box_data_mvhd_t;
282
283 #define MP4_TRACK_ENABLED    0x000001
284 #define MP4_TRACK_IN_MOVIE   0x000002
285 #define MP4_TRACK_IN_PREVIEW 0x000004
286 typedef struct MP4_Box_data_tkhd_s
287 {
288     uint8_t  i_version;
289     uint32_t i_flags;
290
291     uint64_t i_creation_time;
292     uint64_t i_modification_time;
293     uint32_t i_track_ID;
294     uint32_t i_reserved;
295     uint64_t i_duration;
296
297     uint32_t i_reserved2[2];
298     int16_t  i_layer;
299     int16_t  i_predefined;
300
301     int16_t  i_volume;
302     uint16_t i_reserved3;
303     int32_t  i_matrix[9];
304     int32_t  i_width;
305     int32_t  i_height;
306
307 } MP4_Box_data_tkhd_t;
308
309 typedef struct MP4_Box_data_mdhd_s
310 {
311     uint8_t  i_version;
312     uint32_t i_flags;
313
314     uint64_t i_creation_time;
315     uint64_t i_modification_time;
316     uint32_t i_timescale;
317     uint64_t i_duration;
318
319     /* one bit for pad */
320     uint16_t      i_language_code;
321     /* unsigned int(5)[3] language difference with 0x60*/
322     unsigned char i_language[3];
323     uint16_t i_predefined;
324
325 } MP4_Box_data_mdhd_t;
326
327 typedef struct MP4_Box_data_hdlr_s
328 {
329     uint8_t  i_version;
330     uint32_t i_flags;
331
332     uint32_t i_predefined;
333     uint32_t i_handler_type; /* "vide" "soun" "hint" "odsm"
334                            "crsm" "sdsm" "m7sm" "ocsm"
335                            "ipsm" "mjsm" */
336
337     unsigned char *psz_name; /* in UTF-8 */
338
339 } MP4_Box_data_hdlr_t;
340
341 typedef struct MP4_Box_data_vmhd_s
342 {
343     uint8_t  i_version;
344     uint32_t i_flags;
345
346     int16_t  i_graphics_mode;
347     int16_t  i_opcolor[3];
348
349 } MP4_Box_data_vmhd_t;
350
351 typedef struct MP4_Box_data_smhd_s
352 {
353     uint8_t  i_version;
354     uint32_t i_flags;
355
356     int16_t  i_balance;
357     int16_t  i_reserved;
358
359 } MP4_Box_data_smhd_t;
360
361 typedef struct MP4_Box_data_hmhd_s
362 {
363     uint8_t  i_version;
364     uint32_t i_flags;
365
366     uint16_t i_max_PDU_size;
367     uint16_t i_avg_PDU_size;
368     uint32_t i_max_bitrate;
369     uint32_t i_avg_bitrate;
370     uint32_t i_reserved;
371
372 } MP4_Box_data_hmhd_t;
373
374 typedef struct MP4_Box_data_url_s
375 {
376     uint8_t  i_version;
377     uint32_t i_flags;
378
379     char *psz_location;
380
381 } MP4_Box_data_url_t;
382
383 typedef struct MP4_Box_data_urn_s
384 {
385     uint8_t  i_version;
386     uint32_t i_flags;
387
388     char *psz_name;
389     char *psz_location;
390
391 } MP4_Box_data_urn_t;
392
393 typedef struct MP4_Box_data_dref_s
394 {
395     uint8_t  i_version;
396     uint32_t i_flags;
397
398     uint32_t i_entry_count;
399 /* XXX it's also a container with i_entry_count entry */
400 } MP4_Box_data_dref_t;
401
402 typedef struct MP4_Box_data_stts_s
403 {
404     uint8_t  i_version;
405     uint32_t i_flags;
406
407     uint32_t i_entry_count;
408     uint32_t *i_sample_count; /* these are array */
409     int32_t  *i_sample_delta;
410
411 } MP4_Box_data_stts_t;
412
413 typedef struct MP4_Box_data_ctts_s
414 {
415     uint8_t  i_version;
416     uint32_t i_flags;
417
418     uint32_t i_entry_count;
419
420     uint32_t *i_sample_count; /* these are array */
421     int32_t  *i_sample_offset;
422
423 } MP4_Box_data_ctts_t;
424
425
426 typedef struct MP4_Box_data_sample_soun_s
427 {
428     uint8_t  i_reserved1[6];
429     uint16_t i_data_reference_index;
430
431     //uint32_t i_reserved2[2];
432     uint16_t i_qt_version;
433     uint16_t i_qt_revision_level;
434     uint32_t i_qt_vendor;
435
436     uint16_t i_channelcount;
437     uint16_t i_samplesize;
438     uint16_t i_predefined;
439     uint16_t i_reserved3;
440     uint16_t i_sampleratehi; /* timescale of track */
441     uint16_t i_sampleratelo;
442
443     /* for version 1 (i_reserved1[0] == 1) */
444     uint32_t i_sample_per_packet;
445     uint32_t i_bytes_per_packet;
446     uint32_t i_bytes_per_frame;
447     uint32_t i_bytes_per_sample;
448
449     /* XXX hack */
450     int     i_qt_description;
451     uint8_t *p_qt_description;
452
453     void    *p_drms;
454
455 } MP4_Box_data_sample_soun_t;
456
457 typedef struct MP4_Box_data_sample_vide_s
458 {
459     uint8_t  i_reserved1[6];
460     uint16_t i_data_reference_index;
461
462     uint16_t i_qt_version;
463     uint16_t i_qt_revision_level;
464     uint32_t i_qt_vendor;
465
466     uint32_t i_qt_temporal_quality;
467     uint32_t i_qt_spatial_quality;
468
469     int16_t  i_width;
470     int16_t  i_height;
471
472     uint32_t i_horizresolution;
473     uint32_t i_vertresolution;
474
475     uint32_t i_qt_data_size;
476     uint16_t i_qt_frame_count;
477
478     uint8_t  i_compressorname[32];
479     int16_t  i_depth;
480
481     int16_t  i_qt_color_table;
482
483     /* XXX hack ImageDescription */
484     int     i_qt_image_description;
485     uint8_t *p_qt_image_description;
486
487     void    *p_drms;
488
489 } MP4_Box_data_sample_vide_t;
490
491 #define MP4_TEXT_DISPLAY_FLAG_DONT_DISPLAY       (1<<0)
492 #define MP4_TEXT_DISPLAY_FLAG_AUTO_SCALE         (1<<1)
493 #define MP4_TEXT_DISPLAY_FLAG_CLIP_TO_TEXT_BOX   (1<<2)
494 #define MP4_TEXT_DISPLAY_FLAG_USE_MOVIE_BG_COLOR (1<<3)
495 #define MP4_TEXT_DISPLAY_FLAG_SHRINK_TEXT_BOX_TO_FIT (1<<4)
496 #define MP4_TEXT_DISPLAY_FLAG_SCROLL_IN          (1<<5)
497 #define MP4_TEXT_DISPLAY_FLAG_SCROLL_OUT         (1<<6)
498 #define MP4_TEXT_DISPLAY_FLAG_HORIZONTAL_SCROLL  (1<<7)
499 #define MP4_TEXT_DISPLAY_FLAG_REVERSE_SCROLL     (1<<8)
500 #define MP4_TEXT_DISPLAY_FLAG_CONTINUOUS_SCROLL  (1<<9)
501 #define MP4_TEXT_DISPLAY_FLAG_FLOW_HORIZONTAL    (1<<10)
502 #define MP4_TEXT_DISPLAY_FLAG_CONTINUOUS_KARAOKE (1<<11)
503 #define MP4_TEXT_DISPLAY_FLAG_DROP_SHADOW        (1<<12)
504 #define MP4_TEXT_DISPLAY_FLAG_ANTI_ALIAS         (1<<13)
505 #define MP4_TEXT_DISPLAY_FLAG_KEYED_TEXT         (1<<14)
506 #define MP4_TEXT_DISPLAY_FLAG_INVERSE_HILITE     (1<<15)
507 #define MP4_TEXT_DISPLAY_FLAG_COLOR_HILITE       (1<<16)
508 #define MP4_TEXT_DISPLAY_FLAG_WRITE_VERTICALLY   (1<<17)
509
510 typedef struct
511 {
512     uint32_t i_reserved1;
513     uint16_t i_reserved2;
514
515     uint16_t i_data_reference_index;
516
517     uint32_t i_display_flags;   // TextDescription and Tx3gDescription
518
519     int8_t i_justification_horizontal; // left(0), centered(1), right(-1)
520     int8_t i_justification_vertical;   // top(0), centered(1), bottom(-1)
521
522     uint16_t i_background_color[4];
523
524     uint16_t i_text_box_top;
525     uint16_t i_text_box_left;
526     uint16_t i_text_box_bottom;
527     uint16_t i_text_box_right;
528
529     // TODO to complete
530 } MP4_Box_data_sample_text_t;
531
532 typedef struct MP4_Box_data_sample_hint_s
533 {
534     uint8_t  i_reserved1[6];
535     uint16_t i_data_reference_index;
536
537     uint8_t *p_data;
538
539 } MP4_Box_data_sample_hint_t;
540
541 typedef struct MP4_Box_data_moviehintinformation_rtp_s
542 {
543     uint32_t i_description_format;
544     unsigned char *psz_text;
545
546 } MP4_Box_data_moviehintinformation_rtp_t;
547
548
549
550 typedef struct MP4_Box_data_stsd_s
551 {
552     uint8_t  i_version;
553     uint32_t i_flags;
554
555     uint32_t i_entry_count;
556
557     /* it contains SampleEntry handled as if it was Box */
558
559 } MP4_Box_data_stsd_t;
560
561
562 typedef struct MP4_Box_data_stsz_s
563 {
564     uint8_t  i_version;
565     uint32_t i_flags;
566
567     uint32_t i_sample_size;
568     uint32_t i_sample_count;
569
570     uint32_t *i_entry_size; /* array , empty if i_sample_size != 0 */
571
572 } MP4_Box_data_stsz_t;
573
574 typedef struct MP4_Box_data_stz2_s
575 {
576     uint8_t  i_version;
577     uint32_t i_flags;
578
579     uint32_t i_sample_size; /* 24 bits */
580     uint8_t  i_field_size;
581     uint32_t i_sample_count;
582
583     uint32_t *i_entry_size; /* array: unsigned int(i_field_size) entry_size */
584
585 } MP4_Box_data_stz2_t;
586
587 typedef struct MP4_Box_data_stsc_s
588 {
589     uint8_t  i_version;
590     uint32_t i_flags;
591
592     uint32_t i_entry_count;
593
594     uint32_t *i_first_chunk; /* theses are arrays */
595     uint32_t *i_samples_per_chunk;
596     uint32_t *i_sample_description_index;
597
598 } MP4_Box_data_stsc_t;
599
600
601 typedef struct MP4_Box_data_co64_s
602 {
603     uint8_t  i_version;
604     uint32_t i_flags;
605
606     uint32_t i_entry_count;
607
608     uint64_t *i_chunk_offset;
609
610 } MP4_Box_data_co64_t;
611
612
613 typedef struct MP4_Box_data_stss_s
614 {
615     uint8_t  i_version;
616     uint32_t i_flags;
617
618     uint32_t i_entry_count;
619
620     uint32_t *i_sample_number;
621
622 } MP4_Box_data_stss_t;
623
624 typedef struct MP4_Box_data_stsh_s
625 {
626     uint8_t  i_version;
627     uint32_t i_flags;
628
629     uint32_t i_entry_count;
630
631     uint32_t *i_shadowed_sample_number;
632     uint32_t *i_sync_sample_number;
633
634 } MP4_Box_data_stsh_t;
635
636 typedef struct MP4_Box_data_stdp_s
637 {
638     uint8_t  i_version;
639     uint32_t i_flags;
640
641     uint16_t *i_priority;
642
643 } MP4_Box_data_stdp_t;
644
645 typedef struct MP4_Box_data_padb_s
646 {
647     uint8_t  i_version;
648     uint32_t i_flags;
649
650     uint32_t i_sample_count;
651
652     uint16_t *i_reserved1;   /* 1bit  */
653     uint16_t *i_pad2;        /* 3bits */
654     uint16_t *i_reserved2;   /* 1bit  */
655     uint16_t *i_pad1;        /* 3bits */
656
657
658 } MP4_Box_data_padb_t;
659
660
661 typedef struct MP4_Box_data_elst_s
662 {
663     uint8_t  i_version;
664     uint32_t i_flags;
665
666     uint32_t i_entry_count;
667
668     uint64_t *i_segment_duration;
669     int64_t  *i_media_time;
670     uint16_t *i_media_rate_integer;
671     uint16_t *i_media_rate_fraction;
672
673
674 } MP4_Box_data_elst_t;
675
676 typedef struct MP4_Box_data_cprt_s
677 {
678     uint8_t  i_version;
679     uint32_t i_flags;
680     /* 1 pad bit */
681     unsigned char i_language[3];
682
683     char *psz_notice;
684 } MP4_Box_data_cprt_t;
685
686
687 /* DecoderConfigDescriptor */
688 typedef struct MP4_descriptor_decoder_config_s
689 {
690     uint8_t i_objectTypeIndication;
691     uint8_t i_streamType;
692     int     b_upStream;
693     int     i_buffer_sizeDB;
694     int     i_max_bitrate;
695     int     i_avg_bitrate;
696
697     int     i_decoder_specific_info_len;
698     uint8_t *p_decoder_specific_info;
699     /* some other stuff */
700
701 } MP4_descriptor_decoder_config_t;
702
703 typedef struct MP4_descriptor_SL_config_s
704 {
705
706     int i_dummy; /* ANSI C forbids empty structures */
707
708 } MP4_descriptor_SL_config_t;
709
710
711 typedef struct MP4_descriptor_ES_s
712 {
713     uint16_t i_ES_ID;
714     int      b_stream_dependence;
715     int      b_url;
716     int      b_OCRstream;
717     int      i_stream_priority;
718
719     int      i_depend_on_ES_ID; /* if b_stream_dependence set */
720
721     unsigned char *psz_URL;
722
723     uint16_t i_OCR_ES_ID;       /* if b_OCRstream */
724     MP4_descriptor_decoder_config_t *p_decConfigDescr;
725
726     MP4_descriptor_SL_config_t *p_slConfigDescr;
727
728     /* some other stuff ... */
729
730 } MP4_descriptor_ES_t;
731
732 /* ES descriptor */
733 typedef struct MP4_Box_data_esds_s
734 {
735     uint8_t  i_version;
736     uint32_t i_flags;
737
738     MP4_descriptor_ES_t es_descriptor;
739
740 } MP4_Box_data_esds_t;
741
742
743 typedef struct MP4_Box_data_dcom_s
744 {
745     uint32_t i_algorithm; /* fourcc */
746
747 } MP4_Box_data_dcom_t;
748
749 typedef struct MP4_Box_data_cmvd_s
750 {
751     uint32_t i_uncompressed_size;
752     uint32_t i_compressed_size;
753
754     int     b_compressed; /* Set to 1 if compressed data, 0 if uncompressed */
755     uint8_t *p_data;
756
757 } MP4_Box_data_cmvd_t;
758
759 typedef struct MP4_Box_data_cmov_s
760 {
761     struct MP4_Box_s *p_moov; /* uncompressed moov */
762
763 } MP4_Box_data_cmov_t;
764
765 typedef struct
766 {
767     uint32_t i_type;
768 } MP4_Box_data_frma_t;
769
770 typedef struct
771 {
772     uint32_t i_init;
773     uint32_t i_encr;
774     uint32_t i_decr;
775 } MP4_Box_data_skcr_t;
776
777 typedef struct
778 {
779     uint8_t  i_version;
780     uint32_t i_flags;
781
782     uint32_t i_ref_type;
783     char     *psz_ref;
784
785 } MP4_Box_data_rdrf_t;
786
787 typedef struct
788 {
789     uint8_t  i_version;
790     uint32_t i_flags;
791
792     uint32_t i_rate;
793
794 } MP4_Box_data_rmdr_t;
795
796 typedef struct
797 {
798     uint8_t  i_version;
799     uint32_t i_flags;
800
801     uint32_t i_gestaltType;
802     uint32_t i_val1;
803     uint32_t i_val2;
804     uint16_t i_checkType;   /* 0: val1 is version min
805                                1: gestalt value & val2 == val1 */
806
807 } MP4_Box_data_rmvc_t;
808
809 typedef struct
810 {
811     uint8_t  i_version;
812     uint32_t i_flags;
813
814
815 } MP4_Box_data_rmcd_t;
816
817 typedef struct
818 {
819     uint32_t i_quality;
820
821 } MP4_Box_data_rmqu_t;
822
823 typedef struct
824 {
825     char *psz_text;
826
827 } MP4_Box_data_0xa9xxx_t;
828
829 typedef struct
830 {
831     uint32_t i_entry_count;
832     uint32_t *i_track_ID;
833
834 } MP4_Box_data_tref_generic_t;
835
836 typedef struct
837 {
838     uint8_t  i_version;
839     uint32_t i_flags;
840
841     uint8_t i_chapter;
842     struct
843     {
844         char    *psz_name;
845         int64_t  i_start;
846     } chapter[256];
847 } MP4_Box_data_chpl_t;
848
849 typedef struct
850 {
851     uint8_t i_version;
852     uint8_t i_profile;
853     uint8_t i_profile_compatibility;
854     uint8_t i_level;
855
856     uint8_t i_reserved1;     /* 6 bits */
857     uint8_t i_length_size;
858
859     uint8_t i_reserved2;    /* 3 bits */
860     uint8_t  i_sps;
861     uint16_t *i_sps_length;
862     uint8_t  **sps;
863
864     uint8_t  i_pps;
865     uint16_t *i_pps_length;
866     uint8_t  **pps;
867
868     /* XXX: Hack raw avcC atom payload */
869     int     i_avcC;
870     uint8_t *p_avcC;
871
872 } MP4_Box_data_avcC_t;
873
874 typedef struct
875 {
876     uint8_t i_fscod;
877     uint8_t i_bsid;
878     uint8_t i_bsmod;
879     uint8_t i_acmod;
880     uint8_t i_lfeon;
881     uint8_t i_bitrate_code;
882
883 } MP4_Box_data_dac3_t;
884
885 typedef struct
886 {
887     uint16_t i_little_endian;
888
889 } MP4_Box_data_enda_t;
890
891 typedef struct
892 {
893     uint16_t i_genre;
894
895 } MP4_Box_data_gnre_t;
896
897 typedef struct
898 {
899     uint32_t i_track_number;
900     uint32_t i_track_total;
901
902 } MP4_Box_data_trkn_t;
903
904 /*
905 typedef struct MP4_Box_data__s
906 {
907     uint8_t  i_version;
908     uint32_t i_flags;
909
910 } MP4_Box_data__t;
911
912 */
913
914 typedef union MP4_Box_data_s
915 {
916     MP4_Box_data_ftyp_t *p_ftyp;
917     MP4_Box_data_mvhd_t *p_mvhd;
918     MP4_Box_data_tkhd_t *p_tkhd;
919     MP4_Box_data_mdhd_t *p_mdhd;
920     MP4_Box_data_hdlr_t *p_hdlr;
921     MP4_Box_data_vmhd_t *p_vmhd;
922     MP4_Box_data_smhd_t *p_smhd;
923     MP4_Box_data_hmhd_t *p_hmhd;
924     MP4_Box_data_url_t  *p_url;
925     MP4_Box_data_urn_t  *p_urn;
926     MP4_Box_data_dref_t *p_dref;
927     MP4_Box_data_stts_t *p_stts;
928     MP4_Box_data_ctts_t *p_ctts;
929     MP4_Box_data_stsd_t *p_stsd;
930     MP4_Box_data_sample_vide_t *p_sample_vide;
931     MP4_Box_data_sample_soun_t *p_sample_soun;
932     MP4_Box_data_sample_text_t *p_sample_text;
933     MP4_Box_data_sample_hint_t *p_sample_hint;
934
935     MP4_Box_data_esds_t *p_esds;
936     MP4_Box_data_avcC_t *p_avcC;
937     MP4_Box_data_dac3_t *p_dac3;
938     MP4_Box_data_enda_t *p_enda;
939     MP4_Box_data_gnre_t *p_gnre;
940     MP4_Box_data_trkn_t *p_trkn;
941
942     MP4_Box_data_stsz_t *p_stsz;
943     MP4_Box_data_stz2_t *p_stz2;
944     MP4_Box_data_stsc_t *p_stsc;
945     MP4_Box_data_co64_t *p_co64;
946     MP4_Box_data_stss_t *p_stss;
947     MP4_Box_data_stsh_t *p_stsh;
948     MP4_Box_data_stdp_t *p_stdp;
949     MP4_Box_data_padb_t *p_padb;
950     MP4_Box_data_elst_t *p_elst;
951     MP4_Box_data_cprt_t *p_cprt;
952
953     MP4_Box_data_dcom_t *p_dcom;
954     MP4_Box_data_cmvd_t *p_cmvd;
955     MP4_Box_data_cmov_t *p_cmov;
956
957     MP4_Box_data_moviehintinformation_rtp_t p_moviehintinformation_rtp;
958
959     MP4_Box_data_frma_t *p_frma;
960     MP4_Box_data_skcr_t *p_skcr;
961
962     MP4_Box_data_rdrf_t *p_rdrf;
963     MP4_Box_data_rmdr_t *p_rmdr;
964     MP4_Box_data_rmqu_t *p_rmqu;
965     MP4_Box_data_rmvc_t *p_rmvc;
966
967     MP4_Box_data_0xa9xxx_t *p_0xa9xxx;
968     MP4_Box_data_chpl_t *p_chpl;
969     MP4_Box_data_tref_generic_t *p_tref_generic;
970
971     void                *p_data; /* for unknow type */
972 } MP4_Box_data_t;
973
974
975
976 /* the most basic structure */
977 typedef struct MP4_Box_s
978 {
979     off_t        i_pos;      /* absolute position */
980
981     uint32_t     i_type;
982     uint32_t     i_shortsize;
983
984     UUID_t       i_uuid;  /* Set if i_type == "uuid" */
985
986     uint64_t     i_size; /* always set so use it */
987
988     MP4_Box_data_t   data;   /* union of pointers on extended data depending
989                                 on i_type (or i_usertype) */
990
991     struct MP4_Box_s *p_father; /* pointer on the father Box */
992
993     struct MP4_Box_s *p_first;  /* pointer on the first child Box */
994     struct MP4_Box_s *p_last;
995
996     struct MP4_Box_s *p_next;   /* pointer on the next boxes at the same level */
997
998 } MP4_Box_t;
999
1000
1001
1002 /*****************************************************************************
1003  * MP4_BoxGetRoot : Parse the entire file, and create all boxes in memory
1004  *****************************************************************************
1005  *  The first box is a virtual box "root" and is the father for all first
1006  *  level boxes
1007  *****************************************************************************/
1008 MP4_Box_t *MP4_BoxGetRoot( stream_t * );
1009
1010 /*****************************************************************************
1011  * MP4_FreeBox : free memory allocated after read with MP4_ReadBox
1012  *               or MP4_BoxGetRoot, this means also children boxes
1013  * XXX : all children have to be allocated by a malloc !! and
1014  *         p_box is freed
1015  *****************************************************************************/
1016 void MP4_BoxFree( stream_t *, MP4_Box_t *p_box );
1017
1018 /*****************************************************************************
1019  * MP4_DumpBoxStructure: print the structure of the p_box
1020  *****************************************************************************
1021  * Usefull while debugging
1022  *****************************************************************************/
1023 void MP4_BoxDumpStructure( stream_t *p_input, MP4_Box_t *p_box );
1024
1025
1026 /*****************************************************************************
1027  * MP4_BoxGet: find a box given a path relative to p_box
1028  *****************************************************************************
1029  * Path Format: . .. / as usual
1030  *              [number] to specifie box number ex: trak[12]
1031  *
1032  * ex: /moov/trak[12]
1033  *     ../mdia
1034  *****************************************************************************/
1035 MP4_Box_t *MP4_BoxGet( MP4_Box_t *p_box, const char *psz_fmt, ... );
1036
1037 /*****************************************************************************
1038  * MP4_BoxCount: find number of box given a path relative to p_box
1039  *****************************************************************************
1040  * Path Format: . .. / as usual
1041  *              [number] to specifie box number ex: trak[12]
1042  *
1043  * ex: /moov/trak
1044  *     ../mdia
1045  *****************************************************************************/
1046 int MP4_BoxCount( MP4_Box_t *p_box, const char *psz_fmt, ... );
1047
1048 int MP4_ReadBoxCommon( stream_t *p_stream, MP4_Box_t *p_box );
1049 int MP4_ReadBox_sample_vide( stream_t *p_stream, MP4_Box_t *p_box );
1050 void MP4_FreeBox_sample_vide( MP4_Box_t *p_box );
1051
1052 #endif