binkaudio.c 11 KB
Newer Older
Peter Ross's avatar
Peter Ross committed
1 2
/*
 * Bink Audio decoder
3
 * Copyright (c) 2007-2011 Peter Ross (pross@xvid.org)
Peter Ross's avatar
Peter Ross committed
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
 * Copyright (c) 2009 Daniel Verkamp (daniel@drv.nu)
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * 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
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

/**
24
 * @file
Peter Ross's avatar
Peter Ross committed
25 26 27 28 29 30
 * Bink Audio decoder
 *
 * Technical details here:
 *  http://wiki.multimedia.cx/index.php?title=Bink_Audio
 */

31
#include "libavutil/channel_layout.h"
Peter Ross's avatar
Peter Ross committed
32
#include "avcodec.h"
33
#define BITSTREAM_READER_LE
Peter Ross's avatar
Peter Ross committed
34
#include "get_bits.h"
35 36
#include "dct.h"
#include "rdft.h"
37
#include "fmtconvert.h"
38
#include "internal.h"
39
#include "wma.h"
40
#include "libavutil/intfloat.h"
41

42
static float quant_table[96];
43

Peter Ross's avatar
Peter Ross committed
44 45 46 47 48
#define MAX_CHANNELS 2
#define BINK_BLOCK_MAX_SIZE (MAX_CHANNELS << 11)

typedef struct {
    GetBitContext gb;
49
    int version_b;          ///< Bink version 'b'
Peter Ross's avatar
Peter Ross committed
50 51 52 53 54 55 56 57
    int first;
    int channels;
    int frame_len;          ///< transform size (samples)
    int overlap_len;        ///< overlap size (samples)
    int block_size;
    int num_bands;
    unsigned int *bands;
    float root;
58
    DECLARE_ALIGNED(32, FFTSample, coeffs)[BINK_BLOCK_MAX_SIZE];
59
    float previous[MAX_CHANNELS][BINK_BLOCK_MAX_SIZE / 16];  ///< coeffs from previous audio block
60
    uint8_t *packet_buffer;
Peter Ross's avatar
Peter Ross committed
61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84
    union {
        RDFTContext rdft;
        DCTContext dct;
    } trans;
} BinkAudioContext;


