isom: replace pseudo doxycomments with normal comments.
[ffmpeg.git] / libavformat / isom.c
1 /*
2  * ISO Media common code
3  * Copyright (c) 2001 Fabrice Bellard
4  * Copyright (c) 2002 Francois Revol <revol@free.fr>
5  * Copyright (c) 2006 Baptiste Coudurier <baptiste.coudurier@free.fr>
6  *
7  * This file is part of FFmpeg.
8  *
9  * FFmpeg is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * FFmpeg is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with FFmpeg; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  */
23
24 //#define DEBUG
25
26 #include "avformat.h"
27 #include "internal.h"
28 #include "isom.h"
29 #include "riff.h"
30 #include "libavcodec/mpeg4audio.h"
31 #include "libavcodec/mpegaudiodata.h"
32
33 /* http://www.mp4ra.org */
34 /* ordered by muxing preference */
35 const AVCodecTag ff_mp4_obj_type[] = {
36     { CODEC_ID_MOV_TEXT  , 0x08 },
37     { CODEC_ID_MPEG4     , 0x20 },
38     { CODEC_ID_H264      , 0x21 },
39     { CODEC_ID_AAC       , 0x40 },
40     { CODEC_ID_MP4ALS    , 0x40 }, /* 14496-3 ALS */
41     { CODEC_ID_MPEG2VIDEO, 0x61 }, /* MPEG2 Main */
42     { CODEC_ID_MPEG2VIDEO, 0x60 }, /* MPEG2 Simple */
43     { CODEC_ID_MPEG2VIDEO, 0x62 }, /* MPEG2 SNR */
44     { CODEC_ID_MPEG2VIDEO, 0x63 }, /* MPEG2 Spatial */
45     { CODEC_ID_MPEG2VIDEO, 0x64 }, /* MPEG2 High */
46     { CODEC_ID_MPEG2VIDEO, 0x65 }, /* MPEG2 422 */
47     { CODEC_ID_AAC       , 0x66 }, /* MPEG2 AAC Main */
48     { CODEC_ID_AAC       , 0x67 }, /* MPEG2 AAC Low */
49     { CODEC_ID_AAC       , 0x68 }, /* MPEG2 AAC SSR */
50     { CODEC_ID_MP3       , 0x69 }, /* 13818-3 */
51     { CODEC_ID_MP2       , 0x69 }, /* 11172-3 */
52     { CODEC_ID_MPEG1VIDEO, 0x6A }, /* 11172-2 */
53     { CODEC_ID_MP3       , 0x6B }, /* 11172-3 */
54     { CODEC_ID_MJPEG     , 0x6C }, /* 10918-1 */
55     { CODEC_ID_PNG       , 0x6D },
56     { CODEC_ID_JPEG2000  , 0x6E }, /* 15444-1 */
57     { CODEC_ID_VC1       , 0xA3 },
58     { CODEC_ID_DIRAC     , 0xA4 },
59     { CODEC_ID_AC3       , 0xA5 },
60     { CODEC_ID_DTS       , 0xA9 }, /* mp4ra.org */
61     { CODEC_ID_VORBIS    , 0xDD }, /* non standard, gpac uses it */
62     { CODEC_ID_DVD_SUBTITLE, 0xE0 }, /* non standard, see unsupported-embedded-subs-2.mp4 */
63     { CODEC_ID_QCELP     , 0xE1 },
64     { CODEC_ID_NONE      ,    0 },
65 };
66
67 const AVCodecTag codec_movvideo_tags[] = {
68 /*  { CODEC_ID_, MKTAG('I', 'V', '5', '0') }, *//* Indeo 5.0 */
69
70     { CODEC_ID_RAWVIDEO, MKTAG('r', 'a', 'w', ' ') }, /* Uncompressed RGB */
71     { CODEC_ID_RAWVIDEO, MKTAG('y', 'u', 'v', '2') }, /* Uncompressed YUV422 */
72     { CODEC_ID_RAWVIDEO, MKTAG('A', 'V', 'U', 'I') }, /* YUV with alpha-channel (AVID Uncompressed) */
73     { CODEC_ID_RAWVIDEO, MKTAG('2', 'v', 'u', 'y') }, /* UNCOMPRESSED 8BIT 4:2:2 */
74     { CODEC_ID_RAWVIDEO, MKTAG('y', 'u', 'v', 's') }, /* same as 2vuy but byte swapped */
75
76     { CODEC_ID_RAWVIDEO, MKTAG('L', '5', '5', '5') },
77     { CODEC_ID_RAWVIDEO, MKTAG('L', '5', '6', '5') },
78     { CODEC_ID_RAWVIDEO, MKTAG('B', '5', '6', '5') },
79     { CODEC_ID_RAWVIDEO, MKTAG('2', '4', 'B', 'G') },
80     { CODEC_ID_RAWVIDEO, MKTAG('B', 'G', 'R', 'A') },
81     { CODEC_ID_RAWVIDEO, MKTAG('R', 'G', 'B', 'A') },
82     { CODEC_ID_RAWVIDEO, MKTAG('A', 'B', 'G', 'R') },
83     { CODEC_ID_RAWVIDEO, MKTAG('b', '1', '6', 'g') },
84     { CODEC_ID_RAWVIDEO, MKTAG('b', '4', '8', 'r') },
85     { CODEC_ID_RAWVIDEO, MKTAG('D', 'V', 'O', 'O') }, /* Digital Voodoo SD 8 Bit */
86
87     { CODEC_ID_R10K,   MKTAG('R', '1', '0', 'k') }, /* UNCOMPRESSED 10BIT RGB */
88     { CODEC_ID_R10K,   MKTAG('R', '1', '0', 'g') }, /* UNCOMPRESSED 10BIT RGB */
89     { CODEC_ID_R210,   MKTAG('r', '2', '1', '0') }, /* UNCOMPRESSED 10BIT RGB */
90     { CODEC_ID_V210,   MKTAG('v', '2', '1', '0') }, /* UNCOMPRESSED 10BIT 4:2:2 */
91
92     { CODEC_ID_MJPEG,  MKTAG('j', 'p', 'e', 'g') }, /* PhotoJPEG */
93     { CODEC_ID_MJPEG,  MKTAG('m', 'j', 'p', 'a') }, /* Motion-JPEG (format A) */
94     { CODEC_ID_MJPEG,  MKTAG('A', 'V', 'D', 'J') }, /* MJPEG with alpha-channel (AVID JFIF meridien compressed) */
95 /*  { CODEC_ID_MJPEG,  MKTAG('A', 'V', 'R', 'n') }, *//* MJPEG with alpha-channel (AVID ABVB/Truevision NuVista) */
96     { CODEC_ID_MJPEG,  MKTAG('d', 'm', 'b', '1') }, /* Motion JPEG OpenDML */
97     { CODEC_ID_MJPEGB, MKTAG('m', 'j', 'p', 'b') }, /* Motion-JPEG (format B) */
98
99     { CODEC_ID_SVQ1, MKTAG('S', 'V', 'Q', '1') }, /* Sorenson Video v1 */
100     { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', '1') }, /* Sorenson Video v1 */
101     { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', 'i') }, /* Sorenson Video v1 (from QT specs)*/
102     { CODEC_ID_SVQ3, MKTAG('S', 'V', 'Q', '3') }, /* Sorenson Video v3 */
103
104     { CODEC_ID_MPEG4, MKTAG('m', 'p', '4', 'v') },
105     { CODEC_ID_MPEG4, MKTAG('D', 'I', 'V', 'X') }, /* OpenDiVX *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
106     { CODEC_ID_MPEG4, MKTAG('X', 'V', 'I', 'D') },
107     { CODEC_ID_MPEG4, MKTAG('3', 'I', 'V', '2') }, /* experimental: 3IVX files before ivx D4 4.5.1 */
108
109     { CODEC_ID_H263, MKTAG('h', '2', '6', '3') }, /* H263 */
110     { CODEC_ID_H263, MKTAG('s', '2', '6', '3') }, /* H263 ?? works */
111
112     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', 'p') }, /* DV PAL */
113     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', ' ') }, /* DV NTSC */
114     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'p', 'p') }, /* DVCPRO PAL produced by FCP */
115     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'p') }, /* DVCPRO50 PAL produced by FCP */
116     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'n') }, /* DVCPRO50 NTSC produced by FCP */
117     { CODEC_ID_DVVIDEO, MKTAG('A', 'V', 'd', 'v') }, /* AVID DV */
118     { CODEC_ID_DVVIDEO, MKTAG('A', 'V', 'd', '1') }, /* AVID DV100 */
119     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', 'q') }, /* DVCPRO HD 720p50 */
120     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', 'p') }, /* DVCPRO HD 720p60 */
121     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '1') },
122     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '2') },
123     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '4') },
124     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '5') }, /* DVCPRO HD 50i produced by FCP */
125     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '6') }, /* DVCPRO HD 60i produced by FCP */
126     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '3') }, /* DVCPRO HD 30p produced by FCP */
127
128     { CODEC_ID_VP3,     MKTAG('V', 'P', '3', '1') }, /* On2 VP3 */
129     { CODEC_ID_RPZA,    MKTAG('r', 'p', 'z', 'a') }, /* Apple Video (RPZA) */
130     { CODEC_ID_CINEPAK, MKTAG('c', 'v', 'i', 'd') }, /* Cinepak */
131     { CODEC_ID_8BPS,    MKTAG('8', 'B', 'P', 'S') }, /* Planar RGB (8BPS) */
132     { CODEC_ID_SMC,     MKTAG('s', 'm', 'c', ' ') }, /* Apple Graphics (SMC) */
133     { CODEC_ID_QTRLE,   MKTAG('r', 'l', 'e', ' ') }, /* Apple Animation (RLE) */
134     { CODEC_ID_MSRLE,   MKTAG('W', 'R', 'L', 'E') },
135     { CODEC_ID_QDRAW,   MKTAG('q', 'd', 'r', 'w') }, /* QuickDraw */
136
137     { CODEC_ID_RAWVIDEO, MKTAG('W', 'R', 'A', 'W') },
138
139     { CODEC_ID_H264, MKTAG('a', 'v', 'c', '1') }, /* AVC-1/H.264 */
140     { CODEC_ID_H264, MKTAG('a', 'i', '5', 'p') }, /* AVC-Intra  50M 720p24/30/60 */
141     { CODEC_ID_H264, MKTAG('a', 'i', '5', 'q') }, /* AVC-Intra  50M 720p25/50 */
142     { CODEC_ID_H264, MKTAG('a', 'i', '5', '2') }, /* AVC-Intra  50M 1080p25/50 */
143     { CODEC_ID_H264, MKTAG('a', 'i', '5', '3') }, /* AVC-Intra  50M 1080p24/30/60 */
144     { CODEC_ID_H264, MKTAG('a', 'i', '5', '5') }, /* AVC-Intra  50M 1080i50 */
145     { CODEC_ID_H264, MKTAG('a', 'i', '5', '6') }, /* AVC-Intra  50M 1080i60 */
146     { CODEC_ID_H264, MKTAG('a', 'i', '1', 'p') }, /* AVC-Intra 100M 720p24/30/60 */
147     { CODEC_ID_H264, MKTAG('a', 'i', '1', 'q') }, /* AVC-Intra 100M 720p25/50 */
148     { CODEC_ID_H264, MKTAG('a', 'i', '1', '2') }, /* AVC-Intra 100M 1080p25/50 */
149     { CODEC_ID_H264, MKTAG('a', 'i', '1', '3') }, /* AVC-Intra 100M 1080p24/30/60 */
150     { CODEC_ID_H264, MKTAG('a', 'i', '1', '5') }, /* AVC-Intra 100M 1080i50 */
151     { CODEC_ID_H264, MKTAG('a', 'i', '1', '6') }, /* AVC-Intra 100M 1080i60 */
152
153     { CODEC_ID_MPEG1VIDEO, MKTAG('m', '1', 'v', '1') }, /* Apple MPEG-1 Camcorder */
154     { CODEC_ID_MPEG1VIDEO, MKTAG('m', 'p', 'e', 'g') }, /* MPEG */
155     { CODEC_ID_MPEG2VIDEO, MKTAG('m', '2', 'v', '1') }, /* Apple MPEG-2 Camcorder */
156     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '1') }, /* MPEG2 HDV 720p30 */
157     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '2') }, /* MPEG2 HDV 1080i60 */
158     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '3') }, /* MPEG2 HDV 1080i50 */
159     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '5') }, /* MPEG2 HDV 720p25 */
160     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '6') }, /* MPEG2 HDV 1080p24 */
161     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '7') }, /* MPEG2 HDV 1080p25 */
162     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '8') }, /* MPEG2 HDV 1080p30 */
163     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'n') }, /* MPEG2 IMX NTSC 525/60 50mb/s produced by FCP */
164     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'p') }, /* MPEG2 IMX PAL 625/50 50mb/s produced by FCP */
165     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '4', 'n') }, /* MPEG2 IMX NTSC 525/60 40mb/s produced by FCP */
166     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '4', 'p') }, /* MPEG2 IMX PAL 625/50 40mb/s produced by FCP */
167     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'n') }, /* MPEG2 IMX NTSC 525/60 30mb/s produced by FCP */
168     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'p') }, /* MPEG2 IMX PAL 625/50 30mb/s produced by FCP */
169     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', '4') }, /* XDCAM HD422 720p24 CBR */
170     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', '5') }, /* XDCAM HD422 720p25 CBR */
171     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', '9') }, /* XDCAM HD422 720p60 CBR */
172     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'a') }, /* XDCAM HD422 720p50 CBR */
173     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'b') }, /* XDCAM HD422 1080i60 CBR */
174     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'c') }, /* XDCAM HD422 1080i50 CBR */
175     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'd') }, /* XDCAM HD422 1080p24 CBR */
176     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'e') }, /* XDCAM HD422 1080p25 CBR */
177     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'f') }, /* XDCAM HD422 1080p30 CBR */
178     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '1') }, /* XDCAM EX 720p30 VBR */
179     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '2') }, /* XDCAM HD 1080i60 */
180     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '3') }, /* XDCAM HD 1080i50 VBR */
181     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '4') }, /* XDCAM EX 720p24 VBR */
182     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '5') }, /* XDCAM EX 720p25 VBR */
183     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '6') }, /* XDCAM HD 1080p24 VBR */
184     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '7') }, /* XDCAM HD 1080p25 VBR */
185     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '8') }, /* XDCAM HD 1080p30 VBR */
186     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '9') }, /* XDCAM EX 720p60 VBR */
187     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'a') }, /* XDCAM EX 720p50 VBR */
188     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'b') }, /* XDCAM EX 1080i60 VBR */
189     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'c') }, /* XDCAM EX 1080i50 VBR */
190     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'd') }, /* XDCAM EX 1080p24 VBR */
191     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'e') }, /* XDCAM EX 1080p25 VBR */
192     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'f') }, /* XDCAM EX 1080p30 VBR */
193     { CODEC_ID_MPEG2VIDEO, MKTAG('A', 'V', 'm', 'p') }, /* AVID IMX PAL */
194
195     { CODEC_ID_JPEG2000, MKTAG('m', 'j', 'p', '2') }, /* JPEG 2000 produced by FCP */
196
197     { CODEC_ID_TARGA, MKTAG('t', 'g', 'a', ' ') }, /* Truevision Targa */
198     { CODEC_ID_TIFF,  MKTAG('t', 'i', 'f', 'f') }, /* TIFF embedded in MOV */
199     { CODEC_ID_GIF,   MKTAG('g', 'i', 'f', ' ') }, /* embedded gif files as frames (usually one "click to play movie" frame) */
200     { CODEC_ID_PNG,   MKTAG('p', 'n', 'g', ' ') },
201
202     { CODEC_ID_VC1, MKTAG('v', 'c', '-', '1') }, /* SMPTE RP 2025 */
203     { CODEC_ID_CAVS, MKTAG('a', 'v', 's', '2') },
204
205     { CODEC_ID_DIRAC, MKTAG('d', 'r', 'a', 'c') },
206     { CODEC_ID_DNXHD, MKTAG('A', 'V', 'd', 'n') }, /* AVID DNxHD */
207     { CODEC_ID_RAWVIDEO, MKTAG('A', 'V', '1', 'x') }, /* AVID 1:1x */
208     { CODEC_ID_RAWVIDEO, MKTAG('A', 'V', 'u', 'p') },
209     { CODEC_ID_SGI,   MKTAG('s', 'g', 'i', ' ') }, /* SGI  */
210     { CODEC_ID_DPX,   MKTAG('d', 'p', 'x', ' ') }, /* DPX */
211
212     { CODEC_ID_PRORES, MKTAG('a', 'p', 'c', 'h') }, /* Apple ProRes 422 High Quality */
213     { CODEC_ID_PRORES, MKTAG('a', 'p', 'c', 'n') }, /* Apple ProRes 422 Standard Definition */
214     { CODEC_ID_PRORES, MKTAG('a', 'p', 'c', 's') }, /* Apple ProRes 422 LT */
215     { CODEC_ID_PRORES, MKTAG('a', 'p', 'c', 'o') }, /* Apple ProRes 422 Proxy */
216     { CODEC_ID_PRORES, MKTAG('a', 'p', '4', 'h') }, /* Apple ProRes 4444 */
217
218     { CODEC_ID_MSMPEG4V3, MKTAG('3', 'I', 'V', 'D') }, /* 3ivx DivX Doctor */
219     { CODEC_ID_FLV1,      MKTAG('H', '2', '6', '3') }, /* Flash Media Server */
220
221     { CODEC_ID_NONE, 0 },
222 };
223
224 const AVCodecTag codec_movaudio_tags[] = {
225     { CODEC_ID_PCM_S32BE, MKTAG('i', 'n', '3', '2') },
226     { CODEC_ID_PCM_S32LE, MKTAG('i', 'n', '3', '2') },
227     { CODEC_ID_PCM_S24BE, MKTAG('i', 'n', '2', '4') },
228     { CODEC_ID_PCM_S24LE, MKTAG('i', 'n', '2', '4') },
229     { CODEC_ID_PCM_S16BE, MKTAG('t', 'w', 'o', 's') }, /* 16 bits */
230     { CODEC_ID_PCM_S16LE, MKTAG('s', 'o', 'w', 't') }, /*  */
231     { CODEC_ID_PCM_S16LE, MKTAG('l', 'p', 'c', 'm') },
232     { CODEC_ID_PCM_F32BE, MKTAG('f', 'l', '3', '2') },
233     { CODEC_ID_PCM_F32LE, MKTAG('f', 'l', '3', '2') },
234     { CODEC_ID_PCM_F64BE, MKTAG('f', 'l', '6', '4') },
235     { CODEC_ID_PCM_F64LE, MKTAG('f', 'l', '6', '4') },
236     { CODEC_ID_PCM_S8,    MKTAG('s', 'o', 'w', 't') },
237     { CODEC_ID_PCM_U8,    MKTAG('r', 'a', 'w', ' ') }, /* 8 bits unsigned */
238     { CODEC_ID_PCM_U8,    MKTAG('N', 'O', 'N', 'E') }, /* uncompressed */
239     { CODEC_ID_PCM_MULAW, MKTAG('u', 'l', 'a', 'w') }, /*  */
240     { CODEC_ID_PCM_ALAW,  MKTAG('a', 'l', 'a', 'w') }, /*  */
241
242     { CODEC_ID_ADPCM_IMA_QT, MKTAG('i', 'm', 'a', '4') }, /* IMA-4 ADPCM */
243
244     { CODEC_ID_MACE3, MKTAG('M', 'A', 'C', '3') }, /* Macintosh Audio Compression and Expansion 3:1 */
245     { CODEC_ID_MACE6, MKTAG('M', 'A', 'C', '6') }, /* Macintosh Audio Compression and Expansion 6:1 */
246
247     { CODEC_ID_MP1, MKTAG('.', 'm', 'p', '1') }, /* MPEG layer 1 */
248     { CODEC_ID_MP2, MKTAG('.', 'm', 'p', '2') }, /* MPEG layer 2 */
249
250     { CODEC_ID_MP3, MKTAG('.', 'm', 'p', '3') }, /* MPEG layer 3 */ /* sample files at http://www.3ivx.com/showcase.html use this tag */
251     { CODEC_ID_MP3, 0x6D730055 }, /* MPEG layer 3 */
252
253 /*  { CODEC_ID_OGG_VORBIS, MKTAG('O', 'g', 'g', 'S') }, *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
254
255     { CODEC_ID_AAC, MKTAG('m', 'p', '4', 'a') }, /* MPEG-4 AAC */
256     { CODEC_ID_AC3, MKTAG('a', 'c', '-', '3') }, /* ETSI TS 102 366 Annex F */
257     { CODEC_ID_AC3, MKTAG('s', 'a', 'c', '3') }, /* Nero Recode */
258     { CODEC_ID_DTS, MKTAG('d', 't', 's', 'c') }, /* mp4ra.org */
259     { CODEC_ID_DTS, MKTAG('D', 'T', 'S', ' ') }, /* non-standard */
260
261     { CODEC_ID_AMR_NB, MKTAG('s', 'a', 'm', 'r') }, /* AMR-NB 3gp */
262     { CODEC_ID_AMR_WB, MKTAG('s', 'a', 'w', 'b') }, /* AMR-WB 3gp */
263
264     { CODEC_ID_GSM,  MKTAG('a', 'g', 's', 'm') },
265     { CODEC_ID_ALAC, MKTAG('a', 'l', 'a', 'c') }, /* Apple Lossless */
266
267     { CODEC_ID_NELLYMOSER, MKTAG('n', 'm', 'o', 's') }, /* Flash Media Server */
268
269     { CODEC_ID_QCELP, MKTAG('Q','c','l','p') },
270     { CODEC_ID_QCELP, MKTAG('Q','c','l','q') },
271     { CODEC_ID_QCELP, MKTAG('s','q','c','p') }, /* ISO Media fourcc */
272
273     { CODEC_ID_QDMC, MKTAG('Q', 'D', 'M', 'C') }, /* QDMC */
274     { CODEC_ID_QDM2, MKTAG('Q', 'D', 'M', '2') }, /* QDM2 */
275
276     { CODEC_ID_SPEEX, MKTAG('s','p','e','x') }, /* Flash Media Server */
277
278     { CODEC_ID_DVAUDIO, MKTAG('v', 'd', 'v', 'a') },
279     { CODEC_ID_DVAUDIO, MKTAG('d', 'v', 'c', 'a') },
280
281     { CODEC_ID_WMAV2, MKTAG('W', 'M', 'A', '2') },
282
283     { CODEC_ID_NONE, 0 },
284 };
285
286 const AVCodecTag ff_codec_movsubtitle_tags[] = {
287     { CODEC_ID_MOV_TEXT, MKTAG('t', 'e', 'x', 't') },
288     { CODEC_ID_MOV_TEXT, MKTAG('t', 'x', '3', 'g') },
289     { CODEC_ID_NONE, 0 },
290 };
291
292 /* map numeric codes from mdhd atom to ISO 639 */
293 /* cf. QTFileFormat.pdf p253, qtff.pdf p205 */
294 /* http://developer.apple.com/documentation/mac/Text/Text-368.html */
295 /* deprecated by putting the code as 3*5bit ascii */
296 static const char mov_mdhd_language_map[][4] = {
297     /* 0-9 */
298     "eng", "fra", "ger", "ita", "dut", "sve", "spa", "dan", "por", "nor",
299     "heb", "jpn", "ara", "fin", "gre", "ice", "mlt", "tur", "hr "/*scr*/, "chi"/*ace?*/,
300     "urd", "hin", "tha", "kor", "lit", "pol", "hun", "est", "lav",    "",
301     "fo ",    "", "rus", "chi",    "", "iri", "alb", "ron", "ces", "slk",
302     "slv", "yid", "sr ", "mac", "bul", "ukr", "bel", "uzb", "kaz", "aze",
303     /*?*/
304     "aze", "arm", "geo", "mol", "kir", "tgk", "tuk", "mon",    "", "pus",
305     "kur", "kas", "snd", "tib", "nep", "san", "mar", "ben", "asm", "guj",
306     "pa ", "ori", "mal", "kan", "tam", "tel",    "", "bur", "khm", "lao",
307     /*                   roman? arabic? */
308     "vie", "ind", "tgl", "may", "may", "amh", "tir", "orm", "som", "swa",
309     /*==rundi?*/
310        "", "run",    "", "mlg", "epo",    "",    "",    "",    "",    "",
311     /* 100 */
312        "",    "",    "",    "",    "",    "",    "",    "",    "",    "",
313        "",    "",    "",    "",    "",    "",    "",    "",    "",    "",
314        "",    "",    "",    "",    "",    "",    "",    "", "wel", "baq",
315     "cat", "lat", "que", "grn", "aym", "tat", "uig", "dzo", "jav"
316 };
317
318 int ff_mov_iso639_to_lang(const char lang[4], int mp4)
319 {
320     int i, code = 0;
321
322     /* old way, only for QT? */
323     for (i = 0; lang[0] && !mp4 && i < FF_ARRAY_ELEMS(mov_mdhd_language_map); i++) {
324         if (!strcmp(lang, mov_mdhd_language_map[i]))
325             return i;
326     }
327     /* XXX:can we do that in mov too? */
328     if (!mp4)
329         return -1;
330     /* handle undefined as such */
331     if (lang[0] == '\0')
332         lang = "und";
333     /* 5bit ascii */
334     for (i = 0; i < 3; i++) {
335         uint8_t c = lang[i];
336         c -= 0x60;
337         if (c > 0x1f)
338             return -1;
339         code <<= 5;
340         code |= c;
341     }
342     return code;
343 }
344
345 int ff_mov_lang_to_iso639(unsigned code, char to[4])
346 {
347     int i;
348     memset(to, 0, 4);
349     /* is it the mangled iso code? */
350     /* see http://www.geocities.com/xhelmboyx/quicktime/formats/mp4-layout.txt */
351     if (code > 138) {
352         for (i = 2; i >= 0; i--) {
353             to[i] = 0x60 + (code & 0x1f);
354             code >>= 5;
355         }
356         return 1;
357     }
358     /* old fashion apple lang code */
359     if (code >= FF_ARRAY_ELEMS(mov_mdhd_language_map))
360         return 0;
361     if (!mov_mdhd_language_map[code][0])
362         return 0;
363     memcpy(to, mov_mdhd_language_map[code], 4);
364     return 1;
365 }
366
367 int ff_mp4_read_descr_len(AVIOContext *pb)
368 {
369     int len = 0;
370     int count = 4;
371     while (count--) {
372         int c = avio_r8(pb);
373         len = (len << 7) | (c & 0x7f);
374         if (!(c & 0x80))
375             break;
376     }
377     return len;
378 }
379
380 int ff_mp4_read_descr(AVFormatContext *fc, AVIOContext *pb, int *tag)
381 {
382     int len;
383     *tag = avio_r8(pb);
384     len = ff_mp4_read_descr_len(pb);
385     av_dlog(fc, "MPEG4 description: tag=0x%02x len=%d\n", *tag, len);
386     return len;
387 }
388
389 void ff_mp4_parse_es_descr(AVIOContext *pb, int *es_id)
390 {
391      int flags;
392      if (es_id) *es_id = avio_rb16(pb);
393      else                avio_rb16(pb);
394      flags = avio_r8(pb);
395      if (flags & 0x80) //streamDependenceFlag
396          avio_rb16(pb);
397      if (flags & 0x40) { //URL_Flag
398          int len = avio_r8(pb);
399          avio_skip(pb, len);
400      }
401      if (flags & 0x20) //OCRstreamFlag
402          avio_rb16(pb);
403 }
404
405 static const AVCodecTag mp4_audio_types[] = {
406     { CODEC_ID_MP3ON4, AOT_PS   }, /* old mp3on4 draft */
407     { CODEC_ID_MP3ON4, AOT_L1   }, /* layer 1 */
408     { CODEC_ID_MP3ON4, AOT_L2   }, /* layer 2 */
409     { CODEC_ID_MP3ON4, AOT_L3   }, /* layer 3 */
410     { CODEC_ID_MP4ALS, AOT_ALS  }, /* MPEG-4 ALS */
411     { CODEC_ID_NONE,   AOT_NULL },
412 };
413
414 int ff_mp4_read_dec_config_descr(AVFormatContext *fc, AVStream *st, AVIOContext *pb)
415 {
416     int len, tag;
417     int object_type_id = avio_r8(pb);
418     avio_r8(pb); /* stream type */
419     avio_rb24(pb); /* buffer size db */
420     avio_rb32(pb); /* max bitrate */
421     avio_rb32(pb); /* avg bitrate */
422
423     st->codec->codec_id= ff_codec_get_id(ff_mp4_obj_type, object_type_id);
424     av_dlog(fc, "esds object type id 0x%02x\n", object_type_id);
425     len = ff_mp4_read_descr(fc, pb, &tag);
426     if (tag == MP4DecSpecificDescrTag) {
427         av_dlog(fc, "Specific MPEG4 header len=%d\n", len);
428         if (!len || (uint64_t)len > (1<<30))
429             return -1;
430         av_free(st->codec->extradata);
431         st->codec->extradata = av_mallocz(len + FF_INPUT_BUFFER_PADDING_SIZE);
432         if (!st->codec->extradata)
433             return AVERROR(ENOMEM);
434         avio_read(pb, st->codec->extradata, len);
435         st->codec->extradata_size = len;
436         if (st->codec->codec_id == CODEC_ID_AAC) {
437             MPEG4AudioConfig cfg;
438             ff_mpeg4audio_get_config(&cfg, st->codec->extradata,
439                                      st->codec->extradata_size);
440             st->codec->channels = cfg.channels;
441             if (cfg.object_type == 29 && cfg.sampling_index < 3) // old mp3on4
442                 st->codec->sample_rate = ff_mpa_freq_tab[cfg.sampling_index];
443             else if (cfg.ext_sample_rate)
444                 st->codec->sample_rate = cfg.ext_sample_rate;
445             else
446                 st->codec->sample_rate = cfg.sample_rate;
447             av_dlog(fc, "mp4a config channels %d obj %d ext obj %d "
448                     "sample rate %d ext sample rate %d\n", st->codec->channels,
449                     cfg.object_type, cfg.ext_object_type,
450                     cfg.sample_rate, cfg.ext_sample_rate);
451             if (!(st->codec->codec_id = ff_codec_get_id(mp4_audio_types,
452                                                         cfg.object_type)))
453                 st->codec->codec_id = CODEC_ID_AAC;
454         }
455     }
456     return 0;
457 }
458
459 typedef struct MovChannelLayout {
460     int64_t  channel_layout;
461     uint32_t layout_tag;
462 } MovChannelLayout;
463
464 static const MovChannelLayout mov_channel_layout[] = {
465     { AV_CH_LAYOUT_MONO,                         (100<<16) | 1}, // kCAFChannelLayoutTag_Mono
466     { AV_CH_LAYOUT_STEREO,                       (101<<16) | 2}, // kCAFChannelLayoutTag_Stereo
467     { AV_CH_LAYOUT_STEREO,                       (102<<16) | 2}, // kCAFChannelLayoutTag_StereoHeadphones
468     { AV_CH_LAYOUT_2_1,                          (131<<16) | 3}, // kCAFChannelLayoutTag_ITU_2_1
469     { AV_CH_LAYOUT_QUAD,                         (132<<16) | 4}, // kCAFChannelLayoutTag_ITU_2_2
470     { AV_CH_LAYOUT_2_2,                          (132<<16) | 4}, // kCAFChannelLayoutTag_ITU_2_2
471     { AV_CH_LAYOUT_QUAD,                         (108<<16) | 4}, // kCAFChannelLayoutTag_Quadraphonic
472     { AV_CH_LAYOUT_SURROUND,                     (113<<16) | 3}, // kCAFChannelLayoutTag_MPEG_3_0_A
473     { AV_CH_LAYOUT_4POINT0,                      (115<<16) | 4}, // kCAFChannelLayoutTag_MPEG_4_0_A
474     { AV_CH_LAYOUT_5POINT0_BACK,                 (117<<16) | 5}, // kCAFChannelLayoutTag_MPEG_5_0_A
475     { AV_CH_LAYOUT_5POINT0,                      (117<<16) | 5}, // kCAFChannelLayoutTag_MPEG_5_0_A
476     { AV_CH_LAYOUT_5POINT1_BACK,                 (121<<16) | 6}, // kCAFChannelLayoutTag_MPEG_5_1_A
477     { AV_CH_LAYOUT_5POINT1,                      (121<<16) | 6}, // kCAFChannelLayoutTag_MPEG_5_1_A
478     { AV_CH_LAYOUT_7POINT1,                      (128<<16) | 8}, // kCAFChannelLayoutTag_MPEG_7_1_C
479     { AV_CH_LAYOUT_7POINT1_WIDE,                 (126<<16) | 8}, // kCAFChannelLayoutTag_MPEG_7_1_A
480     { AV_CH_LAYOUT_5POINT1_BACK|AV_CH_LAYOUT_STEREO_DOWNMIX, (130<<16) | 8}, // kCAFChannelLayoutTag_SMPTE_DTV
481     { AV_CH_LAYOUT_STEREO|AV_CH_LOW_FREQUENCY,   (133<<16) | 3}, // kCAFChannelLayoutTag_DVD_4
482     { AV_CH_LAYOUT_2_1|AV_CH_LOW_FREQUENCY,      (134<<16) | 4}, // kCAFChannelLayoutTag_DVD_5
483     { AV_CH_LAYOUT_QUAD|AV_CH_LOW_FREQUENCY,     (135<<16) | 4}, // kCAFChannelLayoutTag_DVD_6
484     { AV_CH_LAYOUT_2_2|AV_CH_LOW_FREQUENCY,      (135<<16) | 4}, // kCAFChannelLayoutTag_DVD_6
485     { AV_CH_LAYOUT_SURROUND|AV_CH_LOW_FREQUENCY, (136<<16) | 4}, // kCAFChannelLayoutTag_DVD_10
486     { AV_CH_LAYOUT_4POINT0|AV_CH_LOW_FREQUENCY,  (137<<16) | 5}, // kCAFChannelLayoutTag_DVD_11
487     { 0, 0},
488 };
489
490 void ff_mov_read_chan(AVFormatContext *s, int64_t size, AVCodecContext *codec)
491 {
492     uint32_t layout_tag;
493     AVIOContext *pb = s->pb;
494     const MovChannelLayout *layouts = mov_channel_layout;
495     layout_tag = avio_rb32(pb);
496     size -= 4;
497     if (layout_tag == 0) { // kCAFChannelLayoutTag_UseChannelDescriptions
498         // Channel descriptions not implemented
499         av_log_ask_for_sample(s, "Unimplemented container channel layout.\n");
500         avio_skip(pb, size);
501         return;
502     }
503     if (layout_tag == 0x10000) { // kCAFChannelLayoutTag_UseChannelBitmap
504         codec->channel_layout = avio_rb32(pb);
505         size -= 4;
506         avio_skip(pb, size);
507         return;
508     }
509     while (layouts->channel_layout) {
510         if (layout_tag == layouts->layout_tag) {
511             codec->channel_layout = layouts->channel_layout;
512             break;
513         }
514         layouts++;
515     }
516     if (!codec->channel_layout)
517         av_log(s, AV_LOG_WARNING, "Unknown container channel layout.\n");
518     avio_skip(pb, size);
519 }
520
521 void ff_mov_write_chan(AVIOContext *pb, int64_t channel_layout)
522 {
523     const MovChannelLayout *layouts;
524     uint32_t layout_tag = 0;
525
526     for (layouts = mov_channel_layout; layouts->channel_layout; layouts++)
527         if (channel_layout == layouts->channel_layout) {
528             layout_tag = layouts->layout_tag;
529             break;
530         }
531
532     if (layout_tag) {
533         avio_wb32(pb, layout_tag); // mChannelLayoutTag
534         avio_wb32(pb, 0);          // mChannelBitmap
535     } else {
536         avio_wb32(pb, 0x10000);    // kCAFChannelLayoutTag_UseChannelBitmap
537         avio_wb32(pb, channel_layout);
538     }
539     avio_wb32(pb, 0);              // mNumberChannelDescriptions
540 }
541