document tag field
[libav.git] / libavformat / isom.c
CommitLineData
e40ee6a2
BC
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 *
b78e7197
DB
7 * This file is part of FFmpeg.
8 *
9 * FFmpeg is free software; you can redistribute it and/or
e40ee6a2
BC
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
b78e7197 12 * version 2.1 of the License, or (at your option) any later version.
e40ee6a2 13 *
b78e7197 14 * FFmpeg is distributed in the hope that it will be useful,
e40ee6a2
BC
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
b78e7197 20 * License along with FFmpeg; if not, write to the Free Software
e40ee6a2
BC
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
7555d2e6 28/* http://www.mp4ra.org */
ccba88d7 29const AVCodecTag ff_mp4_obj_type[] = {
e40ee6a2
BC
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 */
7555d2e6
BC
42 { CODEC_ID_MP3 , 105 }, /* 13818-3 */
43 { CODEC_ID_MPEG1VIDEO, 106 }, /* 11172-2 */
b41899c6 44 { CODEC_ID_MP3 , 107 }, /* 11172-3 */
7555d2e6 45 { CODEC_ID_MJPEG , 108 }, /* 10918-1 */
2b4162f0
BC
46 { CODEC_ID_PNG , 109 },
47 { CODEC_ID_JPEG2000 , 110 }, /* 15444-1 */
48 { CODEC_ID_VC1 , 163 },
067db6a5 49 { CODEC_ID_VORBIS , 221 }, /* non standard, gpac uses it */
e73e3a92 50 { CODEC_ID_DVD_SUBTITLE, 224 }, /* non standard, see unsupported-embedded-subs-2.mp4 */
6c496518 51 { CODEC_ID_QCELP , 225 },
e40ee6a2
BC
52 { 0, 0 },
53};
54
1e5f5e3b
BC
55const AVCodecTag codec_movvideo_tags[] = {
56/* { CODEC_ID_, MKTAG('I', 'V', '5', '0') }, *//* Indeo 5.0 */
57
58 { CODEC_ID_RAWVIDEO, MKTAG('r', 'a', 'w', ' ') }, /* Uncompressed RGB */
59/* { CODEC_ID_RAWVIDEO, MKTAG('Y', 'u', 'v', '2') }, *//* Uncompressed YUV422 */
60 { CODEC_ID_RAWVIDEO, MKTAG('A', 'V', 'U', 'I') }, /* YUV with alpha-channel (AVID Uncompressed) */
61 { CODEC_ID_RAWVIDEO, MKTAG('2', 'v', 'u', 'y') }, /* UNCOMPRESSED 8BIT 4:2:2 */
62
63 { CODEC_ID_MJPEG, MKTAG('j', 'p', 'e', 'g') }, /* PhotoJPEG */
64 { CODEC_ID_MJPEG, MKTAG('m', 'j', 'p', 'a') }, /* Motion-JPEG (format A) */
65 { CODEC_ID_MJPEG, MKTAG('A', 'V', 'D', 'J') }, /* MJPEG with alpha-channel (AVID JFIF meridien compressed) */
66/* { CODEC_ID_MJPEG, MKTAG('A', 'V', 'R', 'n') }, *//* MJPEG with alpha-channel (AVID ABVB/Truevision NuVista) */
c3ebc833 67 { CODEC_ID_MJPEG, MKTAG('d', 'm', 'b', '1') }, /* Motion JPEG OpenDML */
1e5f5e3b
BC
68 { CODEC_ID_MJPEGB, MKTAG('m', 'j', 'p', 'b') }, /* Motion-JPEG (format B) */
69
70 { CODEC_ID_SVQ1, MKTAG('S', 'V', 'Q', '1') }, /* Sorenson Video v1 */
71 { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', '1') }, /* Sorenson Video v1 */
72 { CODEC_ID_SVQ1, MKTAG('s', 'v', 'q', 'i') }, /* Sorenson Video v1 (from QT specs)*/
73 { CODEC_ID_SVQ3, MKTAG('S', 'V', 'Q', '3') }, /* Sorenson Video v3 */
74
75 { CODEC_ID_MPEG4, MKTAG('m', 'p', '4', 'v') },
76 { CODEC_ID_MPEG4, MKTAG('D', 'I', 'V', 'X') }, /* OpenDiVX *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
77 { CODEC_ID_MPEG4, MKTAG('X', 'V', 'I', 'D') },
78 { CODEC_ID_MPEG4, MKTAG('3', 'I', 'V', '2') }, /* experimental: 3IVX files before ivx D4 4.5.1 */
79
80 { CODEC_ID_H263, MKTAG('h', '2', '6', '3') }, /* H263 */
81 { CODEC_ID_H263, MKTAG('s', '2', '6', '3') }, /* H263 ?? works */
82
83 { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', 'p') }, /* DV PAL */
84 { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'c', ' ') }, /* DV NTSC */
85 { CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'p', 'p') }, /* DVCPRO PAL produced by FCP */
86 { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'p') }, /* DVCPRO50 PAL produced by FCP */
87 { CODEC_ID_DVVIDEO, MKTAG('d', 'v', '5', 'n') }, /* DVCPRO50 NTSC produced by FCP */
88 { CODEC_ID_DVVIDEO, MKTAG('A', 'V', 'd', 'v') }, /* AVID DV */
89 //{ CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '5') }, /* DVCPRO HD 50i produced by FCP */
90 //{ CODEC_ID_DVVIDEO, MKTAG('d', 'v', 'h', '6') }, /* DVCPRO HD 60i produced by FCP */
91
92 { CODEC_ID_VP3, MKTAG('V', 'P', '3', '1') }, /* On2 VP3 */
93 { CODEC_ID_RPZA, MKTAG('r', 'p', 'z', 'a') }, /* Apple Video (RPZA) */
94 { CODEC_ID_CINEPAK, MKTAG('c', 'v', 'i', 'd') }, /* Cinepak */
95 { CODEC_ID_8BPS, MKTAG('8', 'B', 'P', 'S') }, /* Planar RGB (8BPS) */
96 { CODEC_ID_SMC, MKTAG('s', 'm', 'c', ' ') }, /* Apple Graphics (SMC) */
97 { CODEC_ID_QTRLE, MKTAG('r', 'l', 'e', ' ') }, /* Apple Animation (RLE) */
98 { CODEC_ID_MSRLE, MKTAG('W', 'R', 'L', 'E') },
99 { CODEC_ID_QDRAW, MKTAG('q', 'd', 'r', 'w') }, /* QuickDraw */
100
101 { CODEC_ID_H264, MKTAG('a', 'v', 'c', '1') }, /* AVC-1/H.264 */
102
103 { CODEC_ID_MPEG1VIDEO, MKTAG('m', 'p', 'e', 'g') }, /* MPEG */
2f124d2a 104 { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '1') }, /* HDV 720p30 */
1e5f5e3b
BC
105 { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '2') }, /* MPEG2 produced by Sony HD camera */
106 { CODEC_ID_MPEG2VIDEO, MKTAG('h', 'd', 'v', '3') }, /* HDV produced by FCP */
107 { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'n') }, /* MPEG2 IMX NTSC 525/60 50mb/s produced by FCP */
108 { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '5', 'p') }, /* MPEG2 IMX PAL 625/50 50mb/s produced by FCP */
109 { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'n') }, /* MPEG2 IMX NTSC 525/60 30mb/s produced by FCP */
110 { CODEC_ID_MPEG2VIDEO, MKTAG('m', 'x', '3', 'p') }, /* MPEG2 IMX PAL 625/50 30mb/s produced by FCP */
8d27c5f8 111 { CODEC_ID_MPEG2VIDEO, MKTAG('x', 'd', 'v', '2') }, /* XDCAM HD 1080i60 */
1e5f5e3b 112 { CODEC_ID_MPEG2VIDEO, MKTAG('A', 'V', 'm', 'p') }, /* AVID IMX PAL */
1e5f5e3b
BC
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
c06136e0 123 { CODEC_ID_DNXHD, MKTAG('A', 'V', 'd', 'n') }, /* AVID DNxHD */
2d99eed1 124 { CODEC_ID_SGI, MKTAG('s', 'g', 'i', ' ') }, /* SGI */
c06136e0 125
1e5f5e3b
BC
126 { CODEC_ID_NONE, 0 },
127};
128
129const AVCodecTag codec_movaudio_tags[] = {
130 { CODEC_ID_PCM_S32BE, MKTAG('i', 'n', '3', '2') },
131 { CODEC_ID_PCM_S32LE, MKTAG('i', 'n', '3', '2') },
132 { CODEC_ID_PCM_S24BE, MKTAG('i', 'n', '2', '4') },
133 { CODEC_ID_PCM_S24LE, MKTAG('i', 'n', '2', '4') },
134 { CODEC_ID_PCM_S16BE, MKTAG('t', 'w', 'o', 's') }, /* 16 bits */
1e5f5e3b
BC
135 { CODEC_ID_PCM_S16LE, MKTAG('s', 'o', 'w', 't') }, /* */
136 { CODEC_ID_PCM_S16LE, MKTAG('l', 'p', 'c', 'm') },
36264d35 137 { CODEC_ID_PCM_S8, MKTAG('s', 'o', 'w', 't') },
1e5f5e3b 138 { CODEC_ID_PCM_U8, MKTAG('r', 'a', 'w', ' ') }, /* 8 bits unsigned */
bffcf2eb 139 { CODEC_ID_PCM_U8, MKTAG('N', 'O', 'N', 'E') }, /* uncompressed */
1e5f5e3b
BC
140 { CODEC_ID_PCM_MULAW, MKTAG('u', 'l', 'a', 'w') }, /* */
141 { CODEC_ID_PCM_ALAW, MKTAG('a', 'l', 'a', 'w') }, /* */
142
143 { CODEC_ID_ADPCM_IMA_QT, MKTAG('i', 'm', 'a', '4') }, /* IMA-4 ADPCM */
144 { CODEC_ID_ADPCM_MS, MKTAG('m', 's', 0x00, 0x02) }, /* MS ADPCM */
145
146 { CODEC_ID_MACE3, MKTAG('M', 'A', 'C', '3') }, /* Macintosh Audio Compression and Expansion 3:1 */
147 { CODEC_ID_MACE6, MKTAG('M', 'A', 'C', '6') }, /* Macintosh Audio Compression and Expansion 6:1 */
148
149 { CODEC_ID_MP3, MKTAG('.', 'm', 'p', '3') }, /* MPEG layer 3 */ /* sample files at http://www.3ivx.com/showcase.html use this tag */
0174f514
BC
150 { CODEC_ID_MP3, 0x6D730055 }, /* MPEG layer 3 */
151 { CODEC_ID_MP3, MKTAG('m', 's', 0x00, 0x55) }, /* MPEG layer 3 *//* XXX: check endianness */
1e5f5e3b
BC
152
153/* { CODEC_ID_OGG_VORBIS, MKTAG('O', 'g', 'g', 'S') }, *//* sample files at http://heroinewarrior.com/xmovie.php3 use this tag */
154
155 { CODEC_ID_AAC, MKTAG('m', 'p', '4', 'a') }, /* MPEG-4 AAC */
156
157 { CODEC_ID_AMR_NB, MKTAG('s', 'a', 'm', 'r') }, /* AMR-NB 3gp */
158 { CODEC_ID_AMR_WB, MKTAG('s', 'a', 'w', 'b') }, /* AMR-WB 3gp */
159
160 { CODEC_ID_AC3, MKTAG('m', 's', 0x20, 0x00) }, /* Dolby AC-3 */
161
162 { CODEC_ID_ALAC, MKTAG('a', 'l', 'a', 'c') }, /* Apple Lossless */
163 { CODEC_ID_QDM2, MKTAG('Q', 'D', 'M', '2') }, /* QDM2 */
164
165 { CODEC_ID_DVAUDIO, MKTAG('v', 'd', 'v', 'a') },
166 { CODEC_ID_DVAUDIO, MKTAG('d', 'v', 'c', 'a') },
167
168 { CODEC_ID_NONE, 0 },
169};
170
1e3c9307 171const AVCodecTag ff_codec_movsubtitle_tags[] = {
cc8c2c6a 172 { CODEC_ID_MOV_TEXT, MKTAG('t', 'e', 'x', 't') },
1e3c9307
MN
173 { CODEC_ID_NONE, 0 },
174};
175
e40ee6a2
BC
176/* map numeric codes from mdhd atom to ISO 639 */
177/* cf. QTFileFormat.pdf p253, qtff.pdf p205 */
178/* http://developer.apple.com/documentation/mac/Text/Text-368.html */
179/* deprecated by putting the code as 3*5bit ascii */
180static const char *mov_mdhd_language_map[] = {
181 /* 0-9 */
182 "eng", "fra", "ger", "ita", "dut", "sve", "spa", "dan", "por", "nor",
183 "heb", "jpn", "ara", "fin", "gre", "ice", "mlt", "tur", "hr "/*scr*/, "chi"/*ace?*/,
184 "urd", "hin", "tha", "kor", "lit", "pol", "hun", "est", "lav", NULL,
185 "fo ", NULL, "rus", "chi", NULL, "iri", "alb", "ron", "ces", "slk",
186 "slv", "yid", "sr ", "mac", "bul", "ukr", "bel", "uzb", "kaz", "aze",
187 /*?*/
188 "aze", "arm", "geo", "mol", "kir", "tgk", "tuk", "mon", NULL, "pus",
189 "kur", "kas", "snd", "tib", "nep", "san", "mar", "ben", "asm", "guj",
190 "pa ", "ori", "mal", "kan", "tam", "tel", NULL, "bur", "khm", "lao",
191 /* roman? arabic? */
192 "vie", "ind", "tgl", "may", "may", "amh", "tir", "orm", "som", "swa",
193 /*==rundi?*/
194 NULL, "run", NULL, "mlg", "epo", NULL, NULL, NULL, NULL, NULL,
195 /* 100 */
196 NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
197 NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL,
198 NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, "wel", "baq",
199 "cat", "lat", "que", "grn", "aym", "tat", "uig", "dzo", "jav"
200};
201
202int ff_mov_iso639_to_lang(const char *lang, int mp4)
203{
204 int i, code = 0;
205
206 /* old way, only for QT? */
207 for (i = 0; !mp4 && (i < (sizeof(mov_mdhd_language_map)/sizeof(char *))); i++) {
208 if (mov_mdhd_language_map[i] && !strcmp(lang, mov_mdhd_language_map[i]))
209 return i;
210 }
211 /* XXX:can we do that in mov too? */
212 if (!mp4)
213 return 0;
214 /* handle undefined as such */
215 if (lang[0] == '\0')
216 lang = "und";
217 /* 5bit ascii */
218 for (i = 0; i < 3; i++) {
219 unsigned char c = (unsigned char)lang[i];
220 if (c < 0x60)
221 return 0;
222 if (c > 0x60 + 0x1f)
223 return 0;
224 code <<= 5;
225 code |= (c - 0x60);
226 }
227 return code;
228}
229
230int ff_mov_lang_to_iso639(int code, char *to)
231{
232 int i;
233 /* is it the mangled iso code? */
234 /* see http://www.geocities.com/xhelmboyx/quicktime/formats/mp4-layout.txt */
235 if (code > 138) {
236 for (i = 2; i >= 0; i--) {
237 to[i] = 0x60 + (code & 0x1f);
238 code >>= 5;
239 }
240 return 1;
241 }
242 /* old fashion apple lang code */
243 if (code >= (sizeof(mov_mdhd_language_map)/sizeof(char *)))
244 return 0;
245 if (!mov_mdhd_language_map[code])
246 return 0;
247 strncpy(to, mov_mdhd_language_map[code], 4);
248 return 1;
249}