cosmetics: Remove pointless period after copyright statement non-sentences.
[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 #include "avformat.h"
25 #include "riff.h"
26 #include "isom.h"
27
28 /* http://www.mp4ra.org */
29 /* ordered by muxing preference */
30 const AVCodecTag ff_mp4_obj_type[] = {
31     { CODEC_ID_MOV_TEXT  , 0x08 },
32     { CODEC_ID_MPEG4     , 0x20 },
33     { CODEC_ID_H264      , 0x21 },
34     { CODEC_ID_AAC       , 0x40 },
35     { CODEC_ID_MPEG2VIDEO, 0x61 }, /* MPEG2 Main */
36     { CODEC_ID_MPEG2VIDEO, 0x60 }, /* MPEG2 Simple */
37     { CODEC_ID_MPEG2VIDEO, 0x62 }, /* MPEG2 SNR */
38     { CODEC_ID_MPEG2VIDEO, 0x63 }, /* MPEG2 Spatial */
39     { CODEC_ID_MPEG2VIDEO, 0x64 }, /* MPEG2 High */
40     { CODEC_ID_MPEG2VIDEO, 0x65 }, /* MPEG2 422 */
41     { CODEC_ID_AAC       , 0x66 }, /* MPEG2 AAC Main */
42     { CODEC_ID_AAC       , 0x67 }, /* MPEG2 AAC Low */
43     { CODEC_ID_AAC       , 0x68 }, /* MPEG2 AAC SSR */
44     { CODEC_ID_MP3       , 0x69 }, /* 13818-3 */
45     { CODEC_ID_MP2       , 0x69 }, /* 11172-3 */
46     { CODEC_ID_MPEG1VIDEO, 0x6A }, /* 11172-2 */
47     { CODEC_ID_MP3       , 0x6B }, /* 11172-3 */
48     { CODEC_ID_MJPEG     , 0x6C }, /* 10918-1 */
49     { CODEC_ID_PNG       , 0x6D },
50     { CODEC_ID_JPEG2000  , 0x6E }, /* 15444-1 */
51     { CODEC_ID_VC1       , 0xA3 },
52     { CODEC_ID_DIRAC     , 0xA4 },
53     { CODEC_ID_AC3       , 0xA5 },
54     { CODEC_ID_VORBIS    , 0xDD }, /* non standard, gpac uses it */
55     { CODEC_ID_DVD_SUBTITLE, 0xE0 }, /* non standard, see unsupported-embedded-subs-2.mp4 */
56     { CODEC_ID_QCELP     , 0xE1 },
57     { 0, 0 },
58 };
59
60 const AVCodecTag codec_movvideo_tags[] = {
61 /*  { CODEC_ID_, MKTAG('I', 'V', '5', '0') }, *//* Indeo 5.0 */
62
63     { CODEC_ID_RAWVIDEO, MKTAG('r', 'a', 'w', ' ') }, /* Uncompressed RGB */
64 /*  { CODEC_ID_RAWVIDEO, MKTAG('Y', 'u', 'v', '2') }, *//* Uncompressed YUV422 */
65     { CODEC_ID_RAWVIDEO, MKTAG('A', 'V', 'U', 'I') }, /* YUV with alpha-channel (AVID Uncompressed) */
66     { CODEC_ID_RAWVIDEO, MKTAG('2', 'v', 'u', 'y') }, /* UNCOMPRESSED 8BIT 4:2:2 */
67
68     { CODEC_ID_MJPEG,  MKTAG('j', 'p', 'e', 'g') }, /* PhotoJPEG */
69     { CODEC_ID_MJPEG,  MKTAG('m', 'j', 'p', 'a') }, /* Motion-JPEG (format A) */
70     { CODEC_ID_MJPEG,  MKTAG('A', 'V', 'D', 'J') }, /* MJPEG with alpha-channel (AVID JFIF meridien compressed) */
71 /*  { CODEC_ID_MJPEG,  MKTAG('A', 'V', 'R', 'n') }, *//* MJPEG with alpha-channel (AVID ABVB/Truevision NuVista) */
72     { CODEC_ID_MJPEG,  MKTAG('d', 'm', 'b', '1') }, /* Motion JPEG OpenDML */
73     { CODEC_ID_MJPEGB, MKTAG('m', 'j', 'p', 'b') }, /* Motion-JPEG (format B) */
74
75     { CODEC_ID_SVQ1, MKTAG('S', 'V', 'Q', '1') }, /* Sorenson Video v1 */
76     { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', '1') }, /* Sorenson Video v1 */
77     { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', 'i') }, /* Sorenson Video v1 (from QT specs)*/
78     { CODEC_ID_SVQ3, MKTAG('S', 'V', 'Q', '3') }, /* Sorenson Video v3 */
79
80     { CODEC_ID_MPEG4, MKTAG('m', 'p', '4', 'v') },
81     { CODEC_ID_MPEG4, MKTAG('D', 'I', 'V', 'X') }, /* OpenDiVX *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
82     { CODEC_ID_MPEG4, MKTAG('X', 'V', 'I', 'D') },
83     { CODEC_ID_MPEG4, MKTAG('3', 'I', 'V', '2') }, /* experimental: 3IVX files before ivx D4 4.5.1 */
84
85     { CODEC_ID_H263, MKTAG('h', '2', '6', '3') }, /* H263 */
86     { CODEC_ID_H263, MKTAG('s', '2', '6', '3') }, /* H263 ?? works */
87
88     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', 'p') }, /* DV PAL */
89     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', ' ') }, /* DV NTSC */
90     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'p', 'p') }, /* DVCPRO PAL produced by FCP */
91     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'p') }, /* DVCPRO50 PAL produced by FCP */
92     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'n') }, /* DVCPRO50 NTSC produced by FCP */
93     { CODEC_ID_DVVIDEO, MKTAG('A', 'V', 'd', 'v') }, /* AVID DV */
94     { CODEC_ID_DVVIDEO, MKTAG('A', 'V', 'd', '1') }, /* AVID DV100 */
95     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', 'q') }, /* DVCPRO HD 720p50 */
96     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', 'p') }, /* DVCPRO HD 720p60 */
97     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '5') }, /* DVCPRO HD 50i produced by FCP */
98     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '6') }, /* DVCPRO HD 60i produced by FCP */
99     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '3') }, /* DVCPRO HD 30p produced by FCP */
100
101     { CODEC_ID_VP3,     MKTAG('V', 'P', '3', '1') }, /* On2 VP3 */
102     { CODEC_ID_RPZA,    MKTAG('r', 'p', 'z', 'a') }, /* Apple Video (RPZA) */
103     { CODEC_ID_CINEPAK, MKTAG('c', 'v', 'i', 'd') }, /* Cinepak */
104     { CODEC_ID_8BPS,    MKTAG('8', 'B', 'P', 'S') }, /* Planar RGB (8BPS) */
105     { CODEC_ID_SMC,     MKTAG('s', 'm', 'c', ' ') }, /* Apple Graphics (SMC) */
106     { CODEC_ID_QTRLE,   MKTAG('r', 'l', 'e', ' ') }, /* Apple Animation (RLE) */
107     { CODEC_ID_MSRLE,   MKTAG('W', 'R', 'L', 'E') },
108     { CODEC_ID_QDRAW,   MKTAG('q', 'd', 'r', 'w') }, /* QuickDraw */
109
110     { CODEC_ID_RAWVIDEO, MKTAG('W', 'R', 'A', 'W') },
111
112     { CODEC_ID_H264, MKTAG('a', 'v', 'c', '1') }, /* AVC-1/H.264 */
113
114     { CODEC_ID_MPEG1VIDEO, MKTAG('m', 'p', 'e', 'g') }, /* MPEG */
115     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '1') }, /* MPEG2 HDV 720p30 */
116     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '2') }, /* MPEG2 HDV 1080i60 */
117     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '3') }, /* MPEG2 HDV 1080i50 */
118     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '5') }, /* MPEG2 HDV 720p25 */
119     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '6') }, /* MPEG2 HDV 1080p24 */
120     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '7') }, /* MPEG2 HDV 1080p25 */
121     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '8') }, /* MPEG2 HDV 1080p30 */
122     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'n') }, /* MPEG2 IMX NTSC 525/60 50mb/s produced by FCP */
123     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'p') }, /* MPEG2 IMX PAL 625/50 50mb/s produced by FCP */
124     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '4', 'n') }, /* MPEG2 IMX NTSC 525/60 40mb/s produced by FCP */
125     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '4', 'p') }, /* MPEG2 IMX PAL 625/50 40mb/s produced by FCP */
126     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'n') }, /* MPEG2 IMX NTSC 525/60 30mb/s produced by FCP */
127     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'p') }, /* MPEG2 IMX PAL 625/50 30mb/s produced by FCP */
128     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', '9') }, /* XDCAM HD422 720p60 CBR */
129     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'a') }, /* XDCAM HD422 720p50 CBR */
130     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'b') }, /* XDCAM HD422 1080i60 CBR */
131     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'c') }, /* XDCAM HD422 1080i50 CBR */
132     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'd') }, /* XDCAM HD422 1080p24 CBR */
133     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'e') }, /* XDCAM HD422 1080p25 CBR */
134     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', '5', 'f') }, /* XDCAM HD422 1080p30 CBR */
135     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '1') }, /* XDCAM EX 720p30 VBR */
136     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '2') }, /* XDCAM HD 1080i60 */
137     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '3') }, /* XDCAM HD 1080i50 VBR */
138     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '4') }, /* XDCAM EX 720p24 VBR */
139     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '5') }, /* XDCAM EX 720p25 VBR */
140     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '6') }, /* XDCAM HD 1080p24 VBR */
141     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '7') }, /* XDCAM HD 1080p25 VBR */
142     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '8') }, /* XDCAM HD 1080p30 VBR */
143     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '9') }, /* XDCAM EX 720p60 VBR */
144     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'a') }, /* XDCAM EX 720p50 VBR */
145     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'b') }, /* XDCAM EX 1080i60 VBR */
146     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'c') }, /* XDCAM EX 1080i50 VBR */
147     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'd') }, /* XDCAM EX 1080p24 VBR */
148     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'e') }, /* XDCAM EX 1080p25 VBR */
149     { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', 'f') }, /* XDCAM EX 1080p30 VBR */
150     { CODEC_ID_MPEG2VIDEO, MKTAG('A', 'V', 'm', 'p') }, /* AVID IMX PAL */
151
152     { CODEC_ID_JPEG2000, MKTAG('m', 'j', 'p', '2') }, /* JPEG 2000 produced by FCP */
153
154     { CODEC_ID_TARGA, MKTAG('t', 'g', 'a', ' ') }, /* Truevision Targa */
155     { CODEC_ID_TIFF,  MKTAG('t', 'i', 'f', 'f') }, /* TIFF embedded in MOV */
156     { CODEC_ID_GIF,   MKTAG('g', 'i', 'f', ' ') }, /* embedded gif files as frames (usually one "click to play movie" frame) */
157     { CODEC_ID_PNG,   MKTAG('p', 'n', 'g', ' ') },
158
159     { CODEC_ID_VC1, MKTAG('v', 'c', '-', '1') }, /* SMPTE RP 2025 */
160     { CODEC_ID_CAVS, MKTAG('a', 'v', 's', '2') },
161
162     { CODEC_ID_DIRAC, MKTAG('d', 'r', 'a', 'c') },
163     { CODEC_ID_DNXHD, MKTAG('A', 'V', 'd', 'n') }, /* AVID DNxHD */
164     { CODEC_ID_SGI,   MKTAG('s', 'g', 'i', ' ') }, /* SGI  */
165
166     { CODEC_ID_NONE, 0 },
167 };
168
169 const AVCodecTag codec_movaudio_tags[] = {
170     { CODEC_ID_PCM_S32BE, MKTAG('i', 'n', '3', '2') },
171     { CODEC_ID_PCM_S32LE, MKTAG('i', 'n', '3', '2') },
172     { CODEC_ID_PCM_S24BE, MKTAG('i', 'n', '2', '4') },
173     { CODEC_ID_PCM_S24LE, MKTAG('i', 'n', '2', '4') },
174     { CODEC_ID_PCM_S16BE, MKTAG('t', 'w', 'o', 's') }, /* 16 bits */
175     { CODEC_ID_PCM_S16LE, MKTAG('s', 'o', 'w', 't') }, /*  */
176     { CODEC_ID_PCM_S16LE, MKTAG('l', 'p', 'c', 'm') },
177     { CODEC_ID_PCM_F32BE, MKTAG('f', 'l', '3', '2') },
178     { CODEC_ID_PCM_F64BE, MKTAG('f', 'l', '6', '4') },
179     { CODEC_ID_PCM_S8,    MKTAG('s', 'o', 'w', 't') },
180     { CODEC_ID_PCM_U8,    MKTAG('r', 'a', 'w', ' ') }, /* 8 bits unsigned */
181     { CODEC_ID_PCM_U8,    MKTAG('N', 'O', 'N', 'E') }, /* uncompressed */
182     { CODEC_ID_PCM_MULAW, MKTAG('u', 'l', 'a', 'w') }, /*  */
183     { CODEC_ID_PCM_ALAW,  MKTAG('a', 'l', 'a', 'w') }, /*  */
184
185     { CODEC_ID_ADPCM_IMA_QT, MKTAG('i', 'm', 'a', '4') }, /* IMA-4 ADPCM */
186
187     { CODEC_ID_MACE3, MKTAG('M', 'A', 'C', '3') }, /* Macintosh Audio Compression and Expansion 3:1 */
188     { CODEC_ID_MACE6, MKTAG('M', 'A', 'C', '6') }, /* Macintosh Audio Compression and Expansion 6:1 */
189
190     { CODEC_ID_MP3, MKTAG('.', 'm', 'p', '3') }, /* MPEG layer 3 */ /* sample files at http://www.3ivx.com/showcase.html use this tag */
191     { CODEC_ID_MP3, 0x6D730055 }, /* MPEG layer 3 */
192
193 /*  { CODEC_ID_OGG_VORBIS, MKTAG('O', 'g', 'g', 'S') }, *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
194
195     { CODEC_ID_AAC, MKTAG('m', 'p', '4', 'a') }, /* MPEG-4 AAC */
196     { CODEC_ID_AC3, MKTAG('a', 'c', '-', '3') }, /* ETSI TS 102 366 Annex F */
197
198     { CODEC_ID_AMR_NB, MKTAG('s', 'a', 'm', 'r') }, /* AMR-NB 3gp */
199     { CODEC_ID_AMR_WB, MKTAG('s', 'a', 'w', 'b') }, /* AMR-WB 3gp */
200
201     { CODEC_ID_GSM,  MKTAG('a', 'g', 's', 'm') },
202     { CODEC_ID_ALAC, MKTAG('a', 'l', 'a', 'c') }, /* Apple Lossless */
203
204     { CODEC_ID_QCELP, MKTAG('Q','c','l','p') },
205     { CODEC_ID_QCELP, MKTAG('s','q','c','p') }, /* ISO Media fourcc */
206
207     { CODEC_ID_QDM2, MKTAG('Q', 'D', 'M', '2') }, /* QDM2 */
208
209     { CODEC_ID_DVAUDIO, MKTAG('v', 'd', 'v', 'a') },
210     { CODEC_ID_DVAUDIO, MKTAG('d', 'v', 'c', 'a') },
211
212     { CODEC_ID_WMAV2, MKTAG('W', 'M', 'A', '2') },
213
214     { CODEC_ID_NONE, 0 },
215 };
216
217 const AVCodecTag ff_codec_movsubtitle_tags[] = {
218     { CODEC_ID_MOV_TEXT, MKTAG('t', 'e', 'x', 't') },
219     { CODEC_ID_MOV_TEXT, MKTAG('t', 'x', '3', 'g') },
220     { CODEC_ID_NONE, 0 },
221 };
222
223 /* map numeric codes from mdhd atom to ISO 639 */
224 /* cf. QTFileFormat.pdf p253, qtff.pdf p205 */
225 /* http://developer.apple.com/documentation/mac/Text/Text-368.html */
226 /* deprecated by putting the code as 3*5bit ascii */
227 static const char * const mov_mdhd_language_map[] = {
228     /* 0-9 */
229     "eng", "fra", "ger", "ita", "dut", "sve", "spa", "dan", "por", "nor",
230     "heb", "jpn", "ara", "fin", "gre", "ice", "mlt", "tur", "hr "/*scr*/, "chi"/*ace?*/,
231     "urd", "hin", "tha", "kor", "lit", "pol", "hun", "est", "lav",  NULL,
232     "fo ",  NULL, "rus", "chi",  NULL, "iri", "alb", "ron", "ces", "slk",
233     "slv", "yid", "sr ", "mac", "bul", "ukr", "bel", "uzb", "kaz", "aze",
234     /*?*/
235     "aze", "arm", "geo", "mol", "kir", "tgk", "tuk", "mon",  NULL, "pus",
236     "kur", "kas", "snd", "tib", "nep", "san", "mar", "ben", "asm", "guj",
237     "pa ", "ori", "mal", "kan", "tam", "tel",  NULL, "bur", "khm", "lao",
238     /*                   roman? arabic? */
239     "vie", "ind", "tgl", "may", "may", "amh", "tir", "orm", "som", "swa",
240     /*==rundi?*/
241     NULL, "run",  NULL, "mlg", "epo",  NULL,  NULL,  NULL,  NULL,  NULL,
242     /* 100 */
243     NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,
244     NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,
245     NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL, "wel", "baq",
246     "cat", "lat", "que", "grn", "aym", "tat", "uig", "dzo", "jav"
247 };
248
249 int ff_mov_iso639_to_lang(const char *lang, int mp4)
250 {
251     int i, code = 0;
252
253     /* old way, only for QT? */
254     for (i = 0; !mp4 && i < FF_ARRAY_ELEMS(mov_mdhd_language_map); i++) {
255         if (mov_mdhd_language_map[i] && !strcmp(lang, mov_mdhd_language_map[i]))
256             return i;
257     }
258     /* XXX:can we do that in mov too? */
259     if (!mp4)
260         return 0;
261     /* handle undefined as such */
262     if (lang[0] == '\0')
263         lang = "und";
264     /* 5bit ascii */
265     for (i = 0; i < 3; i++) {
266         unsigned char c = (unsigned char)lang[i];
267         if (c < 0x60)
268             return 0;
269         if (c > 0x60 + 0x1f)
270             return 0;
271         code <<= 5;
272         code |= (c - 0x60);
273     }
274     return code;
275 }
276
277 int ff_mov_lang_to_iso639(int code, char *to)
278 {
279     int i;
280     /* is it the mangled iso code? */
281     /* see http://www.geocities.com/xhelmboyx/quicktime/formats/mp4-layout.txt */
282     if (code > 138) {
283         for (i = 2; i >= 0; i--) {
284             to[i] = 0x60 + (code & 0x1f);
285             code >>= 5;
286         }
287         return 1;
288     }
289     /* old fashion apple lang code */
290     if (code >= FF_ARRAY_ELEMS(mov_mdhd_language_map))
291         return 0;
292     if (!mov_mdhd_language_map[code])
293         return 0;
294     strncpy(to, mov_mdhd_language_map[code], 4);
295     return 1;
296 }