flic.c 9.16 KB
Newer Older
Mike Melanson's avatar
Mike Melanson committed
1 2 3 4
/*
 * FLI/FLC Animation File Demuxer
 * Copyright (c) 2003 The ffmpeg Project
 *
5 6 7
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
Mike Melanson's avatar
Mike Melanson committed
8 9
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
10
 * version 2.1 of the License, or (at your option) any later version.
Mike Melanson's avatar
Mike Melanson committed
11
 *
12
 * FFmpeg is distributed in the hope that it will be useful,
Mike Melanson's avatar
Mike Melanson committed
13 14 15 16 17
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * 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
Mike Melanson's avatar
Mike Melanson committed
20 21 22
 */

/**
23
 * @file
Mike Melanson's avatar
Mike Melanson committed
24 25 26 27 28 29
 * FLI/FLC file demuxer
 * by Mike Melanson (melanson@pcisys.net)
 * for more information on the .fli/.flc file format and all of its many
 * variations, visit:
 *   http://www.compuphase.com/flic.htm
 *
30 31
 * This demuxer handles standard 0xAF11- and 0xAF12-type FLIs. It also handles
 * special FLIs from the PC games "Magic Carpet" and "X-COM: Terror from the Deep".
Mike Melanson's avatar
Mike Melanson committed
32 33
 */

34
#include "libavutil/intreadwrite.h"
35
#include "libavutil/audioconvert.h"
Mike Melanson's avatar
Mike Melanson committed
36 37 38 39
#include "avformat.h"

#define FLIC_FILE_MAGIC_1 0xAF11
#define FLIC_FILE_MAGIC_2 0xAF12
40
#define FLIC_FILE_MAGIC_3 0xAF44  /* Flic Type for Extended FLX Format which
41
                                     originated in Dave's Targa Animator (DTA) */
Mike Melanson's avatar
Mike Melanson committed
42 43
#define FLIC_CHUNK_MAGIC_1 0xF1FA
#define FLIC_CHUNK_MAGIC_2 0xF5FA
Mike Melanson's avatar
Mike Melanson committed
44 45
#define FLIC_MC_SPEED 5  /* speed for Magic Carpet game FLIs */
#define FLIC_DEFAULT_SPEED 5  /* for FLIs that have 0 speed */
46 47 48
#define FLIC_TFTD_CHUNK_AUDIO 0xAAAA /* Audio chunk. Used in Terror from the Deep.
                                        Has 10 B extra header not accounted for in the chunk header */
#define FLIC_TFTD_SAMPLE_RATE 22050
Mike Melanson's avatar
Mike Melanson committed
49 50 51 52 53 54

#define FLIC_HEADER_SIZE 128
#define FLIC_PREAMBLE_SIZE 6

typedef struct FlicDemuxContext {
    int video_stream_index;
55
    int audio_stream_index;
Mike Melanson's avatar
Mike Melanson committed
56
    int frame_number;
Mike Melanson's avatar
Mike Melanson committed
57 58 59 60 61 62
} FlicDemuxContext;

static int flic_probe(AVProbeData *p)
{
    int magic_number;

63 64 65
    if(p->buf_size < FLIC_HEADER_SIZE)
        return 0;

66
    magic_number = AV_RL16(&p->buf[4]);
Mike Melanson's avatar
Mike Melanson committed
67
    if ((magic_number != FLIC_FILE_MAGIC_1) &&
68 69
        (magic_number != FLIC_FILE_MAGIC_2) &&
        (magic_number != FLIC_FILE_MAGIC_3))
Mike Melanson's avatar
Mike Melanson committed
70 71
        return 0;

72 73 74 75 76 77 78 79 80 81
    if(AV_RL16(&p->buf[0x10]) != FLIC_CHUNK_MAGIC_1){
        if(AV_RL32(&p->buf[0x10]) > 2000)
            return 0;
    }

    if(   AV_RL16(&p->buf[0x08]) > 4096
       || AV_RL16(&p->buf[0x0A]) > 4096)
        return 0;


Mike Melanson's avatar
Mike Melanson committed
82 83 84 85 86 87
    return AVPROBE_SCORE_MAX;
}

