]> git.sesse.net Git - ffmpeg/blob - libavformat/isom.c
add specifications reference comments
[ffmpeg] / 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 const AVCodecTag ff_mov_obj_type[] = {
30     { CODEC_ID_MPEG4     ,  32 },
31     { CODEC_ID_H264      ,  33 },
32     { CODEC_ID_AAC       ,  64 },
33     { CODEC_ID_MPEG2VIDEO,  96 }, /* MPEG2 Simple */
34     { CODEC_ID_MPEG2VIDEO,  97 }, /* MPEG2 Main */
35     { CODEC_ID_MPEG2VIDEO,  98 }, /* MPEG2 SNR */
36     { CODEC_ID_MPEG2VIDEO,  99 }, /* MPEG2 Spatial */
37     { CODEC_ID_MPEG2VIDEO, 100 }, /* MPEG2 High */
38     { CODEC_ID_MPEG2VIDEO, 101 }, /* MPEG2 422 */
39     { CODEC_ID_AAC       , 102 }, /* MPEG2 AAC Main */
40     { CODEC_ID_AAC       , 103 }, /* MPEG2 AAC Low */
41     { CODEC_ID_AAC       , 104 }, /* MPEG2 AAC SSR */
42     { CODEC_ID_MP3       , 105 }, /* 13818-3 */
43     { CODEC_ID_MPEG1VIDEO, 106 }, /* 11172-2 */
44     { CODEC_ID_MP2       , 107 }, /* 11172-3 */
45     { CODEC_ID_MJPEG     , 108 }, /* 10918-1 */
46     { CODEC_ID_PCM_S16LE , 224 },
47     { CODEC_ID_VORBIS    , 221 },
48     { CODEC_ID_QCELP     , 225 },
49     { CODEC_ID_AC3       , 226 },
50     { CODEC_ID_PCM_ALAW  , 227 },
51     { CODEC_ID_PCM_MULAW , 228 },
52     { CODEC_ID_PCM_S16BE , 230 },
53     { CODEC_ID_H263      , 242 },
54     { CODEC_ID_H261      , 243 },
55     { 0, 0 },
56 };
57
58 const AVCodecTag codec_movvideo_tags[] = {
59 /*  { CODEC_ID_, MKTAG('I', 'V', '5', '0') }, *//* Indeo 5.0 */
60
61     { CODEC_ID_RAWVIDEO, MKTAG('r', 'a', 'w', ' ') }, /* Uncompressed RGB */
62 /*  { CODEC_ID_RAWVIDEO, MKTAG('Y', 'u', 'v', '2') }, *//* Uncompressed YUV422 */
63     { CODEC_ID_RAWVIDEO, MKTAG('A', 'V', 'U', 'I') }, /* YUV with alpha-channel (AVID Uncompressed) */
64     { CODEC_ID_RAWVIDEO, MKTAG('2', 'v', 'u', 'y') }, /* UNCOMPRESSED 8BIT 4:2:2 */
65
66     { CODEC_ID_MJPEG,  MKTAG('j', 'p', 'e', 'g') }, /* PhotoJPEG */
67     { CODEC_ID_MJPEG,  MKTAG('m', 'j', 'p', 'a') }, /* Motion-JPEG (format A) */
68     { CODEC_ID_MJPEG,  MKTAG('A', 'V', 'D', 'J') }, /* MJPEG with alpha-channel (AVID JFIF meridien compressed) */
69 /*  { CODEC_ID_MJPEG,  MKTAG('A', 'V', 'R', 'n') }, *//* MJPEG with alpha-channel (AVID ABVB/Truevision NuVista) */
70     { CODEC_ID_MJPEGB, MKTAG('m', 'j', 'p', 'b') }, /* Motion-JPEG (format B) */
71
72     { CODEC_ID_SVQ1, MKTAG('S', 'V', 'Q', '1') }, /* Sorenson Video v1 */
73     { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', '1') }, /* Sorenson Video v1 */
74     { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', 'i') }, /* Sorenson Video v1 (from QT specs)*/
75     { CODEC_ID_SVQ3, MKTAG('S', 'V', 'Q', '3') }, /* Sorenson Video v3 */
76
77     { CODEC_ID_MPEG4, MKTAG('m', 'p', '4', 'v') },
78     { CODEC_ID_MPEG4, MKTAG('D', 'I', 'V', 'X') }, /* OpenDiVX *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
79     { CODEC_ID_MPEG4, MKTAG('X', 'V', 'I', 'D') },
80     { CODEC_ID_MPEG4, MKTAG('3', 'I', 'V', '2') }, /* experimental: 3IVX files before ivx D4 4.5.1 */
81
82     { CODEC_ID_H263, MKTAG('h', '2', '6', '3') }, /* H263 */
83     { CODEC_ID_H263, MKTAG('s', '2', '6', '3') }, /* H263 ?? works */
84
85     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', 'p') }, /* DV PAL */
86     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', ' ') }, /* DV NTSC */
87     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'p', 'p') }, /* DVCPRO PAL produced by FCP */
88     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'p') }, /* DVCPRO50 PAL produced by FCP */
89     { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'n') }, /* DVCPRO50 NTSC produced by FCP */
90     { CODEC_ID_DVVIDEO, MKTAG('A', 'V', 'd', 'v') }, /* AVID DV */
91   //{ CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '5') }, /* DVCPRO HD 50i produced by FCP */
92   //{ CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '6') }, /* DVCPRO HD 60i produced by FCP */
93
94     { CODEC_ID_VP3,     MKTAG('V', 'P', '3', '1') }, /* On2 VP3 */
95     { CODEC_ID_RPZA,    MKTAG('r', 'p', 'z', 'a') }, /* Apple Video (RPZA) */
96     { CODEC_ID_CINEPAK, MKTAG('c', 'v', 'i', 'd') }, /* Cinepak */
97     { CODEC_ID_8BPS,    MKTAG('8', 'B', 'P', 'S') }, /* Planar RGB (8BPS) */
98     { CODEC_ID_SMC,     MKTAG('s', 'm', 'c', ' ') }, /* Apple Graphics (SMC) */
99     { CODEC_ID_QTRLE,   MKTAG('r', 'l', 'e', ' ') }, /* Apple Animation (RLE) */
100     { CODEC_ID_MSRLE,   MKTAG('W', 'R', 'L', 'E') },
101     { CODEC_ID_QDRAW,   MKTAG('q', 'd', 'r', 'w') }, /* QuickDraw */
102
103     { CODEC_ID_H264, MKTAG('a', 'v', 'c', '1') }, /* AVC-1/H.264 */
104
105     { CODEC_ID_MPEG1VIDEO, MKTAG('m', 'p', 'e', 'g') }, /* MPEG */
106     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '2') }, /* MPEG2 produced by Sony HD camera */
107     { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '3') }, /* HDV produced by FCP */
108     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'n') }, /* MPEG2 IMX NTSC 525/60 50mb/s produced by FCP */
109     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'p') }, /* MPEG2 IMX PAL 625/50 50mb/s produced by FCP */
110     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'n') }, /* MPEG2 IMX NTSC 525/60 30mb/s produced by FCP */
111     { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'p') }, /* MPEG2 IMX PAL 625/50 30mb/s produced by FCP */
112     { CODEC_ID_MPEG2VIDEO, MKTAG('A', 'V', 'm', 'p') }, /* AVID IMX PAL */
113
114   //{ CODEC_ID_JPEG2000, MKTAG('m', 'j', 'p', '2') }, /* JPEG 2000 produced by FCP */
115
116     { CODEC_ID_TARGA, MKTAG('t', 'g', 'a', ' ') }, /* Truevision Targa */
117     { CODEC_ID_TIFF,  MKTAG('t', 'i', 'f', 'f') }, /* TIFF embedded in MOV */
118     { CODEC_ID_GIF,   MKTAG('g', 'i', 'f', ' ') }, /* embedded gif files as frames (usually one "click to play movie" frame) */
119     { CODEC_ID_PNG,   MKTAG('p', 'n', 'g', ' ') },
120
121     { CODEC_ID_VC1, MKTAG('v', 'c', '-', '1') }, /* SMPTE RP 2025 */
122
123     { CODEC_ID_DNXHD, MKTAG('A', 'V', 'd', 'n') }, /* AVID DNxHD */
124
125     { CODEC_ID_NONE, 0 },
126 };
127
128 const AVCodecTag codec_movaudio_tags[] = {
129     { CODEC_ID_PCM_S32BE, MKTAG('i', 'n', '3', '2') },
130     { CODEC_ID_PCM_S32LE, MKTAG('i', 'n', '3', '2') },
131     { CODEC_ID_PCM_S24BE, MKTAG('i', 'n', '2', '4') },
132     { CODEC_ID_PCM_S24LE, MKTAG('i', 'n', '2', '4') },
133     { CODEC_ID_PCM_S16BE, MKTAG('t', 'w', 'o', 's') }, /* 16 bits */
134     { CODEC_ID_PCM_S16BE, MKTAG('N', 'O', 'N', 'E') }, /* uncompressed */
135     { CODEC_ID_PCM_S16LE, MKTAG('s', 'o', 'w', 't') }, /*  */
136     { CODEC_ID_PCM_S16LE, MKTAG('l', 'p', 'c', 'm') },
137     { CODEC_ID_PCM_S8,    MKTAG('s', 'o', 'w', 't') },
138     { CODEC_ID_PCM_U8,    MKTAG('r', 'a', 'w', ' ') }, /* 8 bits unsigned */
139     { CODEC_ID_PCM_MULAW, MKTAG('u', 'l', 'a', 'w') }, /*  */
140     { CODEC_ID_PCM_ALAW,  MKTAG('a', 'l', 'a', 'w') }, /*  */
141
142     { CODEC_ID_ADPCM_IMA_QT, MKTAG('i', 'm', 'a', '4') }, /* IMA-4 ADPCM */
143     { CODEC_ID_ADPCM_MS,     MKTAG('m', 's', 0x00, 0x02) }, /* MS ADPCM */
144
145     { CODEC_ID_MACE3, MKTAG('M', 'A', 'C', '3') }, /* Macintosh Audio Compression and Expansion 3:1 */
146     { CODEC_ID_MACE6, MKTAG('M', 'A', 'C', '6') }, /* Macintosh Audio Compression and Expansion 6:1 */
147
148     { CODEC_ID_MP3, MKTAG('.', 'm', 'p', '3') }, /* MPEG layer 3 */ /* sample files at http://www.3ivx.com/showcase.html use this tag */
149     { CODEC_ID_MP2, 0x6D730055 }, /* MPEG layer 3 */
150     { CODEC_ID_MP2, 0x5500736D }, /* MPEG layer 3 *//* XXX: check endianness */
151
152 /*  { CODEC_ID_OGG_VORBIS, MKTAG('O', 'g', 'g', 'S') }, *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
153
154     { CODEC_ID_AAC, MKTAG('m', 'p', '4', 'a') }, /* MPEG-4 AAC */
155
156     { CODEC_ID_AMR_NB, MKTAG('s', 'a', 'm', 'r') }, /* AMR-NB 3gp */
157     { CODEC_ID_AMR_WB, MKTAG('s', 'a', 'w', 'b') }, /* AMR-WB 3gp */
158
159     { CODEC_ID_AC3,  MKTAG('m', 's', 0x20, 0x00) }, /* Dolby AC-3 */
160
161     { CODEC_ID_ALAC, MKTAG('a', 'l', 'a', 'c') }, /* Apple Lossless */
162     { CODEC_ID_QDM2, MKTAG('Q', 'D', 'M', '2') }, /* QDM2 */
163
164     { CODEC_ID_DVAUDIO, MKTAG('v', 'd', 'v', 'a') },
165     { CODEC_ID_DVAUDIO, MKTAG('d', 'v', 'c', 'a') },
166
167     { CODEC_ID_NONE, 0 },
168 };
169
170 /* map numeric codes from mdhd atom to ISO 639 */
171 /* cf. QTFileFormat.pdf p253, qtff.pdf p205 */
172 /* http://developer.apple.com/documentation/mac/Text/Text-368.html */
173 /* deprecated by putting the code as 3*5bit ascii */
174 static const char *mov_mdhd_language_map[] = {
175     /* 0-9 */
176     "eng", "fra", "ger", "ita", "dut", "sve", "spa", "dan", "por", "nor",
177     "heb", "jpn", "ara", "fin", "gre", "ice", "mlt", "tur", "hr "/*scr*/, "chi"/*ace?*/,
178     "urd", "hin", "tha", "kor", "lit", "pol", "hun", "est", "lav",  NULL,
179     "fo ",  NULL, "rus", "chi",  NULL, "iri", "alb", "ron", "ces", "slk",
180     "slv", "yid", "sr ", "mac", "bul", "ukr", "bel", "uzb", "kaz", "aze",
181     /*?*/
182     "aze", "arm", "geo", "mol", "kir", "tgk", "tuk", "mon",  NULL, "pus",
183     "kur", "kas", "snd", "tib", "nep", "san", "mar", "ben", "asm", "guj",
184     "pa ", "ori", "mal", "kan", "tam", "tel",  NULL, "bur", "khm", "lao",
185     /*                   roman? arabic? */
186     "vie", "ind", "tgl", "may", "may", "amh", "tir", "orm", "som", "swa",
187     /*==rundi?*/
188     NULL, "run",  NULL, "mlg", "epo",  NULL,  NULL,  NULL,  NULL,  NULL,
189     /* 100 */
190     NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,
191     NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,
192     NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL,  NULL, "wel", "baq",
193     "cat", "lat", "que", "grn", "aym", "tat", "uig", "dzo", "jav"
194 };
195
196 int ff_mov_iso639_to_lang(const char *lang, int mp4)
197 {
198     int i, code = 0;
199
200     /* old way, only for QT? */
201     for (i = 0; !mp4 && (i < (sizeof(mov_mdhd_language_map)/sizeof(char *))); i++) {
202         if (mov_mdhd_language_map[i] && !strcmp(lang, mov_mdhd_language_map[i]))
203             return i;
204     }
205     /* XXX:can we do that in mov too? */
206     if (!mp4)
207         return 0;
208     /* handle undefined as such */
209     if (lang[0] == '\0')
210         lang = "und";
211     /* 5bit ascii */
212     for (i = 0; i < 3; i++) {
213         unsigned char c = (unsigned char)lang[i];
214         if (c < 0x60)
215             return 0;
216         if (c > 0x60 + 0x1f)
217             return 0;
218         code <<= 5;
219         code |= (c - 0x60);
220     }
221     return code;
222 }
223
224 int ff_mov_lang_to_iso639(int code, char *to)
225 {
226     int i;
227     /* is it the mangled iso code? */
228     /* see http://www.geocities.com/xhelmboyx/quicktime/formats/mp4-layout.txt */
229     if (code > 138) {
230         for (i = 2; i >= 0; i--) {
231             to[i] = 0x60 + (code & 0x1f);
232             code >>= 5;
233         }
234         return 1;
235     }
236     /* old fashion apple lang code */
237     if (code >= (sizeof(mov_mdhd_language_map)/sizeof(char *)))
238         return 0;
239     if (!mov_mdhd_language_map[code])
240         return 0;
241     strncpy(to, mov_mdhd_language_map[code], 4);
242     return 1;
243 }