static av_cold int decode_init(AVCodecContext *avctx)
{
    BinkAudioContext *s = avctx->priv_data;
    int sample_rate = avctx->sample_rate;
    int sample_rate_half;
    int i;
    int frame_len_bits;

    /* determine frame length */
    if (avctx->sample_rate < 22050) {
        frame_len_bits = 9;
    } else if (avctx->sample_rate < 44100) {
        frame_len_bits = 10;
    } else {
        frame_len_bits = 11;
    }

85 86 87
    if (avctx->channels < 1 || avctx->channels > MAX_CHANNELS) {
        av_log(avctx, AV_LOG_ERROR, "invalid number of channels: %d\n", avctx->channels);
        return AVERROR_INVALIDDATA;
Peter Ross's avatar
Peter Ross committed
88
    }
89 90
    avctx->channel_layout = avctx->channels == 1 ? AV_CH_LAYOUT_MONO :
                                                   AV_CH_LAYOUT_STEREO;
Peter Ross's avatar
Peter Ross committed
91

92
    s->version_b = avctx->extradata_size >= 4 && avctx->extradata[3] == 'b';
93

94
    if (avctx->codec->id == AV_CODEC_ID_BINKAUDIO_RDFT) {
Peter Ross's avatar
Peter Ross committed
95
        // audio is already interleaved for the RDFT format variant
96
        avctx->sample_fmt = AV_SAMPLE_FMT_FLT;
Peter Ross's avatar
Peter Ross committed
97 98
        sample_rate  *= avctx->channels;
        s->channels = 1;
99 100
        if (!s->version_b)
            frame_len_bits += av_log2(avctx->channels);
Peter Ross's avatar
Peter Ross committed
101 102
    } else {
        s->channels = avctx->channels;
103
        avctx->sample_fmt = AV_SAMPLE_FMT_FLTP;
Peter Ross's avatar
Peter Ross committed
104 105
    }

106
    s->frame_len     = 1 << frame_len_bits;
Peter Ross's avatar
Peter Ross committed
107 108 109
    s->overlap_len   = s->frame_len / 16;
    s->block_size    = (s->frame_len - s->overlap_len) * s->channels;
    sample_rate_half = (sample_rate + 1) / 2;
110
    if (avctx->codec->id == AV_CODEC_ID_BINKAUDIO_RDFT)
111
        s->root = 2.0 / (sqrt(s->frame_len) * 32768.0);
112
    else
113
        s->root = s->frame_len / (sqrt(s->frame_len) * 32768.0);
114
    for (i = 0; i < 96; i++) {
115 116 117
        /* constant is result of 0.066399999/log10(M_E) */
        quant_table[i] = expf(i * 0.15289164787221953823f) * s->root;
    }
Peter Ross's avatar
Peter Ross committed
118 119 120 121 122 123 124 125 126 127 128

    /* calculate number of bands */
    for (s->num_bands = 1; s->num_bands < 25; s->num_bands++)
        if (sample_rate_half <= ff_wma_critical_freqs[s->num_bands - 1])
            break;

    s->bands = av_malloc((s->num_bands + 1) * sizeof(*s->bands));
    if (!s->bands)
        return AVERROR(ENOMEM);

    /* populate bands data */
129
    s->bands[0] = 2;
Peter Ross's avatar
Peter Ross committed
130
    for (i = 1; i < s->num_bands; i++)
131 132
        s->bands[i] = (ff_wma_critical_freqs[i - 1] * s->frame_len / sample_rate_half) & ~1;
    s->bands[s->num_bands] = s->frame_len;
Peter Ross's avatar
Peter Ross committed
133 134 135

    s->first = 1;

136
    if (CONFIG_BINKAUDIO_RDFT_DECODER && avctx->codec->id == AV_CODEC_ID_BINKAUDIO_RDFT)
137
        ff_rdft_init(&s->trans.rdft, frame_len_bits, DFT_C2R);
138
    else if (CONFIG_BINKAUDIO_DCT_DECODER)
139
        ff_dct_init(&s->trans.dct, frame_len_bits, DCT_III);
140 141
    else
        return -1;
Peter Ross's avatar
Peter Ross committed
142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161

    return 0;
}

static float get_float(GetBitContext *gb)
{
    int power = get_bits(gb, 5);
    float f = ldexpf(get_bits_long(gb, 23), power - 23);
    if (get_bits1(gb))
        f = -f;
    return f;
}

static const uint8_t rle_length_tab[16] = {
    2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 32, 64
};

/**
 * Decode Bink Audio block
 * @param[out] out Output buffer (must contain s->block_size elements)
162
 * @return 0 on success, negative error code on failure
Peter Ross's avatar
Peter Ross committed
163
 */