static int flic_read_header(AVFormatContext *s,
                            AVFormatParameters *ap)
{
88
    FlicDemuxContext *flic = s->priv_data;
89
    AVIOContext *pb = s->pb;
Mike Melanson's avatar
Mike Melanson committed
90
    unsigned char header[FLIC_HEADER_SIZE];
91
    AVStream *st, *ast;
Mike Melanson's avatar
Mike Melanson committed
92 93
    int speed;
    int magic_number;
94
    unsigned char preamble[FLIC_PREAMBLE_SIZE];
Mike Melanson's avatar
Mike Melanson committed
95

Mike Melanson's avatar
Mike Melanson committed
96
    flic->frame_number = 0;
Mike Melanson's avatar
Mike Melanson committed
97 98

    /* load the whole header and pull out the width and height */
99
    if (avio_read(pb, header, FLIC_HEADER_SIZE) != FLIC_HEADER_SIZE)
100
        return AVERROR(EIO);
Mike Melanson's avatar
Mike Melanson committed
101

102 103
    magic_number = AV_RL16(&header[4]);
    speed = AV_RL32(&header[0x10]);
Mike Melanson's avatar
Mike Melanson committed
104 105
    if (speed == 0)
        speed = FLIC_DEFAULT_SPEED;
Mike Melanson's avatar
Mike Melanson committed
106 107 108 109

    /* initialize the decoder streams */
    st = av_new_stream(s, 0);
    if (!st)
110
        return AVERROR(ENOMEM);
Mike Melanson's avatar
Mike Melanson committed
111
    flic->video_stream_index = st->index;
112
    st->codec->codec_type = AVMEDIA_TYPE_VIDEO;
113 114
    st->codec->codec_id = CODEC_ID_FLIC;
    st->codec->codec_tag = 0;  /* no fourcc */
115 116
    st->codec->width = AV_RL16(&header[0x08]);
    st->codec->height = AV_RL16(&header[0x0A]);
Mike Melanson's avatar
Mike Melanson committed
117

118 119 120 121 122 123 124 125
    if (!st->codec->width || !st->codec->height) {
        /* Ugly hack needed for the following sample: */
        /* http://samples.mplayerhq.hu/fli-flc/fli-bugs/specular.flc */
        av_log(s, AV_LOG_WARNING,
               "File with no specified width/height. Trying 640x480.\n");
        st->codec->width  = 640;
        st->codec->height = 480;
    }
Mike Melanson's avatar
Mike Melanson committed
126 127

    /* send over the whole 128-byte FLIC header */
128 129 130
    st->codec->extradata_size = FLIC_HEADER_SIZE;
    st->codec->extradata = av_malloc(FLIC_HEADER_SIZE);
    memcpy(st->codec->extradata, header, FLIC_HEADER_SIZE);
Mike Melanson's avatar
Mike Melanson committed
131

132
    /* peek at the preamble to detect TFTD videos - they seem to always start with an audio chunk */
133
    if (avio_read(pb, preamble, FLIC_PREAMBLE_SIZE) != FLIC_PREAMBLE_SIZE) {
134 135 136
        av_log(s, AV_LOG_ERROR, "Failed to peek at preamble\n");
        return AVERROR(EIO);
    }
Mike Melanson's avatar
Mike Melanson committed
137

138
    avio_seek(pb, -FLIC_PREAMBLE_SIZE, SEEK_CUR);
139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155

    /* Time to figure out the framerate:
     * If the first preamble's magic number is 0xAAAA then this file is from
     * X-COM: Terror from the Deep. If on the other hand there is a FLIC chunk
     * magic number at offset 0x10 assume this file is from Magic Carpet instead.
     * If neither of the above is true then this is a normal FLIC file.
     */
    if (AV_RL16(&preamble[4]) == FLIC_TFTD_CHUNK_AUDIO) {
        /* TFTD videos have an extra 22050 Hz 8-bit mono audio stream */
        ast = av_new_stream(s, 1);
        if (!ast)
            return AVERROR(ENOMEM);

        flic->audio_stream_index = ast->index;

        /* all audio frames are the same size, so use the size of the first chunk for block_align */
        ast->codec->block_align = AV_RL32(&preamble[0]);
156
        ast->codec->codec_type = AVMEDIA_TYPE_AUDIO;
157 158 159 160
        ast->codec->codec_id = CODEC_ID_PCM_U8;
        ast->codec->codec_tag = 0;
        ast->codec->sample_rate = FLIC_TFTD_SAMPLE_RATE;
        ast->codec->channels = 1;
161
        ast->codec->sample_fmt = AV_SAMPLE_FMT_U8;
162 163
        ast->codec->bit_rate = st->codec->sample_rate * 8;
        ast->codec->bits_per_coded_sample = 8;
164
        ast->codec->channel_layout = AV_CH_LAYOUT_MONO;
165 166 167 168 169 170 171 172
        ast->codec->extradata_size = 0;

        /* Since the header information is incorrect we have to figure out the
         * framerate using block_align and the fact that the audio is 22050 Hz.
         * We usually have two cases: 2205 -> 10 fps and 1470 -> 15 fps */
        av_set_pts_info(st, 64, ast->codec->block_align, FLIC_TFTD_SAMPLE_RATE);
        av_set_pts_info(ast, 64, 1, FLIC_TFTD_SAMPLE_RATE);
    } else if (AV_RL16(&header[0x10]) == FLIC_CHUNK_MAGIC_1) {
Mike Melanson's avatar
Mike Melanson committed
173
        av_set_pts_info(st, 64, FLIC_MC_SPEED, 70);
Mike Melanson's avatar
Mike Melanson committed
174 175

        /* rewind the stream since the first chunk is at offset 12 */
176
        avio_seek(pb, 12, SEEK_SET);
Mike Melanson's avatar
Mike Melanson committed
177 178

        /* send over abbreviated FLIC header chunk */
179 180 181 182
        av_free(st->codec->extradata);
        st->codec->extradata_size = 12;
        st->codec->extradata = av_malloc(12);
        memcpy(st->codec->extradata, header, 12);
Mike Melanson's avatar
Mike Melanson committed
183 184

    } else if (magic_number == FLIC_FILE_MAGIC_1) {
Mike Melanson's avatar
Mike Melanson committed
185
        av_set_pts_info(st, 64, speed, 70);
186 187
    } else if ((magic_number == FLIC_FILE_MAGIC_2) ||
               (magic_number == FLIC_FILE_MAGIC_3)) {
Mike Melanson's avatar
Mike Melanson committed
188
        av_set_pts_info(st, 64, speed, 1000);
189 190
    } else {
        av_log(s, AV_LOG_INFO, "Invalid or unsupported magic chunk in file\n");
Mike Melanson's avatar
Mike Melanson committed
191
        return AVERROR_INVALIDDATA;
192
    }
Mike Melanson's avatar
Mike Melanson committed
193 194 195 196 197 198 199

    return 0;
}

