1 /* Electronic Arts Multimedia File Demuxer
2 * Copyright (c) 2004 The FFmpeg Project
3 * Copyright (c) 2006-2008 Peter Ross
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
24 * Electronic Arts Multimedia file demuxer (WVE/UV2/etc.)
25 * by Robin Kay (komadori at gekkou.co.uk)
30 #include "libavutil/intreadwrite.h"
34 #define SCHl_TAG MKTAG('S', 'C', 'H', 'l')
35 #define SEAD_TAG MKTAG('S', 'E', 'A', 'D') /* Sxxx header */
36 #define SNDC_TAG MKTAG('S', 'N', 'D', 'C') /* Sxxx data */
37 #define SEND_TAG MKTAG('S', 'E', 'N', 'D') /* Sxxx end */
38 #define SHEN_TAG MKTAG('S', 'H', 'E', 'N') /* SxEN header */
39 #define SDEN_TAG MKTAG('S', 'D', 'E', 'N') /* SxEN data */
40 #define SEEN_TAG MKTAG('S', 'E', 'E', 'N') /* SxEN end */
41 #define ISNh_TAG MKTAG('1', 'S', 'N', 'h') /* 1SNx header */
42 #define EACS_TAG MKTAG('E', 'A', 'C', 'S')
43 #define ISNd_TAG MKTAG('1', 'S', 'N', 'd') /* 1SNx data */
44 #define ISNe_TAG MKTAG('1', 'S', 'N', 'e') /* 1SNx end */
45 #define PT00_TAG MKTAG('P', 'T', 0x0, 0x0)
46 #define GSTR_TAG MKTAG('G', 'S', 'T', 'R')
47 #define SCDl_TAG MKTAG('S', 'C', 'D', 'l')
48 #define SCEl_TAG MKTAG('S', 'C', 'E', 'l')
49 #define kVGT_TAG MKTAG('k', 'V', 'G', 'T') /* TGV I-frame */
50 #define fVGT_TAG MKTAG('f', 'V', 'G', 'T') /* TGV P-frame */
51 #define mTCD_TAG MKTAG('m', 'T', 'C', 'D') /* MDEC */
52 #define MADk_TAG MKTAG('M', 'A', 'D', 'k') /* MAD I-frame */
53 #define MADm_TAG MKTAG('M', 'A', 'D', 'm') /* MAD P-frame */
54 #define MADe_TAG MKTAG('M', 'A', 'D', 'e') /* MAD lqp-frame */
55 #define MPCh_TAG MKTAG('M', 'P', 'C', 'h') /* MPEG-2 */
56 #define TGQs_TAG MKTAG('T', 'G', 'Q', 's') /* TGQ I-frame (appears in .TGQ files) */
57 #define pQGT_TAG MKTAG('p', 'Q', 'G', 'T') /* TGQ I-frame (appears in .UV files) */
58 #define pIQT_TAG MKTAG('p', 'I', 'Q', 'T') /* TQI/UV2 I-frame (.UV2/.WVE) */
59 #define MVhd_TAG MKTAG('M', 'V', 'h', 'd')
60 #define MV0K_TAG MKTAG('M', 'V', '0', 'K')
61 #define MV0F_TAG MKTAG('M', 'V', '0', 'F')
62 #define MVIh_TAG MKTAG('M', 'V', 'I', 'h') /* CMV header */
63 #define MVIf_TAG MKTAG('M', 'V', 'I', 'f') /* CMV I-frame */
65 typedef struct EaDemuxContext
{
68 enum AVCodecID video_codec
;
72 int video_stream_index
;
74 enum AVCodecID audio_codec
;
75 int audio_stream_index
;
83 static uint32_t read_arbitrary(AVIOContext
*pb
)
92 for (i
= 0; i
< size
; i
++) {
101 static int process_audio_header_elements(AVFormatContext
*s
)
103 EaDemuxContext
*ea
= s
->priv_data
;
104 AVIOContext
*pb
= s
->pb
;
106 int compression_type
= -1, revision
= -1, revision2
= -1;
109 ea
->sample_rate
= -1;
110 ea
->num_channels
= 1;
112 while (!avio_feof(pb
) && in_header
) {
119 av_log(s
, AV_LOG_DEBUG
, "entered audio subheader\n");
121 while (!avio_feof(pb
) && in_subheader
) {
123 subbyte
= avio_r8(pb
);
127 revision
= read_arbitrary(pb
);
128 av_log(s
, AV_LOG_DEBUG
,
129 "revision (element 0x80) set to 0x%08x\n", revision
);
132 ea
->num_channels
= read_arbitrary(pb
);
133 av_log(s
, AV_LOG_DEBUG
,
134 "num_channels (element 0x82) set to 0x%08x\n",
138 compression_type
= read_arbitrary(pb
);
139 av_log(s
, AV_LOG_DEBUG
,
140 "compression_type (element 0x83) set to 0x%08x\n",
144 ea
->sample_rate
= read_arbitrary(pb
);
145 av_log(s
, AV_LOG_DEBUG
,
146 "sample_rate (element 0x84) set to %i\n",
150 ea
->num_samples
= read_arbitrary(pb
);
151 av_log(s
, AV_LOG_DEBUG
,
152 "num_samples (element 0x85) set to 0x%08x\n",
156 av_log(s
, AV_LOG_DEBUG
,
157 "element 0x%02x set to 0x%08"PRIx32
"\n",
158 subbyte
, read_arbitrary(pb
));
159 av_log(s
, AV_LOG_DEBUG
, "exited audio subheader\n");
163 revision2
= read_arbitrary(pb
);
164 av_log(s
, AV_LOG_DEBUG
,
165 "revision2 (element 0xA0) set to 0x%08x\n",
169 av_log(s
, AV_LOG_DEBUG
,
170 "end of header block reached (within audio subheader)\n");
175 av_log(s
, AV_LOG_DEBUG
,
176 "element 0x%02x set to 0x%08"PRIx32
"\n",
177 subbyte
, read_arbitrary(pb
));
183 av_log(s
, AV_LOG_DEBUG
, "end of header block reached\n");
187 av_log(s
, AV_LOG_DEBUG
,
188 "header element 0x%02x set to 0x%08"PRIx32
"\n",
189 byte
, read_arbitrary(pb
));
194 switch (compression_type
) {
196 ea
->audio_codec
= AV_CODEC_ID_PCM_S16LE
;
199 ea
->audio_codec
= AV_CODEC_ID_ADPCM_EA
;
204 ea
->audio_codec
= AV_CODEC_ID_ADPCM_EA_R1
;
207 ea
->audio_codec
= AV_CODEC_ID_ADPCM_EA_R2
;
210 ea
->audio_codec
= AV_CODEC_ID_ADPCM_EA_R3
;
215 avpriv_request_sample(s
, "stream type; revision=%i", revision
);
220 ea
->audio_codec
= AV_CODEC_ID_PCM_S16LE_PLANAR
;
225 case 2: ea
->audio_codec
= AV_CODEC_ID_ADPCM_EA_R1
; break;
226 case 3: ea
->audio_codec
= AV_CODEC_ID_ADPCM_EA_R2
; break;
228 avpriv_request_sample(s
, "stream type; revision=%i, revision2=%i", revision
, revision2
);
233 ea
->audio_codec
= AV_CODEC_ID_MP3
;
238 ea
->audio_codec
= AV_CODEC_ID_NONE
;
239 avpriv_request_sample(s
, "stream type; revision2=%i", revision2
);
244 avpriv_request_sample(s
,
245 "stream type; compression_type=%i",
250 if (ea
->sample_rate
== -1)
251 ea
->sample_rate
= revision
== 3 ? 48000 : 22050;
256 static void process_audio_header_eacs(AVFormatContext
*s
)
258 EaDemuxContext
*ea
= s
->priv_data
;
259 AVIOContext
*pb
= s
->pb
;
260 int compression_type
;
262 ea
->sample_rate
= ea
->big_endian
? avio_rb32(pb
) : avio_rl32(pb
);
263 ea
->bytes
= avio_r8(pb
); /* 1=8-bit, 2=16-bit */
264 ea
->num_channels
= avio_r8(pb
);
265 compression_type
= avio_r8(pb
);
268 switch (compression_type
) {
272 ea
->audio_codec
= AV_CODEC_ID_PCM_S8
;
275 ea
->audio_codec
= AV_CODEC_ID_PCM_S16LE
;
280 ea
->audio_codec
= AV_CODEC_ID_PCM_MULAW
;
284 ea
->audio_codec
= AV_CODEC_ID_ADPCM_IMA_EA_EACS
;
287 avpriv_request_sample(s
,
288 "stream type; audio compression_type=%i",
293 static void process_audio_header_sead(AVFormatContext
*s
)
295 EaDemuxContext
*ea
= s
->priv_data
;
296 AVIOContext
*pb
= s
->pb
;
298 ea
->sample_rate
= avio_rl32(pb
);
299 ea
->bytes
= avio_rl32(pb
); /* 1=8-bit, 2=16-bit */
300 ea
->num_channels
= avio_rl32(pb
);
301 ea
->audio_codec
= AV_CODEC_ID_ADPCM_IMA_EA_SEAD
;
304 static void process_video_header_mdec(AVFormatContext
*s
)
306 EaDemuxContext
*ea
= s
->priv_data
;
307 AVIOContext
*pb
= s
->pb
;
309 ea
->width
= avio_rl16(pb
);
310 ea
->height
= avio_rl16(pb
);
311 ea
->time_base
= (AVRational
) { 1, 15 };
312 ea
->video_codec
= AV_CODEC_ID_MDEC
;
315 static int process_video_header_vp6(AVFormatContext
*s
)
317 EaDemuxContext
*ea
= s
->priv_data
;
318 AVIOContext
*pb
= s
->pb
;
321 ea
->nb_frames
= avio_rl32(pb
);
323 ea
->time_base
.den
= avio_rl32(pb
);
324 ea
->time_base
.num
= avio_rl32(pb
);
325 if (ea
->time_base
.den
<= 0 || ea
->time_base
.num
<= 0) {
326 av_log(s
, AV_LOG_ERROR
, "Timebase is invalid\n");
327 return AVERROR_INVALIDDATA
;
329 ea
->video_codec
= AV_CODEC_ID_VP6
;
334 static void process_video_header_cmv(AVFormatContext
*s
)
336 EaDemuxContext
*ea
= s
->priv_data
;
339 avio_skip(s
->pb
, 10);
340 fps
= avio_rl16(s
->pb
);
342 ea
->time_base
= (AVRational
) { 1, fps
};
343 ea
->video_codec
= AV_CODEC_ID_CMV
;
346 /* Process EA file header.
347 * Return 1 if the EA file is valid and successfully opened, 0 otherwise. */
348 static int process_ea_header(AVFormatContext
*s
)
350 uint32_t blockid
, size
= 0;
351 EaDemuxContext
*ea
= s
->priv_data
;
352 AVIOContext
*pb
= s
->pb
;
355 for (i
= 0; i
< 5 && (!ea
->audio_codec
|| !ea
->video_codec
); i
++) {
356 uint64_t startpos
= avio_tell(pb
);
359 blockid
= avio_rl32(pb
);
360 size
= avio_rl32(pb
);
362 ea
->big_endian
= size
> av_bswap32(size
);
364 size
= av_bswap32(size
);
367 av_log(s
, AV_LOG_ERROR
, "chunk size too small\n");
368 return AVERROR_INVALIDDATA
;
373 if (avio_rl32(pb
) != EACS_TAG
) {
374 avpriv_request_sample(s
, "unknown 1SNh headerid");
377 process_audio_header_eacs(s
);
382 blockid
= avio_rl32(pb
);
383 if (blockid
== GSTR_TAG
) {
385 } else if ((blockid
& 0xFFFF) != PT00_TAG
) {
386 avpriv_request_sample(s
, "unknown SCHl headerid");
389 err
= process_audio_header_elements(s
);
393 process_audio_header_sead(s
);
397 process_video_header_cmv(s
);
401 ea
->video_codec
= AV_CODEC_ID_TGV
;
405 process_video_header_mdec(s
);
409 ea
->video_codec
= AV_CODEC_ID_MPEG2VIDEO
;
414 ea
->video_codec
= AV_CODEC_ID_TGQ
;
415 ea
->time_base
= (AVRational
) { 1, 15 };
419 ea
->video_codec
= AV_CODEC_ID_TQI
;
420 ea
->time_base
= (AVRational
) { 1, 15 };
424 ea
->video_codec
= AV_CODEC_ID_MAD
;
426 ea
->time_base
= (AVRational
) { avio_rl16(pb
), 1000 };
430 err
= process_video_header_vp6(s
);
435 av_log(s
, AV_LOG_ERROR
, "error parsing header: %i\n", err
);
439 avio_seek(pb
, startpos
+ size
, SEEK_SET
);
442 avio_seek(pb
, 0, SEEK_SET
);
447 static int ea_probe(AVProbeData
*p
)
449 unsigned big_endian
, size
;
451 switch (AV_RL32(&p
->buf
[0])) {
465 size
= AV_RL32(&p
->buf
[4]);
466 big_endian
= size
> 0x000FFFFF;
468 size
= av_bswap32(size
);
469 if (size
> 0xfffff || size
< 8)
472 return AVPROBE_SCORE_MAX
;
475 static int ea_read_header(AVFormatContext
*s
)
477 EaDemuxContext
*ea
= s
->priv_data
;
480 if (process_ea_header(s
)<=0)
483 if (ea
->video_codec
) {
484 /* initialize the video decoder stream */
485 st
= avformat_new_stream(s
, NULL
);
487 return AVERROR(ENOMEM
);
488 ea
->video_stream_index
= st
->index
;
489 st
->codec
->codec_type
= AVMEDIA_TYPE_VIDEO
;
490 st
->codec
->codec_id
= ea
->video_codec
;
491 // parsing is necessary to make FFmpeg generate correct timestamps
492 if (st
->codec
->codec_id
== AV_CODEC_ID_MPEG2VIDEO
)
493 st
->need_parsing
= AVSTREAM_PARSE_HEADERS
;
494 st
->codec
->codec_tag
= 0; /* no fourcc */
495 st
->codec
->width
= ea
->width
;
496 st
->codec
->height
= ea
->height
;
497 st
->duration
= st
->nb_frames
= ea
->nb_frames
;
498 if (ea
->time_base
.num
)
499 avpriv_set_pts_info(st
, 64, ea
->time_base
.num
, ea
->time_base
.den
);
501 st
->avg_frame_rate
= av_inv_q(ea
->time_base
);
504 if (ea
->audio_codec
) {
505 if (ea
->num_channels
<= 0 || ea
->num_channels
> 2) {
506 av_log(s
, AV_LOG_WARNING
,
507 "Unsupported number of channels: %d\n", ea
->num_channels
);
511 if (ea
->sample_rate
<= 0) {
512 av_log(s
, AV_LOG_ERROR
,
513 "Unsupported sample rate: %d\n", ea
->sample_rate
);
517 if (ea
->bytes
<= 0) {
518 av_log(s
, AV_LOG_ERROR
,
519 "Invalid number of bytes per sample: %d\n", ea
->bytes
);
520 ea
->audio_codec
= AV_CODEC_ID_NONE
;
524 /* initialize the audio decoder stream */
525 st
= avformat_new_stream(s
, NULL
);
527 return AVERROR(ENOMEM
);
528 avpriv_set_pts_info(st
, 33, 1, ea
->sample_rate
);
529 st
->codec
->codec_type
= AVMEDIA_TYPE_AUDIO
;
530 st
->codec
->codec_id
= ea
->audio_codec
;
531 st
->codec
->codec_tag
= 0; /* no tag */
532 st
->codec
->channels
= ea
->num_channels
;
533 st
->codec
->sample_rate
= ea
->sample_rate
;
534 st
->codec
->bits_per_coded_sample
= ea
->bytes
* 8;
535 st
->codec
->bit_rate
= st
->codec
->channels
*
536 st
->codec
->sample_rate
*
537 st
->codec
->bits_per_coded_sample
/ 4;
538 st
->codec
->block_align
= st
->codec
->channels
*
539 st
->codec
->bits_per_coded_sample
;
540 ea
->audio_stream_index
= st
->index
;
547 static int ea_read_packet(AVFormatContext
*s
, AVPacket
*pkt
)
549 EaDemuxContext
*ea
= s
->priv_data
;
550 AVIOContext
*pb
= s
->pb
;
551 int partial_packet
= 0;
552 unsigned int chunk_type
, chunk_size
;
553 int ret
= 0, packet_read
= 0, key
= 0;
554 int av_uninit(num_samples
);
556 while (!packet_read
|| partial_packet
) {
557 chunk_type
= avio_rl32(pb
);
558 chunk_size
= ea
->big_endian
? avio_rb32(pb
) : avio_rl32(pb
);
560 return AVERROR_INVALIDDATA
;
563 switch (chunk_type
) {
566 /* header chunk also contains data; skip over the header portion */
568 return AVERROR_INVALIDDATA
;
575 if (!ea
->audio_codec
) {
576 avio_skip(pb
, chunk_size
);
578 } else if (ea
->audio_codec
== AV_CODEC_ID_PCM_S16LE_PLANAR
||
579 ea
->audio_codec
== AV_CODEC_ID_MP3
) {
580 num_samples
= avio_rl32(pb
);
585 if (partial_packet
) {
586 avpriv_request_sample(s
, "video header followed by audio packet");
594 ret
= av_get_packet(pb
, pkt
, chunk_size
);
597 pkt
->stream_index
= ea
->audio_stream_index
;
599 switch (ea
->audio_codec
) {
600 case AV_CODEC_ID_ADPCM_EA
:
601 case AV_CODEC_ID_ADPCM_EA_R1
:
602 case AV_CODEC_ID_ADPCM_EA_R2
:
603 case AV_CODEC_ID_ADPCM_IMA_EA_EACS
:
604 case AV_CODEC_ID_ADPCM_EA_R3
:
606 av_log(s
, AV_LOG_ERROR
, "Packet is too short\n");
608 return AVERROR_INVALIDDATA
;
610 if (ea
->audio_codec
== AV_CODEC_ID_ADPCM_EA_R3
)
611 pkt
->duration
= AV_RB32(pkt
->data
);
613 pkt
->duration
= AV_RL32(pkt
->data
);
615 case AV_CODEC_ID_ADPCM_IMA_EA_SEAD
:
616 pkt
->duration
= ret
* 2 / ea
->num_channels
;
618 case AV_CODEC_ID_PCM_S16LE_PLANAR
:
619 case AV_CODEC_ID_MP3
:
620 pkt
->duration
= num_samples
;
623 pkt
->duration
= chunk_size
/ (ea
->bytes
* ea
->num_channels
);
644 key
= AV_PKT_FLAG_KEY
;
649 avio_seek(pb
, -8, SEEK_CUR
); // include chunk preamble
651 goto get_video_packet
;
655 return AVERROR_INVALIDDATA
;
657 avio_skip(pb
, 8); // skip ea DCT header
659 goto get_video_packet
;
664 key
= AV_PKT_FLAG_KEY
;
670 if (partial_packet
) {
671 ret
= av_append_packet(pb
, pkt
, chunk_size
);
673 ret
= av_get_packet(pb
, pkt
, chunk_size
);
678 partial_packet
= chunk_type
== MVIh_TAG
;
679 pkt
->stream_index
= ea
->video_stream_index
;
685 avio_skip(pb
, chunk_size
);
690 if (ret
< 0 && partial_packet
)
695 AVInputFormat ff_ea_demuxer
= {
697 .long_name
= NULL_IF_CONFIG_SMALL("Electronic Arts Multimedia"),
698 .priv_data_size
= sizeof(EaDemuxContext
),
699 .read_probe
= ea_probe
,
700 .read_header
= ea_read_header
,
701 .read_packet
= ea_read_packet
,