164
static int decode_block(BinkAudioContext *s, float **out, int use_dct)
Peter Ross's avatar
Peter Ross committed
165 166 167 168 169 170 171 172 173 174
{
    int ch, i, j, k;
    float q, quant[25];
    int width, coeff;
    GetBitContext *gb = &s->gb;

    if (use_dct)
        skip_bits(gb, 2);

    for (ch = 0; ch < s->channels; ch++) {
175 176
        FFTSample *coeffs = out[ch];

177
        if (s->version_b) {
178 179
            if (get_bits_left(gb) < 64)
                return AVERROR_INVALIDDATA;
180 181
            coeffs[0] = av_int2float(get_bits_long(gb, 32)) * s->root;
            coeffs[1] = av_int2float(get_bits_long(gb, 32)) * s->root;
182
        } else {
183 184
            if (get_bits_left(gb) < 58)
                return AVERROR_INVALIDDATA;
185 186 187
            coeffs[0] = get_float(gb) * s->root;
            coeffs[1] = get_float(gb) * s->root;
        }
Peter Ross's avatar
Peter Ross committed
188

189 190
        if (get_bits_left(gb) < s->num_bands * 8)
            return AVERROR_INVALIDDATA;
Peter Ross's avatar
Peter Ross committed
191 192
        for (i = 0; i < s->num_bands; i++) {
            int value = get_bits(gb, 8);
193
            quant[i]  = quant_table[FFMIN(value, 95)];
Peter Ross's avatar
Peter Ross committed
194 195
        }

196 197
        k = 0;
        q = quant[0];
Peter Ross's avatar
Peter Ross committed
198 199 200 201

        // parse coefficients
        i = 2;
        while (i < s->frame_len) {
202 203
            if (s->version_b) {
                j = i + 16;
Peter Ross's avatar
Peter Ross committed
204
            } else {
205
                int v = get_bits1(gb);
206
                if (v) {
207
                    v = get_bits(gb, 4);
208 209 210 211
                    j = i + rle_length_tab[v] * 8;
                } else {
                    j = i + 8;
                }
Peter Ross's avatar
Peter Ross committed
212 213 214 215
            }

            j = FFMIN(j, s->frame_len);

216
            width = get_bits(gb, 4);
Peter Ross's avatar
Peter Ross committed
217 218 219
            if (width == 0) {
                memset(coeffs + i, 0, (j - i) * sizeof(*coeffs));
                i = j;
220
                while (s->bands[k] < i)
Peter Ross's avatar
Peter Ross committed
221 222 223
                    q = quant[k++];
            } else {
                while (i < j) {
224
                    if (s->bands[k] == i)
Peter Ross's avatar
Peter Ross committed
225
                        q = quant[k++];
226
                    coeff = get_bits(gb, width);
Peter Ross's avatar
Peter Ross committed
227
                    if (coeff) {
228
                        int v;
229
                        v = get_bits1(gb);
230
                        if (v)
Peter Ross's avatar
Peter Ross committed
231 232 233 234 235 236 237 238 239 240 241
                            coeffs[i] = -q * coeff;
                        else
                            coeffs[i] =  q * coeff;
                    } else {
                        coeffs[i] = 0.0f;
                    }
                    i++;
                }
            }
        }

242 243
        if (CONFIG_BINKAUDIO_DCT_DECODER && use_dct) {
            coeffs[0] /= 0.5;
244
            s->trans.dct.dct_calc(&s->trans.dct,  coeffs);
245
        }
246
        else if (CONFIG_BINKAUDIO_RDFT_DECODER)
247
            s->trans.rdft.rdft_calc(&s->trans.rdft, coeffs);
Peter Ross's avatar
Peter Ross committed
248 249
    }

250 251
    for (ch = 0; ch < s->channels; ch++) {
        int j;
Peter Ross's avatar
Peter Ross committed
252
        int count = s->overlap_len * s->channels;
253 254 255 256 257
        if (!s->first) {
            j = ch;
            for (i = 0; i < s->overlap_len; i++, j += s->channels)
                out[ch][i] = (s->previous[ch][i] * (count - j) +
                                      out[ch][i] *          j) / count;
Peter Ross's avatar
Peter Ross committed
258
        }
259 260
        memcpy(s->previous[ch], &out[ch][s->frame_len - s->overlap_len],
               s->overlap_len * sizeof(*s->previous[ch]));
Peter Ross's avatar
Peter Ross committed
261 262 263
    }

    s->first = 0;
264 265

    return 0;
Peter Ross's avatar
Peter Ross committed
266 267 268 269 270 271
}

static av_cold int decode_end(AVCodecContext *avctx)
{
    BinkAudioContext * s = avctx->priv_data;
    av_freep(&s->bands);
272
    av_freep(&s->packet_buffer);
273
    if (CONFIG_BINKAUDIO_RDFT_DECODER && avctx->codec->id == AV_CODEC_ID_BINKAUDIO_RDFT)
Peter Ross's avatar
Peter Ross committed
274
        ff_rdft_end(&s->trans.rdft);
275
    else if (CONFIG_BINKAUDIO_DCT_DECODER)
Peter Ross's avatar
Peter Ross committed
276
        ff_dct_end(&s->trans.dct);
277

Peter Ross's avatar
Peter Ross committed
278 279 280 281 282 283 284 285 286
    return 0;
}