static int flic_read_packet(AVFormatContext *s,
                            AVPacket *pkt)
{
200
    FlicDemuxContext *flic = s->priv_data;
201
    AVIOContext *pb = s->pb;
Mike Melanson's avatar
Mike Melanson committed
202 203 204 205 206 207 208 209
    int packet_read = 0;
    unsigned int size;
    int magic;
    int ret = 0;
    unsigned char preamble[FLIC_PREAMBLE_SIZE];

    while (!packet_read) {

210
        if ((ret = avio_read(pb, preamble, FLIC_PREAMBLE_SIZE)) !=
Mike Melanson's avatar
Mike Melanson committed
211
            FLIC_PREAMBLE_SIZE) {
212
            ret = AVERROR(EIO);
Mike Melanson's avatar
Mike Melanson committed
213 214 215
            break;
        }

216 217
        size = AV_RL32(&preamble[0]);
        magic = AV_RL16(&preamble[4]);
Mike Melanson's avatar
Mike Melanson committed
218

219
        if (((magic == FLIC_CHUNK_MAGIC_1) || (magic == FLIC_CHUNK_MAGIC_2)) && size > FLIC_PREAMBLE_SIZE) {
Mike Melanson's avatar
Mike Melanson committed
220
            if (av_new_packet(pkt, size)) {
221
                ret = AVERROR(EIO);
Mike Melanson's avatar
Mike Melanson committed
222 223 224
                break;
            }
            pkt->stream_index = flic->video_stream_index;
Mike Melanson's avatar
Mike Melanson committed
225
            pkt->pts = flic->frame_number++;
226
            pkt->pos = avio_tell(pb);
Mike Melanson's avatar
Mike Melanson committed
227
            memcpy(pkt->data, preamble, FLIC_PREAMBLE_SIZE);
228
            ret = avio_read(pb, pkt->data + FLIC_PREAMBLE_SIZE,
Mike Melanson's avatar
Mike Melanson committed
229 230 231
                size - FLIC_PREAMBLE_SIZE);
            if (ret != size - FLIC_PREAMBLE_SIZE) {
                av_free_packet(pkt);
232
                ret = AVERROR(EIO);
Mike Melanson's avatar
Mike Melanson committed
233
            }
234 235 236 237 238 239 240 241
            packet_read = 1;
        } else if (magic == FLIC_TFTD_CHUNK_AUDIO) {
            if (av_new_packet(pkt, size)) {
                ret = AVERROR(EIO);
                break;
            }

            /* skip useless 10B sub-header (yes, it's not accounted for in the chunk header) */
242
            avio_skip(pb, 10);
243 244

            pkt->stream_index = flic->audio_stream_index;
245
            pkt->pos = avio_tell(pb);
246
            ret = avio_read(pb, pkt->data, size);
247 248 249 250 251 252

            if (ret != size) {
                av_free_packet(pkt);
                ret = AVERROR(EIO);
            }

Mike Melanson's avatar
Mike Melanson committed
253 254 255
            packet_read = 1;
        } else {
            /* not interested in this chunk */
256
            avio_skip(pb, size - 6);
Mike Melanson's avatar
Mike Melanson committed
257 258 259 260 261 262
        }
    }

    return ret;
}

263
AVInputFormat ff_flic_demuxer = {
Mike Melanson's avatar
Mike Melanson committed
264
    "flic",
265
    NULL_IF_CONFIG_SMALL("FLI/FLC/FLX animation format"),
Mike Melanson's avatar
Mike Melanson committed
266 267 268 269 270
    sizeof(FlicDemuxContext),
    flic_probe,
    flic_read_header,
    flic_read_packet,
};