flacdec: give a more accurate error message when validating channel
[FFMpeg-mirror/lagarith.git] / libavformat / mp3.c
blobb032f0c09e666ed48300adcf4a6397ceb7f51a8d
1 /*
2 * MP3 muxer and demuxer
3 * Copyright (c) 2003 Fabrice Bellard
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include <strings.h>
23 #include "libavutil/avstring.h"
24 #include "libavcodec/mpegaudio.h"
25 #include "libavcodec/mpegaudiodecheader.h"
26 #include "avformat.h"
27 #include "id3v2.h"
29 #define ID3v1_TAG_SIZE 128
31 #define ID3v1_GENRE_MAX 125
33 static const char * const id3v1_genre_str[ID3v1_GENRE_MAX + 1] = {
34 [0] = "Blues",
35 [1] = "Classic Rock",
36 [2] = "Country",
37 [3] = "Dance",
38 [4] = "Disco",
39 [5] = "Funk",
40 [6] = "Grunge",
41 [7] = "Hip-Hop",
42 [8] = "Jazz",
43 [9] = "Metal",
44 [10] = "New Age",
45 [11] = "Oldies",
46 [12] = "Other",
47 [13] = "Pop",
48 [14] = "R&B",
49 [15] = "Rap",
50 [16] = "Reggae",
51 [17] = "Rock",
52 [18] = "Techno",
53 [19] = "Industrial",
54 [20] = "Alternative",
55 [21] = "Ska",
56 [22] = "Death Metal",
57 [23] = "Pranks",
58 [24] = "Soundtrack",
59 [25] = "Euro-Techno",
60 [26] = "Ambient",
61 [27] = "Trip-Hop",
62 [28] = "Vocal",
63 [29] = "Jazz+Funk",
64 [30] = "Fusion",
65 [31] = "Trance",
66 [32] = "Classical",
67 [33] = "Instrumental",
68 [34] = "Acid",
69 [35] = "House",
70 [36] = "Game",
71 [37] = "Sound Clip",
72 [38] = "Gospel",
73 [39] = "Noise",
74 [40] = "AlternRock",
75 [41] = "Bass",
76 [42] = "Soul",
77 [43] = "Punk",
78 [44] = "Space",
79 [45] = "Meditative",
80 [46] = "Instrumental Pop",
81 [47] = "Instrumental Rock",
82 [48] = "Ethnic",
83 [49] = "Gothic",
84 [50] = "Darkwave",
85 [51] = "Techno-Industrial",
86 [52] = "Electronic",
87 [53] = "Pop-Folk",
88 [54] = "Eurodance",
89 [55] = "Dream",
90 [56] = "Southern Rock",
91 [57] = "Comedy",
92 [58] = "Cult",
93 [59] = "Gangsta",
94 [60] = "Top 40",
95 [61] = "Christian Rap",
96 [62] = "Pop/Funk",
97 [63] = "Jungle",
98 [64] = "Native American",
99 [65] = "Cabaret",
100 [66] = "New Wave",
101 [67] = "Psychadelic",
102 [68] = "Rave",
103 [69] = "Showtunes",
104 [70] = "Trailer",
105 [71] = "Lo-Fi",
106 [72] = "Tribal",
107 [73] = "Acid Punk",
108 [74] = "Acid Jazz",
109 [75] = "Polka",
110 [76] = "Retro",
111 [77] = "Musical",
112 [78] = "Rock & Roll",
113 [79] = "Hard Rock",
114 [80] = "Folk",
115 [81] = "Folk-Rock",
116 [82] = "National Folk",
117 [83] = "Swing",
118 [84] = "Fast Fusion",
119 [85] = "Bebob",
120 [86] = "Latin",
121 [87] = "Revival",
122 [88] = "Celtic",
123 [89] = "Bluegrass",
124 [90] = "Avantgarde",
125 [91] = "Gothic Rock",
126 [92] = "Progressive Rock",
127 [93] = "Psychedelic Rock",
128 [94] = "Symphonic Rock",
129 [95] = "Slow Rock",
130 [96] = "Big Band",
131 [97] = "Chorus",
132 [98] = "Easy Listening",
133 [99] = "Acoustic",
134 [100] = "Humour",
135 [101] = "Speech",
136 [102] = "Chanson",
137 [103] = "Opera",
138 [104] = "Chamber Music",
139 [105] = "Sonata",
140 [106] = "Symphony",
141 [107] = "Booty Bass",
142 [108] = "Primus",
143 [109] = "Porn Groove",
144 [110] = "Satire",
145 [111] = "Slow Jam",
146 [112] = "Club",
147 [113] = "Tango",
148 [114] = "Samba",
149 [115] = "Folklore",
150 [116] = "Ballad",
151 [117] = "Power Ballad",
152 [118] = "Rhythmic Soul",
153 [119] = "Freestyle",
154 [120] = "Duet",
155 [121] = "Punk Rock",
156 [122] = "Drum Solo",
157 [123] = "A capella",
158 [124] = "Euro-House",
159 [125] = "Dance Hall",
162 static unsigned int id3v2_get_size(ByteIOContext *s, int len)
164 int v=0;
165 while(len--)
166 v= (v<<7) + (get_byte(s)&0x7F);
167 return v;
170 static void id3v2_read_ttag(AVFormatContext *s, int taglen, const char *key)
172 char *q, dst[512];
173 int len, dstlen = sizeof(dst) - 1;
174 unsigned genre;
176 dst[0]= 0;
177 if(taglen < 1)
178 return;
180 taglen--; /* account for encoding type byte */
182 switch(get_byte(s->pb)) { /* encoding type */
184 case 0: /* ISO-8859-1 (0 - 255 maps directly into unicode) */
185 q = dst;
186 while(taglen--) {
187 uint8_t tmp;
188 PUT_UTF8(get_byte(s->pb), tmp, if (q - dst < dstlen - 1) *q++ = tmp;)
190 *q = '\0';
191 break;
193 case 3: /* UTF-8 */
194 len = FFMIN(taglen, dstlen-1);
195 get_buffer(s->pb, dst, len);
196 dst[len] = 0;
197 break;
200 if (!strcmp(key, "genre")
201 && (sscanf(dst, "(%d)", &genre) == 1 || sscanf(dst, "%d", &genre) == 1)
202 && genre <= ID3v1_GENRE_MAX)
203 av_strlcpy(dst, id3v1_genre_str[genre], sizeof(dst));
205 if (*dst)
206 av_metadata_set(&s->metadata, key, dst);
210 * ID3v2 parser
212 * Handles ID3v2.2, 2.3 and 2.4.
216 static void id3v2_parse(AVFormatContext *s, int len, uint8_t version, uint8_t flags)
218 int isv34, tlen;
219 uint32_t tag;
220 int64_t next;
221 int taghdrlen;
222 const char *reason;
224 switch(version) {
225 case 2:
226 if(flags & 0x40) {
227 reason = "compression";
228 goto error;
230 isv34 = 0;
231 taghdrlen = 6;
232 break;
234 case 3:
235 case 4:
236 isv34 = 1;
237 taghdrlen = 10;
238 break;
240 default:
241 reason = "version";
242 goto error;
245 if(flags & 0x80) {
246 reason = "unsynchronization";
247 goto error;
250 if(isv34 && flags & 0x40) /* Extended header present, just skip over it */
251 url_fskip(s->pb, id3v2_get_size(s->pb, 4));
253 while(len >= taghdrlen) {
254 if(isv34) {
255 tag = get_be32(s->pb);
256 tlen = id3v2_get_size(s->pb, 4);
257 get_be16(s->pb); /* flags */
258 } else {
259 tag = get_be24(s->pb);
260 tlen = id3v2_get_size(s->pb, 3);
262 len -= taghdrlen + tlen;
264 if(len < 0)
265 break;
267 next = url_ftell(s->pb) + tlen;
269 switch(tag) {
270 case MKBETAG('T', 'I', 'T', '2'):
271 case MKBETAG(0, 'T', 'T', '2'):
272 id3v2_read_ttag(s, tlen, "title");
273 break;
274 case MKBETAG('T', 'P', 'E', '1'):
275 case MKBETAG(0, 'T', 'P', '1'):
276 id3v2_read_ttag(s, tlen, "author");
277 break;
278 case MKBETAG('T', 'A', 'L', 'B'):
279 case MKBETAG(0, 'T', 'A', 'L'):
280 id3v2_read_ttag(s, tlen, "album");
281 break;
282 case MKBETAG('T', 'C', 'O', 'N'):
283 case MKBETAG(0, 'T', 'C', 'O'):
284 id3v2_read_ttag(s, tlen, "genre");
285 break;
286 case MKBETAG('T', 'C', 'O', 'P'):
287 case MKBETAG(0, 'T', 'C', 'R'):
288 id3v2_read_ttag(s, tlen, "copyright");
289 break;
290 case MKBETAG('T', 'R', 'C', 'K'):
291 case MKBETAG(0, 'T', 'R', 'K'):
292 id3v2_read_ttag(s, tlen, "track");
293 break;
294 case 0:
295 /* padding, skip to end */
296 url_fskip(s->pb, len);
297 len = 0;
298 continue;
300 /* Skip to end of tag */
301 url_fseek(s->pb, next, SEEK_SET);
304 if(version == 4 && flags & 0x10) /* Footer preset, always 10 bytes, skip over it */
305 url_fskip(s->pb, 10);
306 return;
308 error:
309 av_log(s, AV_LOG_INFO, "ID3v2.%d tag skipped, cannot handle %s\n", version, reason);
310 url_fskip(s->pb, len);
313 static void id3v1_get_string(AVFormatContext *s, const char *key,
314 const uint8_t *buf, int buf_size)
316 int i, c;
317 char *q, str[512];
319 q = str;
320 for(i = 0; i < buf_size; i++) {
321 c = buf[i];
322 if (c == '\0')
323 break;
324 if ((q - str) >= sizeof(str) - 1)
325 break;
326 *q++ = c;
328 *q = '\0';
330 if (*str)
331 av_metadata_set(&s->metadata, key, str);
334 /* 'buf' must be ID3v1_TAG_SIZE byte long */
335 static int id3v1_parse_tag(AVFormatContext *s, const uint8_t *buf)
337 char str[5];
338 int genre;
340 if (!(buf[0] == 'T' &&
341 buf[1] == 'A' &&
342 buf[2] == 'G'))
343 return -1;
344 id3v1_get_string(s, "title", buf + 3, 30);
345 id3v1_get_string(s, "author", buf + 33, 30);
346 id3v1_get_string(s, "album", buf + 63, 30);
347 id3v1_get_string(s, "year", buf + 93, 4);
348 id3v1_get_string(s, "comment", buf + 97, 30);
349 if (buf[125] == 0 && buf[126] != 0) {
350 snprintf(str, sizeof(str), "%d", buf[126]);
351 av_metadata_set(&s->metadata, "track", str);
353 genre = buf[127];
354 if (genre <= ID3v1_GENRE_MAX)
355 av_metadata_set(&s->metadata, "genre", id3v1_genre_str[genre]);
356 return 0;
359 /* mp3 read */
361 static int mp3_read_probe(AVProbeData *p)
363 int max_frames, first_frames = 0;
364 int fsize, frames, sample_rate;
365 uint32_t header;
366 uint8_t *buf, *buf0, *buf2, *end;
367 AVCodecContext avctx;
369 buf0 = p->buf;
370 if(ff_id3v2_match(buf0)) {
371 buf0 += ff_id3v2_tag_len(buf0);
374 max_frames = 0;
375 buf = buf0;
376 end = p->buf + p->buf_size - sizeof(uint32_t);
378 for(; buf < end; buf= buf2+1) {
379 buf2 = buf;
381 for(frames = 0; buf2 < end; frames++) {
382 header = AV_RB32(buf2);
383 fsize = ff_mpa_decode_header(&avctx, header, &sample_rate, &sample_rate, &sample_rate, &sample_rate);
384 if(fsize < 0)
385 break;
386 buf2 += fsize;
388 max_frames = FFMAX(max_frames, frames);
389 if(buf == buf0)
390 first_frames= frames;
392 if (first_frames>=3) return AVPROBE_SCORE_MAX/2+1;
393 else if(max_frames>500)return AVPROBE_SCORE_MAX/2;
394 else if(max_frames>=3) return AVPROBE_SCORE_MAX/4;
395 else if(buf0!=p->buf) return AVPROBE_SCORE_MAX/4-1;
396 else if(max_frames>=1) return 1;
397 else return 0;
401 * Try to find Xing/Info/VBRI tags and compute duration from info therein
403 static int mp3_parse_vbr_tags(AVFormatContext *s, AVStream *st, int64_t base)
405 uint32_t v, spf;
406 int frames = -1; /* Total number of frames in file */
407 const int64_t xing_offtbl[2][2] = {{32, 17}, {17,9}};
408 MPADecodeHeader c;
409 int vbrtag_size = 0;
411 v = get_be32(s->pb);
412 if(ff_mpa_check_header(v) < 0)
413 return -1;
415 if (ff_mpegaudio_decode_header(&c, v) == 0)
416 vbrtag_size = c.frame_size;
417 if(c.layer != 3)
418 return -1;
420 /* Check for Xing / Info tag */
421 url_fseek(s->pb, xing_offtbl[c.lsf == 1][c.nb_channels == 1], SEEK_CUR);
422 v = get_be32(s->pb);
423 if(v == MKBETAG('X', 'i', 'n', 'g') || v == MKBETAG('I', 'n', 'f', 'o')) {
424 v = get_be32(s->pb);
425 if(v & 0x1)
426 frames = get_be32(s->pb);
429 /* Check for VBRI tag (always 32 bytes after end of mpegaudio header) */
430 url_fseek(s->pb, base + 4 + 32, SEEK_SET);
431 v = get_be32(s->pb);
432 if(v == MKBETAG('V', 'B', 'R', 'I')) {
433 /* Check tag version */
434 if(get_be16(s->pb) == 1) {
435 /* skip delay, quality and total bytes */
436 url_fseek(s->pb, 8, SEEK_CUR);
437 frames = get_be32(s->pb);
441 if(frames < 0)
442 return -1;
444 /* Skip the vbr tag frame */
445 url_fseek(s->pb, base + vbrtag_size, SEEK_SET);
447 spf = c.lsf ? 576 : 1152; /* Samples per frame, layer 3 */
448 st->duration = av_rescale_q(frames, (AVRational){spf, c.sample_rate},
449 st->time_base);
450 return 0;
453 static int mp3_read_header(AVFormatContext *s,
454 AVFormatParameters *ap)
456 AVStream *st;
457 uint8_t buf[ID3v1_TAG_SIZE];
458 int len, ret, filesize;
459 int64_t off;
461 st = av_new_stream(s, 0);
462 if (!st)
463 return AVERROR(ENOMEM);
465 st->codec->codec_type = CODEC_TYPE_AUDIO;
466 st->codec->codec_id = CODEC_ID_MP3;
467 st->need_parsing = AVSTREAM_PARSE_FULL;
468 st->start_time = 0;
470 /* try to get the TAG */
471 if (!url_is_streamed(s->pb)) {
472 /* XXX: change that */
473 filesize = url_fsize(s->pb);
474 if (filesize > 128) {
475 url_fseek(s->pb, filesize - 128, SEEK_SET);
476 ret = get_buffer(s->pb, buf, ID3v1_TAG_SIZE);
477 if (ret == ID3v1_TAG_SIZE) {
478 id3v1_parse_tag(s, buf);
480 url_fseek(s->pb, 0, SEEK_SET);
484 /* if ID3v2 header found, skip it */
485 ret = get_buffer(s->pb, buf, ID3v2_HEADER_SIZE);
486 if (ret != ID3v2_HEADER_SIZE)
487 return -1;
488 if (ff_id3v2_match(buf)) {
489 /* parse ID3v2 header */
490 len = ((buf[6] & 0x7f) << 21) |
491 ((buf[7] & 0x7f) << 14) |
492 ((buf[8] & 0x7f) << 7) |
493 (buf[9] & 0x7f);
494 id3v2_parse(s, len, buf[3], buf[5]);
495 } else {
496 url_fseek(s->pb, 0, SEEK_SET);
499 off = url_ftell(s->pb);
500 if (mp3_parse_vbr_tags(s, st, off) < 0)
501 url_fseek(s->pb, off, SEEK_SET);
503 /* the parameters will be extracted from the compressed bitstream */
504 return 0;
507 #define MP3_PACKET_SIZE 1024
509 static int mp3_read_packet(AVFormatContext *s, AVPacket *pkt)
511 int ret, size;
512 // AVStream *st = s->streams[0];
514 size= MP3_PACKET_SIZE;
516 ret= av_get_packet(s->pb, pkt, size);
518 pkt->stream_index = 0;
519 if (ret <= 0) {
520 return AVERROR(EIO);
522 /* note: we need to modify the packet size here to handle the last
523 packet */
524 pkt->size = ret;
525 return ret;
528 #if CONFIG_MP2_MUXER || CONFIG_MP3_MUXER
529 static int id3v1_set_string(AVFormatContext *s, const char *key,
530 uint8_t *buf, int buf_size)
532 AVMetadataTag *tag;
533 if ((tag = av_metadata_get(s->metadata, key, NULL, 0)))
534 strncpy(buf, tag->value, buf_size);
535 return !!tag;
538 static int id3v1_create_tag(AVFormatContext *s, uint8_t *buf)
540 AVMetadataTag *tag;
541 int i, count = 0;
543 memset(buf, 0, ID3v1_TAG_SIZE); /* fail safe */
544 buf[0] = 'T';
545 buf[1] = 'A';
546 buf[2] = 'G';
547 count += id3v1_set_string(s, "title", buf + 3, 30);
548 count += id3v1_set_string(s, "author", buf + 33, 30);
549 count += id3v1_set_string(s, "album", buf + 63, 30);
550 count += id3v1_set_string(s, "year", buf + 93, 4);
551 count += id3v1_set_string(s, "comment", buf + 97, 30);
552 if ((tag = av_metadata_get(s->metadata, "track", NULL, 0))) {
553 buf[125] = 0;
554 buf[126] = atoi(tag->value);
555 count++;
557 if ((tag = av_metadata_get(s->metadata, "genre", NULL, 0))) {
558 for(i = 0; i <= ID3v1_GENRE_MAX; i++) {
559 if (!strcasecmp(tag->value, id3v1_genre_str[i])) {
560 buf[127] = i;
561 count++;
562 break;
566 return count;
569 /* simple formats */
571 static void id3v2_put_size(AVFormatContext *s, int size)
573 put_byte(s->pb, size >> 21 & 0x7f);
574 put_byte(s->pb, size >> 14 & 0x7f);
575 put_byte(s->pb, size >> 7 & 0x7f);
576 put_byte(s->pb, size & 0x7f);
579 static void id3v2_put_ttag(AVFormatContext *s, const char *string, uint32_t tag)
581 int len = strlen(string);
582 put_be32(s->pb, tag);
583 id3v2_put_size(s, len + 1);
584 put_be16(s->pb, 0);
585 put_byte(s->pb, 3); /* UTF-8 */
586 put_buffer(s->pb, string, len);
591 * Write an ID3v2.4 header at beginning of stream
594 static int mp3_write_header(struct AVFormatContext *s)
596 AVMetadataTag *title, *author, *album, *genre, *copyright, *track, *year;
597 int totlen = 0;
599 title = av_metadata_get(s->metadata, "title", NULL, 0);
600 author = av_metadata_get(s->metadata, "author", NULL, 0);
601 album = av_metadata_get(s->metadata, "album", NULL, 0);
602 genre = av_metadata_get(s->metadata, "genre", NULL, 0);
603 copyright = av_metadata_get(s->metadata, "copyright", NULL, 0);
604 track = av_metadata_get(s->metadata, "track", NULL, 0);
605 year = av_metadata_get(s->metadata, "year", NULL, 0);
607 if(title) totlen += 11 + strlen(title->value);
608 if(author) totlen += 11 + strlen(author->value);
609 if(album) totlen += 11 + strlen(album->value);
610 if(genre) totlen += 11 + strlen(genre->value);
611 if(copyright) totlen += 11 + strlen(copyright->value);
612 if(track) totlen += 11 + strlen(track->value);
613 if(year) totlen += 11 + strlen(year->value);
614 if(!(s->streams[0]->codec->flags & CODEC_FLAG_BITEXACT))
615 totlen += strlen(LIBAVFORMAT_IDENT) + 11;
617 if(totlen == 0)
618 return 0;
620 put_be32(s->pb, MKBETAG('I', 'D', '3', 0x04)); /* ID3v2.4 */
621 put_byte(s->pb, 0);
622 put_byte(s->pb, 0); /* flags */
624 id3v2_put_size(s, totlen);
626 if(title) id3v2_put_ttag(s, title->value, MKBETAG('T', 'I', 'T', '2'));
627 if(author) id3v2_put_ttag(s, author->value, MKBETAG('T', 'P', 'E', '1'));
628 if(album) id3v2_put_ttag(s, album->value, MKBETAG('T', 'A', 'L', 'B'));
629 if(genre) id3v2_put_ttag(s, genre->value, MKBETAG('T', 'C', 'O', 'N'));
630 if(copyright) id3v2_put_ttag(s, copyright->value, MKBETAG('T', 'C', 'O', 'P'));
631 if(track) id3v2_put_ttag(s, track->value, MKBETAG('T', 'R', 'C', 'K'));
632 if(year) id3v2_put_ttag(s, year->value, MKBETAG('T', 'Y', 'E', 'R'));
633 if(!(s->streams[0]->codec->flags & CODEC_FLAG_BITEXACT))
634 id3v2_put_ttag(s, LIBAVFORMAT_IDENT, MKBETAG('T', 'E', 'N', 'C'));
635 return 0;
638 static int mp3_write_packet(struct AVFormatContext *s, AVPacket *pkt)
640 put_buffer(s->pb, pkt->data, pkt->size);
641 put_flush_packet(s->pb);
642 return 0;
645 static int mp3_write_trailer(struct AVFormatContext *s)
647 uint8_t buf[ID3v1_TAG_SIZE];
649 /* write the id3v1 tag */
650 if (id3v1_create_tag(s, buf) > 0) {
651 put_buffer(s->pb, buf, ID3v1_TAG_SIZE);
652 put_flush_packet(s->pb);
654 return 0;
656 #endif /* CONFIG_MP2_MUXER || CONFIG_MP3_MUXER */
658 #if CONFIG_MP3_DEMUXER
659 AVInputFormat mp3_demuxer = {
660 "mp3",
661 NULL_IF_CONFIG_SMALL("MPEG audio layer 2/3"),
663 mp3_read_probe,
664 mp3_read_header,
665 mp3_read_packet,
666 .flags= AVFMT_GENERIC_INDEX,
667 .extensions = "mp2,mp3,m2a", /* XXX: use probe */
669 #endif
670 #if CONFIG_MP2_MUXER
671 AVOutputFormat mp2_muxer = {
672 "mp2",
673 NULL_IF_CONFIG_SMALL("MPEG audio layer 2"),
674 "audio/x-mpeg",
675 "mp2,m2a",
677 CODEC_ID_MP2,
678 CODEC_ID_NONE,
679 NULL,
680 mp3_write_packet,
681 mp3_write_trailer,
683 #endif
684 #if CONFIG_MP3_MUXER
685 AVOutputFormat mp3_muxer = {
686 "mp3",
687 NULL_IF_CONFIG_SMALL("MPEG audio layer 3"),
688 "audio/x-mpeg",
689 "mp3",
691 CODEC_ID_MP3,
692 CODEC_ID_NONE,
693 mp3_write_header,
694 mp3_write_packet,
695 mp3_write_trailer,
697 #endif