static void get_bits_align32(GetBitContext *s)
{
    int n = (-get_bits_count(s)) & 31;
    if (n) skip_bits(s, n);
}

287 288
static int decode_frame(AVCodecContext *avctx, void *data,
                        int *got_frame_ptr, AVPacket *avpkt)
Peter Ross's avatar
Peter Ross committed
289 290
{
    BinkAudioContext *s = avctx->priv_data;
291
    AVFrame *frame      = data;
Peter Ross's avatar
Peter Ross committed
292
    GetBitContext *gb = &s->gb;
293
    int ret, consumed = 0;
294 295 296 297 298

    if (!get_bits_left(gb)) {
        uint8_t *buf;
        /* handle end-of-stream */
        if (!avpkt->size) {
299
            *got_frame_ptr = 0;
300 301 302 303 304 305 306 307 308
            return 0;
        }
        if (avpkt->size < 4) {
            av_log(avctx, AV_LOG_ERROR, "Packet is too small\n");
            return AVERROR_INVALIDDATA;
        }
        buf = av_realloc(s->packet_buffer, avpkt->size + FF_INPUT_BUFFER_PADDING_SIZE);
        if (!buf)
            return AVERROR(ENOMEM);
309
        memset(buf + avpkt->size, 0, FF_INPUT_BUFFER_PADDING_SIZE);
310 311
        s->packet_buffer = buf;
        memcpy(s->packet_buffer, avpkt->data, avpkt->size);
312 313
        if ((ret = init_get_bits8(gb, s->packet_buffer, avpkt->size)) < 0)
            return ret;
314 315 316 317
        consumed = avpkt->size;

        /* skip reported size */
        skip_bits_long(gb, 32);
318
    }
Peter Ross's avatar
Peter Ross committed
319

320
    /* get output buffer */
321
    frame->nb_samples = s->frame_len;
322
    if ((ret = ff_get_buffer(avctx, frame, 0)) < 0)
323
        return ret;
Peter Ross's avatar
Peter Ross committed
324

325
    if (decode_block(s, (float **)frame->extended_data,
326
                     avctx->codec->id == AV_CODEC_ID_BINKAUDIO_DCT)) {
327 328
        av_log(avctx, AV_LOG_ERROR, "Incomplete packet\n");
        return AVERROR_INVALIDDATA;
Peter Ross's avatar
Peter Ross committed
329
    }
330
    get_bits_align32(gb);
Peter Ross's avatar
Peter Ross committed
331

332 333
    frame->nb_samples = s->block_size / avctx->channels;
    *got_frame_ptr    = 1;
334

335
    return consumed;
Peter Ross's avatar
Peter Ross committed
336 337
}

338
AVCodec ff_binkaudio_rdft_decoder = {
339
    .name           = "binkaudio_rdft",
340
    .long_name      = NULL_IF_CONFIG_SMALL("Bink Audio (RDFT)"),
341
    .type           = AVMEDIA_TYPE_AUDIO,
342
    .id             = AV_CODEC_ID_BINKAUDIO_RDFT,
343 344 345 346
    .priv_data_size = sizeof(BinkAudioContext),
    .init           = decode_init,
    .close          = decode_end,
    .decode         = decode_frame,
347
    .capabilities   = CODEC_CAP_DELAY | CODEC_CAP_DR1,
Peter Ross's avatar
Peter Ross committed
348 349
};

350
AVCodec ff_binkaudio_dct_decoder = {
351
    .name           = "binkaudio_dct",
352
    .long_name      = NULL_IF_CONFIG_SMALL("Bink Audio (DCT)"),
353
    .type           = AVMEDIA_TYPE_AUDIO,
354
    .id             = AV_CODEC_ID_BINKAUDIO_DCT,
355 356 357 358
    .priv_data_size = sizeof(BinkAudioContext),
    .init           = decode_init,
    .close          = decode_end,
    .decode         = decode_frame,
359
    .capabilities   = CODEC_CAP_DELAY | CODEC_CAP_DR1,
Peter Ross's avatar
Peter Ross committed
360
};