EA IMA SEAD decoder
[ffmpeg.git] / libavformat / electronicarts.c
1 /* Electronic Arts Multimedia File Demuxer
2  * Copyright (c) 2004  The ffmpeg Project
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20
21 /**
22  * @file electronicarts.c
23  * Electronic Arts Multimedia file demuxer (WVE/UV2/etc.)
24  * by Robin Kay (komadori at gekkou.co.uk)
25  */
26
27 #include "avformat.h"
28
29 #define SCHl_TAG MKTAG('S', 'C', 'H', 'l')
30 #define SEAD_TAG MKTAG('S', 'E', 'A', 'D')    /* Sxxx header */
31 #define SNDC_TAG MKTAG('S', 'N', 'D', 'C')    /* Sxxx data */
32 #define SEND_TAG MKTAG('S', 'E', 'N', 'D')    /* Sxxx end */
33 #define ISNh_TAG MKTAG('1', 'S', 'N', 'h')    /* 1SNx header */
34 #define EACS_TAG MKTAG('E', 'A', 'C', 'S')
35 #define ISNd_TAG MKTAG('1', 'S', 'N', 'd')    /* 1SNx data */
36 #define ISNe_TAG MKTAG('1', 'S', 'N', 'e')    /* 1SNx end */
37 #define PT00_TAG MKTAG('P', 'T', 0x0, 0x0)
38 #define GSTR_TAG MKTAG('G', 'S', 'T', 'R')
39 #define SCDl_TAG MKTAG('S', 'C', 'D', 'l')
40 #define SCEl_TAG MKTAG('S', 'C', 'E', 'l')
41 #define MVhd_TAG MKTAG('M', 'V', 'h', 'd')
42 #define MV0K_TAG MKTAG('M', 'V', '0', 'K')
43 #define MV0F_TAG MKTAG('M', 'V', '0', 'F')
44
45 typedef struct EaDemuxContext {
46     int big_endian;
47
48     int video_codec;
49     AVRational time_base;
50     int video_stream_index;
51
52     int audio_codec;
53     int audio_stream_index;
54     int audio_frame_counter;
55
56     int64_t audio_pts;
57
58     int bytes;
59     int sample_rate;
60     int num_channels;
61     int num_samples;
62 } EaDemuxContext;
63
64 static uint32_t read_arbitary(ByteIOContext *pb) {
65     uint8_t size, byte;
66     int i;
67     uint32_t word;
68
69     size = get_byte(pb);
70
71     word = 0;
72     for (i = 0; i < size; i++) {
73         byte = get_byte(pb);
74         word <<= 8;
75         word |= byte;
76     }
77
78     return word;
79 }
80
81 /*
82  * Process PT/GSTR sound header
83  * return 1 if success, 0 if invalid format, otherwise AVERROR_xxx
84  */
85 static int process_audio_header_elements(AVFormatContext *s)
86 {
87     int inHeader = 1;
88     EaDemuxContext *ea = s->priv_data;
89     ByteIOContext *pb = &s->pb;
90     int compression_type = -1, revision = -1;
91
92     ea->bytes = 2;
93     ea->sample_rate = -1;
94     ea->num_channels = 1;
95
96     while (inHeader) {
97         int inSubheader;
98         uint8_t byte;
99         byte = get_byte(pb);
100
101         switch (byte) {
102         case 0xFD:
103             av_log (s, AV_LOG_INFO, "entered audio subheader\n");
104             inSubheader = 1;
105             while (inSubheader) {
106                 uint8_t subbyte;
107                 subbyte = get_byte(pb);
108
109                 switch (subbyte) {
110                 case 0x80:
111                     revision = read_arbitary(pb);
112                     av_log (s, AV_LOG_INFO, "revision (element 0x80) set to 0x%08x\n", revision);
113                     break;
114                 case 0x82:
115                     ea->num_channels = read_arbitary(pb);
116                     av_log (s, AV_LOG_INFO, "num_channels (element 0x82) set to 0x%08x\n", ea->num_channels);
117                     break;
118                 case 0x83:
119                     compression_type = read_arbitary(pb);
120                     av_log (s, AV_LOG_INFO, "compression_type (element 0x83) set to 0x%08x\n", compression_type);
121                     break;
122                 case 0x84:
123                     ea->sample_rate = read_arbitary(pb);
124                     av_log (s, AV_LOG_INFO, "sample_rate (element 0x84) set to %i\n", ea->sample_rate);
125                     break;
126                 case 0x85:
127                     ea->num_samples = read_arbitary(pb);
128                     av_log (s, AV_LOG_INFO, "num_samples (element 0x85) set to 0x%08x\n", ea->num_samples);
129                     break;
130                 case 0x8A:
131                     av_log (s, AV_LOG_INFO, "element 0x%02x set to 0x%08x\n", subbyte, read_arbitary(pb));
132                     av_log (s, AV_LOG_INFO, "exited audio subheader\n");
133                     inSubheader = 0;
134                     break;
135                 case 0xFF:
136                     av_log (s, AV_LOG_INFO, "end of header block reached (within audio subheader)\n");
137                     inSubheader = 0;
138                     inHeader = 0;
139                     break;
140                 default:
141                     av_log (s, AV_LOG_INFO, "element 0x%02x set to 0x%08x\n", subbyte, read_arbitary(pb));
142                     break;
143                 }
144             }
145             break;
146         case 0xFF:
147             av_log (s, AV_LOG_INFO, "end of header block reached\n");
148             inHeader = 0;
149             break;
150         default:
151             av_log (s, AV_LOG_INFO, "header element 0x%02x set to 0x%08x\n", byte, read_arbitary(pb));
152             break;
153         }
154     }
155
156     switch (compression_type) {
157     case  0: ea->audio_codec = CODEC_ID_PCM_S16LE; break;
158     case  7: ea->audio_codec = CODEC_ID_ADPCM_EA; break;
159     case -1:
160         switch (revision) {
161         case  1: ea->audio_codec = CODEC_ID_ADPCM_EA_R1; break;
162         case  2: ea->audio_codec = CODEC_ID_ADPCM_EA_R2; break;
163         case  3: ea->audio_codec = CODEC_ID_ADPCM_EA_R3; break;
164         default:
165             av_log(s, AV_LOG_ERROR, "unsupported stream type; revision=%i\n", revision);
166             return 0;
167         }
168         break;
169     default:
170         av_log(s, AV_LOG_ERROR, "unsupported stream type; compression_type=%i\n", compression_type);
171         return 0;
172     }
173
174     if (ea->sample_rate == -1)
175         ea->sample_rate = revision==3 ? 48000 : 22050;
176
177     return 1;
178 }
179
180 /*
181  * Process EACS sound header
182  * return 1 if success, 0 if invalid format, otherwise AVERROR_xxx
183  */
184 static int process_audio_header_eacs(AVFormatContext *s)
185 {
186     EaDemuxContext *ea = s->priv_data;
187     ByteIOContext *pb = &s->pb;
188     int compression_type;
189
190     ea->sample_rate  = ea->big_endian ? get_be32(pb) : get_le32(pb);
191     ea->bytes        = get_byte(pb);   /* 1=8-bit, 2=16-bit */
192     ea->num_channels = get_byte(pb);
193     compression_type = get_byte(pb);
194     url_fskip(pb, 13);
195
196     switch (compression_type) {
197     case 0:
198         switch (ea->bytes) {
199         case 1: ea->audio_codec = CODEC_ID_PCM_S8;    break;
200         case 2: ea->audio_codec = CODEC_ID_PCM_S16LE; break;
201         }
202         break;
203     case 1: ea->audio_codec = CODEC_ID_PCM_MULAW; ea->bytes = 1; break;
204     default:
205         av_log (s, AV_LOG_ERROR, "unsupported stream type; audio compression_type=%i\n", compression_type);
206     }
207
208     return 1;
209 }
210
211 /*
212  * Process SEAD sound header
213  * return 1 if success, 0 if invalid format, otherwise AVERROR_xxx
214  */
215 static int process_audio_header_sead(AVFormatContext *s)
216 {
217     EaDemuxContext *ea = s->priv_data;
218     ByteIOContext *pb = &s->pb;
219
220     ea->sample_rate  = get_le32(pb);
221     ea->bytes        = get_le32(pb);  /* 1=8-bit, 2=16-bit */
222     ea->num_channels = get_le32(pb);
223     ea->audio_codec  = CODEC_ID_ADPCM_IMA_EA_SEAD;
224
225     return 1;
226 }
227
228 static int process_video_header_vp6(AVFormatContext *s)
229 {
230     EaDemuxContext *ea = s->priv_data;
231     ByteIOContext *pb = &s->pb;
232
233     url_fskip(pb, 16);
234     ea->time_base.den = get_le32(pb);
235     ea->time_base.num = get_le32(pb);
236     ea->video_codec = CODEC_ID_VP6;
237
238     return 1;
239 }
240
241 /*
242  * Process EA file header
243  * Returns 1 if the EA file is valid and successfully opened, 0 otherwise
244  */
245 static int process_ea_header(AVFormatContext *s) {
246     uint32_t blockid, size = 0;
247     EaDemuxContext *ea = s->priv_data;
248     ByteIOContext *pb = &s->pb;
249     int i;
250
251     for (i=0; i<5 && (!ea->audio_codec || !ea->video_codec); i++) {
252         unsigned int startpos = url_ftell(pb);
253         int err = 0;
254
255         blockid = get_le32(pb);
256         size = get_le32(pb);
257         if (i == 0)
258             ea->big_endian = size > 0x000FFFFF;
259         if (ea->big_endian)
260             size = bswap_32(size);
261
262         switch (blockid) {
263             case ISNh_TAG:
264                 if (get_le32(pb) != EACS_TAG) {
265                     av_log (s, AV_LOG_ERROR, "unknown 1SNh headerid\n");
266                     return 0;
267                 }
268                 err = process_audio_header_eacs(s);
269                 break;
270
271             case SCHl_TAG :
272                 blockid = get_le32(pb);
273                 if (blockid == GSTR_TAG) {
274                     url_fskip(pb, 4);
275                 } else if (blockid != PT00_TAG) {
276                     av_log (s, AV_LOG_ERROR, "unknown SCHl headerid\n");
277                     return 0;
278                 }
279                 err = process_audio_header_elements(s);
280                 break;
281
282             case SEAD_TAG:
283                 err = process_audio_header_sead(s);
284                 break;
285
286             case MVhd_TAG :
287                 err = process_video_header_vp6(s);
288                 break;
289         }
290
291         if (err < 0) {
292             av_log(s, AV_LOG_ERROR, "error parsing header: %i\n", err);
293             return err;
294         }
295
296         url_fseek(pb, startpos + size, SEEK_SET);
297     }
298
299     url_fseek(pb, 0, SEEK_SET);
300
301     return 1;
302 }
303
304
305 static int ea_probe(AVProbeData *p)
306 {
307     switch (AV_RL32(&p->buf[0])) {
308     case ISNh_TAG:
309     case SCHl_TAG:
310     case SEAD_TAG:
311     case MVhd_TAG:
312         return AVPROBE_SCORE_MAX;
313     }
314     return 0;
315 }
316
317 static int ea_read_header(AVFormatContext *s,
318                           AVFormatParameters *ap)
319 {
320     EaDemuxContext *ea = s->priv_data;
321     AVStream *st;
322
323     if (!process_ea_header(s))
324         return AVERROR(EIO);
325
326     if (ea->video_codec) {
327         /* initialize the video decoder stream */
328         st = av_new_stream(s, 0);
329         if (!st)
330             return AVERROR(ENOMEM);
331         ea->video_stream_index = st->index;
332         st->codec->codec_type = CODEC_TYPE_VIDEO;
333         st->codec->codec_id = ea->video_codec;
334         st->codec->codec_tag = 0;  /* no fourcc */
335         st->codec->time_base = ea->time_base;
336     }
337
338     if (ea->audio_codec) {
339         /* initialize the audio decoder stream */
340         st = av_new_stream(s, 0);
341         if (!st)
342             return AVERROR(ENOMEM);
343         av_set_pts_info(st, 33, 1, ea->sample_rate);
344         st->codec->codec_type = CODEC_TYPE_AUDIO;
345         st->codec->codec_id = ea->audio_codec;
346         st->codec->codec_tag = 0;  /* no tag */
347         st->codec->channels = ea->num_channels;
348         st->codec->sample_rate = ea->sample_rate;
349         st->codec->bits_per_sample = ea->bytes * 8;
350         st->codec->bit_rate = st->codec->channels * st->codec->sample_rate *
351             st->codec->bits_per_sample / 4;
352         st->codec->block_align = st->codec->channels*st->codec->bits_per_sample;
353         ea->audio_stream_index = st->index;
354         ea->audio_frame_counter = 0;
355     }
356
357     return 1;
358 }
359
360 static int ea_read_packet(AVFormatContext *s,
361                           AVPacket *pkt)
362 {
363     EaDemuxContext *ea = s->priv_data;
364     ByteIOContext *pb = &s->pb;
365     int ret = 0;
366     int packet_read = 0;
367     unsigned int chunk_type, chunk_size;
368     int key = 0;
369
370     while (!packet_read) {
371         chunk_type = get_le32(pb);
372         chunk_size = (ea->big_endian ? get_be32(pb) : get_le32(pb)) - 8;
373
374         switch (chunk_type) {
375         /* audio data */
376         case ISNh_TAG:
377             /* header chunk also contains data; skip over the header portion*/
378             url_fskip(pb, 32);
379             chunk_size -= 32;
380         case ISNd_TAG:
381         case SCDl_TAG:
382         case SNDC_TAG:
383             if (!ea->audio_codec) {
384                 url_fskip(pb, chunk_size);
385                 break;
386             }
387             ret = av_get_packet(pb, pkt, chunk_size);
388             if (ret != chunk_size)
389                 ret = AVERROR(EIO);
390             else {
391                     pkt->stream_index = ea->audio_stream_index;
392                     pkt->pts = 90000;
393                     pkt->pts *= ea->audio_frame_counter;
394                     pkt->pts /= ea->sample_rate;
395
396                     switch (ea->audio_codec) {
397                     case CODEC_ID_ADPCM_EA:
398                     /* 2 samples/byte, 1 or 2 samples per frame depending
399                      * on stereo; chunk also has 12-byte header */
400                     ea->audio_frame_counter += ((chunk_size - 12) * 2) /
401                         ea->num_channels;
402                         break;
403                     default:
404                         ea->audio_frame_counter += chunk_size /
405                             (ea->bytes * ea->num_channels);
406                     }
407             }
408
409             packet_read = 1;
410             break;
411
412         /* ending tag */
413         case 0:
414         case ISNe_TAG:
415         case SCEl_TAG:
416         case SEND_TAG:
417             ret = AVERROR(EIO);
418             packet_read = 1;
419             break;
420
421         case MV0K_TAG:
422             key = PKT_FLAG_KEY;
423         case MV0F_TAG:
424             ret = av_get_packet(pb, pkt, chunk_size);
425             if (ret != chunk_size)
426                 ret = AVERROR_IO;
427             else {
428                 pkt->stream_index = ea->video_stream_index;
429                 pkt->flags |= key;
430             }
431             packet_read = 1;
432             break;
433
434         default:
435             url_fseek(pb, chunk_size, SEEK_CUR);
436             break;
437         }
438     }
439
440     return ret;
441 }
442
443 AVInputFormat ea_demuxer = {
444     "ea",
445     "Electronic Arts Multimedia Format",
446     sizeof(EaDemuxContext),
447     ea_probe,
448     ea_read_header,
449     ea_read_packet,
450 };