2 * Argonaut Games ASF (de)muxer
4 * Copyright (C) 2020 Zane van Iperen (zane@zanevaniperen.com)
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 #include "libavutil/intreadwrite.h"
25 #include "libavutil/avassert.h"
26 #include "libavutil/opt.h"
29 /* Maximum number of blocks to read at once. */
30 #define ASF_NB_BLOCKS 32
32 typedef struct ArgoASFDemuxContext {
33 ArgoASFFileHeader fhdr;
34 ArgoASFChunkHeader ckhdr;
36 } ArgoASFDemuxContext;
38 typedef struct ArgoASFMuxContext {
46 void ff_argo_asf_parse_file_header(ArgoASFFileHeader *hdr, const uint8_t *buf)
48 hdr->magic = AV_RL32(buf + 0);
49 hdr->version_major = AV_RL16(buf + 4);
50 hdr->version_minor = AV_RL16(buf + 6);
51 hdr->num_chunks = AV_RL32(buf + 8);
52 hdr->chunk_offset = AV_RL32(buf + 12);
53 for (int i = 0; i < FF_ARRAY_ELEMS(hdr->name); i++)
54 hdr->name[i] = AV_RL8(buf + 16 + i);
57 int ff_argo_asf_validate_file_header(AVFormatContext *s, const ArgoASFFileHeader *hdr)
59 if (hdr->magic != ASF_TAG || hdr->num_chunks == 0)
60 return AVERROR_INVALIDDATA;
62 if (hdr->num_chunks > 1) {
63 avpriv_request_sample(s, ">1 chunk");
64 return AVERROR_PATCHWELCOME;
67 if (hdr->chunk_offset < ASF_FILE_HEADER_SIZE)
68 return AVERROR_INVALIDDATA;
73 void ff_argo_asf_parse_chunk_header(ArgoASFChunkHeader *hdr, const uint8_t *buf)
75 hdr->num_blocks = AV_RL32(buf + 0);
76 hdr->num_samples = AV_RL32(buf + 4);
77 hdr->unk1 = AV_RL32(buf + 8);
78 hdr->sample_rate = AV_RL16(buf + 12);
79 hdr->unk2 = AV_RL16(buf + 14);
80 hdr->flags = AV_RL32(buf + 16);
83 int ff_argo_asf_fill_stream(AVStream *st, const ArgoASFFileHeader *fhdr,
84 const ArgoASFChunkHeader *ckhdr)
86 if (ckhdr->num_samples != ASF_SAMPLE_COUNT) {
87 av_log(st, AV_LOG_ERROR, "Invalid sample count. Got %u, expected %d\n",
88 ckhdr->num_samples, ASF_SAMPLE_COUNT);
89 return AVERROR_INVALIDDATA;
92 if ((ckhdr->flags & ASF_CF_ALWAYS1) != ASF_CF_ALWAYS1 || (ckhdr->flags & ASF_CF_ALWAYS0) != 0) {
93 avpriv_request_sample(st, "Nonstandard flags (0x%08X)", ckhdr->flags);
94 return AVERROR_PATCHWELCOME;
97 st->codecpar->codec_type = AVMEDIA_TYPE_AUDIO;
98 st->codecpar->codec_id = AV_CODEC_ID_ADPCM_ARGO;
99 st->codecpar->format = AV_SAMPLE_FMT_S16P;
101 if (ckhdr->flags & ASF_CF_STEREO) {
102 st->codecpar->channel_layout = AV_CH_LAYOUT_STEREO;
103 st->codecpar->channels = 2;
105 st->codecpar->channel_layout = AV_CH_LAYOUT_MONO;
106 st->codecpar->channels = 1;
109 /* v1.1 files (FX Fighter) are all marked as 44100, but are actually 22050. */
110 if (fhdr->version_major == 1 && fhdr->version_minor == 1)
111 st->codecpar->sample_rate = 22050;
113 st->codecpar->sample_rate = ckhdr->sample_rate;
115 st->codecpar->bits_per_coded_sample = 4;
117 if (ckhdr->flags & ASF_CF_BITS_PER_SAMPLE)
118 st->codecpar->bits_per_raw_sample = 16;
120 st->codecpar->bits_per_raw_sample = 8;
122 if (st->codecpar->bits_per_raw_sample != 16) {
123 /* The header allows for these, but I've never seen any files with them. */
124 avpriv_request_sample(st, "Non 16-bit samples");
125 return AVERROR_PATCHWELCOME;
129 * (nchannel control bytes) + ((bytes_per_channel) * nchannel)
130 * For mono, this is 17. For stereo, this is 34.
132 st->codecpar->block_align = st->codecpar->channels +
133 (ckhdr->num_samples / 2) *
134 st->codecpar->channels;
136 st->codecpar->bit_rate = st->codecpar->channels *
137 st->codecpar->sample_rate *
138 st->codecpar->bits_per_coded_sample;
140 avpriv_set_pts_info(st, 64, 1, st->codecpar->sample_rate);
142 st->duration = ckhdr->num_blocks * ckhdr->num_samples;
143 st->nb_frames = ckhdr->num_blocks;
147 #if CONFIG_ARGO_ASF_DEMUXER
150 * 1.1: https://samples.ffmpeg.org/game-formats/brender/part2.zip
152 * 1.2: Croc! Legend of the Gobbos
154 * The Emperor's New Groove
155 * Disney's Aladdin in Nasira's Revenge
157 static int argo_asf_is_known_version(const ArgoASFFileHeader *hdr)
159 return (hdr->version_major == 1 && hdr->version_minor == 1) ||
160 (hdr->version_major == 1 && hdr->version_minor == 2) ||
161 (hdr->version_major == 2 && hdr->version_minor == 1);
164 static int argo_asf_probe(const AVProbeData *p)
166 ArgoASFFileHeader hdr;
168 av_assert0(AVPROBE_PADDING_SIZE >= ASF_FILE_HEADER_SIZE);
170 ff_argo_asf_parse_file_header(&hdr, p->buf);
172 if (hdr.magic != ASF_TAG)
175 if (!argo_asf_is_known_version(&hdr))
176 return AVPROBE_SCORE_EXTENSION / 2;
178 return AVPROBE_SCORE_EXTENSION + 1;
181 static int argo_asf_read_header(AVFormatContext *s)
184 AVIOContext *pb = s->pb;
186 ArgoASFDemuxContext *asf = s->priv_data;
187 uint8_t buf[ASF_MIN_BUFFER_SIZE];
189 if (!(st = avformat_new_stream(s, NULL)))
190 return AVERROR(ENOMEM);
192 if ((ret = avio_read(pb, buf, ASF_FILE_HEADER_SIZE)) < 0)
194 else if (ret != ASF_FILE_HEADER_SIZE)
197 ff_argo_asf_parse_file_header(&asf->fhdr, buf);
199 if ((ret = ff_argo_asf_validate_file_header(s, &asf->fhdr)) < 0)
202 if ((ret = avio_skip(pb, asf->fhdr.chunk_offset - ASF_FILE_HEADER_SIZE)) < 0)
205 if ((ret = avio_read(pb, buf, ASF_CHUNK_HEADER_SIZE)) < 0)
207 else if (ret != ASF_CHUNK_HEADER_SIZE)
210 ff_argo_asf_parse_chunk_header(&asf->ckhdr, buf);
212 return ff_argo_asf_fill_stream(st, &asf->fhdr, &asf->ckhdr);
215 static int argo_asf_read_packet(AVFormatContext *s, AVPacket *pkt)
217 ArgoASFDemuxContext *asf = s->priv_data;
219 AVStream *st = s->streams[0];
220 AVIOContext *pb = s->pb;
223 if (asf->blocks_read >= asf->ckhdr.num_blocks)
226 ret = av_get_packet(pb, pkt, st->codecpar->block_align *
227 FFMIN(ASF_NB_BLOCKS, asf->ckhdr.num_blocks - asf->blocks_read));
231 /* Something real screwy is going on. */
232 if (ret % st->codecpar->block_align != 0)
233 return AVERROR_INVALIDDATA;
236 pkt->stream_index = st->index;
237 pkt->duration = asf->ckhdr.num_samples * (ret / st->codecpar->block_align);
238 asf->blocks_read += (ret / st->codecpar->block_align);
240 pkt->flags &= ~AV_PKT_FLAG_CORRUPT;
245 * Not actually sure what ASF stands for.
246 * - Argonaut Sound File?
247 * - Audio Stream File?
249 AVInputFormat ff_argo_asf_demuxer = {
251 .long_name = NULL_IF_CONFIG_SMALL("Argonaut Games ASF"),
252 .priv_data_size = sizeof(ArgoASFDemuxContext),
253 .read_probe = argo_asf_probe,
254 .read_header = argo_asf_read_header,
255 .read_packet = argo_asf_read_packet
259 #if CONFIG_ARGO_ASF_MUXER
260 static int argo_asf_write_init(AVFormatContext *s)
262 ArgoASFMuxContext *ctx = s->priv_data;
263 const AVCodecParameters *par;
265 if (s->nb_streams != 1) {
266 av_log(s, AV_LOG_ERROR, "ASF files have exactly one stream\n");
267 return AVERROR(EINVAL);
270 par = s->streams[0]->codecpar;
272 if (par->codec_id != AV_CODEC_ID_ADPCM_ARGO) {
273 av_log(s, AV_LOG_ERROR, "%s codec not supported\n",
274 avcodec_get_name(par->codec_id));
275 return AVERROR(EINVAL);
278 if (ctx->version_major == 1 && ctx->version_minor == 1 && par->sample_rate != 22050) {
279 av_log(s, AV_LOG_ERROR, "ASF v1.1 files only support a sample rate of 22050\n");
280 return AVERROR(EINVAL);
283 if (par->channels > 2) {
284 av_log(s, AV_LOG_ERROR, "ASF files only support up to 2 channels\n");
285 return AVERROR(EINVAL);
288 if (par->block_align != 17 * par->channels)
289 return AVERROR(EINVAL);
291 if (par->sample_rate > UINT16_MAX) {
292 av_log(s, AV_LOG_ERROR, "Sample rate too large\n");
293 return AVERROR(EINVAL);
296 if (!(s->pb->seekable & AVIO_SEEKABLE_NORMAL)) {
297 av_log(s, AV_LOG_ERROR, "Stream not seekable, unable to write output file\n");
298 return AVERROR(EINVAL);
304 static void argo_asf_write_file_header(const ArgoASFFileHeader *fhdr, AVIOContext *pb)
306 avio_wl32( pb, fhdr->magic);
307 avio_wl16( pb, fhdr->version_major);
308 avio_wl16( pb, fhdr->version_minor);
309 avio_wl32( pb, fhdr->num_chunks);
310 avio_wl32( pb, fhdr->chunk_offset);
311 avio_write(pb, fhdr->name, sizeof(fhdr->name));
314 static void argo_asf_write_chunk_header(const ArgoASFChunkHeader *ckhdr, AVIOContext *pb)
316 avio_wl32(pb, ckhdr->num_blocks);
317 avio_wl32(pb, ckhdr->num_samples);
318 avio_wl32(pb, ckhdr->unk1);
319 avio_wl16(pb, ckhdr->sample_rate);
320 avio_wl16(pb, ckhdr->unk2);
321 avio_wl32(pb, ckhdr->flags);
324 static int argo_asf_write_header(AVFormatContext *s)
326 const AVCodecParameters *par = s->streams[0]->codecpar;
327 ArgoASFMuxContext *ctx = s->priv_data;
328 ArgoASFChunkHeader chdr;
329 ArgoASFFileHeader fhdr = {
331 .version_major = (uint16_t)ctx->version_major,
332 .version_minor = (uint16_t)ctx->version_minor,
334 .chunk_offset = ASF_FILE_HEADER_SIZE
338 * If the user specified a name, use it as is. Otherwise take the
339 * basename and lop off the extension (if any).
342 strncpy(fhdr.name, ctx->name, sizeof(fhdr.name));
344 const char *start = av_basename(s->url);
345 const char *end = strrchr(start, '.');
353 memcpy(fhdr.name, start, FFMIN(len, sizeof(fhdr.name)));
357 chdr.num_samples = ASF_SAMPLE_COUNT;
360 if (ctx->version_major == 1 && ctx->version_minor == 1)
361 chdr.sample_rate = 44100;
363 chdr.sample_rate = par->sample_rate;
366 chdr.flags = ASF_CF_BITS_PER_SAMPLE | ASF_CF_ALWAYS1;
368 if (par->channels == 2)
369 chdr.flags |= ASF_CF_STEREO;
371 argo_asf_write_file_header(&fhdr, s->pb);
372 argo_asf_write_chunk_header(&chdr, s->pb);
376 static int argo_asf_write_packet(AVFormatContext *s, AVPacket *pkt)
378 ArgoASFMuxContext *ctx = s->priv_data;
379 AVCodecParameters *par = s->streams[0]->codecpar;
380 int nb_blocks = pkt->size / par->block_align;
382 if (pkt->size % par->block_align != 0)
383 return AVERROR_INVALIDDATA;
385 if (ctx->nb_blocks + nb_blocks > UINT32_MAX)
386 return AVERROR_INVALIDDATA;
388 avio_write(s->pb, pkt->data, pkt->size);
390 ctx->nb_blocks += nb_blocks;
394 static int argo_asf_write_trailer(AVFormatContext *s)
396 ArgoASFMuxContext *ctx = s->priv_data;
399 if ((ret = avio_seek(s->pb, ASF_FILE_HEADER_SIZE, SEEK_SET) < 0))
402 avio_wl32(s->pb, (uint32_t)ctx->nb_blocks);
406 static const AVOption argo_asf_options[] = {
408 .name = "version_major",
409 .help = "override file major version",
410 .offset = offsetof(ArgoASFMuxContext, version_major),
411 .type = AV_OPT_TYPE_INT,
412 .default_val = {.i64 = 2},
415 .flags = AV_OPT_FLAG_ENCODING_PARAM
418 .name = "version_minor",
419 .help = "override file minor version",
420 .offset = offsetof(ArgoASFMuxContext, version_minor),
421 .type = AV_OPT_TYPE_INT,
422 .default_val = {.i64 = 1},
425 .flags = AV_OPT_FLAG_ENCODING_PARAM
429 .help = "embedded file name (max 8 characters)",
430 .offset = offsetof(ArgoASFMuxContext, name),
431 .type = AV_OPT_TYPE_STRING,
432 .default_val = {.str = NULL},
433 .flags = AV_OPT_FLAG_ENCODING_PARAM
438 static const AVClass argo_asf_muxer_class = {
439 .class_name = "argo_asf_muxer",
440 .item_name = av_default_item_name,
441 .option = argo_asf_options,
442 .version = LIBAVUTIL_VERSION_INT
445 AVOutputFormat ff_argo_asf_muxer = {
447 .long_name = NULL_IF_CONFIG_SMALL("Argonaut Games ASF"),
449 * NB: Can't do this as it conflicts with the actual ASF format.
450 * .extensions = "asf",
452 .audio_codec = AV_CODEC_ID_ADPCM_ARGO,
453 .video_codec = AV_CODEC_ID_NONE,
454 .init = argo_asf_write_init,
455 .write_header = argo_asf_write_header,
456 .write_packet = argo_asf_write_packet,
457 .write_trailer = argo_asf_write_trailer,
458 .priv_class = &argo_asf_muxer_class,
459 .priv_data_size = sizeof(ArgoASFMuxContext)