Rename variables
[ffmpeg.git] / libavcodec / ra144.c
1 /*
2  * Real Audio 1.0 (14.4K)
3  * Copyright (c) 2003 the ffmpeg project
4  *
5  * This file is part of FFmpeg.
6  *
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.
11  *
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.
16  *
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
20  */
21
22 #include "avcodec.h"
23 #include "bitstream.h"
24 #include "ra144.h"
25
26 #define NBLOCKS         4       /* number of segments within a block */
27 #define BLOCKSIZE       40      /* (quarter) block size in 16-bit words (80 bytes) */
28 #define HALFBLOCK       20      /* BLOCKSIZE/2 */
29 #define BUFFERSIZE      146     /* for do_output */
30
31
32 /* internal globals */
33 typedef struct {
34     unsigned int     old_energy;        ///< previous frame energy
35
36     /* the swapped buffers */
37     unsigned int     lpc_tables[4][10];
38     unsigned int    *lpc_refl;          ///< LPC reflection coefficients
39     unsigned int    *lpc_coef;          ///< LPC coefficients
40     unsigned int    *lpc_refl_old;      ///< previous frame LPC reflection coefs
41     unsigned int    *lpc_coef_old;      ///< previous frame LPC coefficients
42
43     unsigned int buffer[5];
44     uint16_t adapt_cb[148];             ///< adaptive codebook
45 } RA144Context;
46
47 static int ra144_decode_init(AVCodecContext * avctx)
48 {
49     RA144Context *ractx = avctx->priv_data;
50
51     ractx->lpc_refl     = ractx->lpc_tables[0];
52     ractx->lpc_coef     = ractx->lpc_tables[1];
53     ractx->lpc_refl_old = ractx->lpc_tables[2];
54     ractx->lpc_coef_old = ractx->lpc_tables[3];
55
56     return 0;
57 }
58
59 /**
60  * Evaluate sqrt(x << 24). x must fit in 20 bits. This value is evaluated in an
61  * odd way to make the output identical to the binary decoder.
62  */
63 static int t_sqrt(unsigned int x)
64 {
65     int s = 0;
66     while (x > 0xfff) {
67         s++;
68         x = x >> 2;
69     }
70
71     return (ff_sqrt(x << 20) << s) << 2;
72 }
73
74 /**
75  * Evaluate the LPC filter coefficients from the reflection coefficients.
76  * Does the inverse of the eq() function.
77  */
78 static void do_voice(const int *refl, int *coefs)
79 {
80     int buffer[10];
81     int *b1 = buffer;
82     int *b2 = coefs;
83     int x, y;
84
85     for (x=0; x < 10; x++) {
86         b1[x] = refl[x] << 4;
87
88         for (y=0; y < x; y++)
89             b1[y] = ((refl[x] * b2[x-y-1]) >> 12) + b2[y];
90
91         FFSWAP(int *, b1, b2);
92     }
93
94     for (x=0; x < 10; x++)
95         coefs[x] >>= 4;
96 }
97
98 /* rotate block */
99 static void rotate_block(const int16_t *source, int16_t *target, int offset)
100 {
101     int i=0, k=0;
102     source += BUFFERSIZE - offset;
103
104     while (i<BLOCKSIZE) {
105         target[i++] = source[k++];
106
107         if (k == offset)
108             k = 0;
109     }
110 }
111
112 /* inverse root mean square */
113 static int irms(const int16_t *data, int factor)
114 {
115     unsigned int i, sum = 0;
116
117     for (i=0; i < BLOCKSIZE; i++)
118         sum += data[i] * data[i];
119
120     if (sum == 0)
121         return 0; /* OOPS - division by zero */
122
123     return (0x20000000 / (t_sqrt(sum) >> 8)) * factor;
124 }
125
126 /* multiply/add wavetable */
127 static void add_wav(int n, int skip_first, int *m, const int16_t *s1,
128                     const int8_t *s2, const int8_t *s3, int16_t *dest)
129 {
130     int i;
131     int v[3];
132
133     v[0] = 0;
134     for (i=!skip_first; i<3; i++)
135         v[i] = (wavtable1[n][i] * m[i]) >> (wavtable2[n][i] + 1);
136
137     for (i=0; i < BLOCKSIZE; i++)
138         dest[i] = ((*(s1++))*v[0] + (*(s2++))*v[1] + (*(s3++))*v[2]) >> 12;
139 }
140
141
142 static void final(const int16_t *i1, const int16_t *i2,
143                   void *out, int *statbuf, int len)
144 {
145     int x, i;
146     uint16_t work[50];
147     int16_t *ptr = work;
148
149     memcpy(work, statbuf,20);
150     memcpy(work + 10, i2, len * 2);
151
152     for (i=0; i<len; i++) {
153         int sum = 0;
154         int new_val;
155
156         for(x=0; x<10; x++)
157             sum += i1[9-x] * ptr[x];
158
159         sum >>= 12;
160
161         new_val = ptr[10] - sum;
162
163         if (new_val < -32768 || new_val > 32767) {
164             memset(out, 0, len * 2);
165             memset(statbuf, 0, 20);
166             return;
167         }
168
169         ptr[10] = new_val;
170         ptr++;
171     }
172
173     memcpy(out, work+10, len * 2);
174     memcpy(statbuf, work + 40, 20);
175 }
176
177 static unsigned int rms(const int *data, int f)
178 {
179     int x;
180     unsigned int res = 0x10000;
181     int b = 0;
182
183     for (x=0; x<10; x++) {
184         res = (((0x1000000 - (*data) * (*data)) >> 12) * res) >> 12;
185
186         if (res == 0)
187             return 0;
188
189         if (res > 0x10000)
190             return 0; /* We're screwed, might as well go out with a bang. :P */
191
192         while (res <= 0x3fff) {
193             b++;
194             res <<= 2;
195         }
196         data++;
197     }
198
199     if (res > 0)
200         res = t_sqrt(res);
201
202     res >>= (b + 10);
203     res = (res * f) >> 10;
204     return res;
205 }
206
207 /* do quarter-block output */
208 static void do_output_subblock(RA144Context *ractx,
209                                const uint16_t  *gsp, unsigned int gval,
210                                int16_t *output_buffer, GetBitContext *gb)
211 {
212     uint16_t buffer_a[40];
213     uint16_t *block;
214     int cba_idx = get_bits(gb, 7); // index of the adaptive CB, 0 if none
215     int gain    = get_bits(gb, 8);
216     int cb1_idx = get_bits(gb, 7);
217     int cb2_idx = get_bits(gb, 7);
218     int m[3];
219
220     if (cba_idx) {
221         cba_idx += HALFBLOCK - 1;
222         rotate_block(ractx->adapt_cb, buffer_a, cba_idx);
223         m[0] = irms(buffer_a, gval) >> 12;
224     } else {
225         m[0] = 0;
226     }
227
228     m[1] = ((ftable1[cb1_idx] >> 4) * gval) >> 8;
229     m[2] = ((ftable2[cb2_idx] >> 4) * gval) >> 8;
230
231     memmove(ractx->adapt_cb, ractx->adapt_cb + BLOCKSIZE,
232             (BUFFERSIZE - BLOCKSIZE) * 2);
233
234     block = ractx->adapt_cb + BUFFERSIZE - BLOCKSIZE;
235
236     add_wav(gain, cba_idx, m, buffer_a, etable1[cb1_idx], etable2[cb2_idx],
237             block);
238
239     final(gsp, block, output_buffer, ractx->buffer, BLOCKSIZE);
240 }
241
242 static int dec1(int16_t *decsp, const int *data, const int *inp, int f)
243 {
244     int i;
245
246     for (i=0; i<30; i++)
247         *(decsp++) = *(inp++);
248
249     return rms(data, f);
250 }
251
252 /**
253  * Evaluate the reflection coefficients from the filter coefficients.
254  * Does the inverse of the do_voice() function.
255  *
256  * @return 1 if one of the reflection coefficients is of magnitude greater than
257  *         4095, 0 if not.
258  */
259 static int eq(const int16_t *coefs, int *refl)
260 {
261     int retval = 0;
262     int b, c, i;
263     unsigned int u;
264     int buffer1[10];
265     int buffer2[10];
266     int *bp1 = buffer1;
267     int *bp2 = buffer2;
268
269     for (i=0; i < 10; i++)
270         buffer2[i] = coefs[i];
271
272     u = refl[9] = bp2[9];
273
274     if (u + 0x1000 > 0x1fff)
275         return 0; /* We're screwed, might as well go out with a bang. :P */
276
277     for (c=8; c >= 0; c--) {
278         if (u == 0x1000)
279             u++;
280
281         if (u == 0xfffff000)
282             u--;
283
284         b = 0x1000-((u * u) >> 12);
285
286         if (b == 0)
287             b++;
288
289         for (u=0; u<=c; u++)
290             bp1[u] = ((bp2[u] - ((refl[c+1] * bp2[c-u]) >> 12)) * (0x1000000 / b)) >> 12;
291
292         refl[c] = u = bp1[c];
293
294         if ((u + 0x1000) > 0x1fff)
295             retval = 1;
296
297         FFSWAP(int *, bp1, bp2);
298     }
299     return retval;
300 }
301
302 static int dec2(RA144Context *ractx, int16_t *decsp, int block_num,
303                 int copynew, int f)
304 {
305     int work[10];
306     int a = block_num + 1;
307     int b = NBLOCKS - a;
308     int x;
309
310     // Interpolate block coefficients from the this frame forth block and
311     // last frame forth block
312     for (x=0; x<30; x++)
313         decsp[x] = (a * ractx->lpc_coef[x] + b * ractx->lpc_coef_old[x])>> 2;
314
315     if (eq(decsp, work)) {
316         // The interpolated coefficients are unstable, copy either new or old
317         // coefficients
318         if (copynew)
319             return dec1(decsp, ractx->lpc_refl, ractx->lpc_coef, f);
320         else
321             return dec1(decsp, ractx->lpc_refl_old, ractx->lpc_coef_old, f);
322     } else {
323         return rms(work, f);
324     }
325 }
326
327 /* Uncompress one block (20 bytes -> 160*2 bytes) */
328 static int ra144_decode_frame(AVCodecContext * avctx,
329                               void *vdata, int *data_size,
330                               const uint8_t * buf, int buf_size)
331 {
332     static const uint8_t sizes[10] = {6, 5, 5, 4, 4, 3, 3, 3, 3, 2};
333     unsigned int refl_rms[4];  // RMS of the reflection coefficients
334     uint16_t gbuf2[4][30];
335     int i, c;
336     int16_t *data = vdata;
337     unsigned int energy;
338
339     RA144Context *ractx = avctx->priv_data;
340     GetBitContext gb;
341
342     if(buf_size < 20) {
343         av_log(avctx, AV_LOG_ERROR,
344                "Frame too small (%d bytes). Truncated file?\n", buf_size);
345         return buf_size;
346     }
347     init_get_bits(&gb, buf, 20 * 8);
348
349     for (i=0; i<10; i++)
350         // "<< 1"? Doesn't this make one value out of two of the table useless?
351         ractx->lpc_refl[i] = decodetable[i][get_bits(&gb, sizes[i]) << 1];
352
353     do_voice(ractx->lpc_refl, ractx->lpc_coef);
354
355     energy = decodeval[get_bits(&gb, 5) << 1]; // Useless table entries?
356
357     refl_rms[0] = dec2(ractx, gbuf2[0], 0, 0, ractx->old_energy);
358     refl_rms[1] = dec2(ractx, gbuf2[1], 1, energy > ractx->old_energy,
359                     t_sqrt(energy*ractx->old_energy) >> 12);
360     refl_rms[2] = dec2(ractx, gbuf2[2], 2, 1, energy);
361     refl_rms[3] = dec1(gbuf2[3], ractx->lpc_refl, ractx->lpc_coef, energy);
362
363     /* do output */
364     for (c=0; c<4; c++) {
365         do_output_subblock(ractx, gbuf2[c], refl_rms[c], data, &gb);
366
367         for (i=0; i<BLOCKSIZE; i++) {
368             *data = av_clip_int16(*data << 2);
369             data++;
370         }
371     }
372
373     ractx->old_energy = energy;
374
375     FFSWAP(unsigned int *, ractx->lpc_refl_old, ractx->lpc_refl);
376     FFSWAP(unsigned int *, ractx->lpc_coef_old, ractx->lpc_coef);
377
378     *data_size = 2*160;
379     return 20;
380 }
381
382
383 AVCodec ra_144_decoder =
384 {
385     "real_144",
386     CODEC_TYPE_AUDIO,
387     CODEC_ID_RA_144,
388     sizeof(RA144Context),
389     ra144_decode_init,
390     NULL,
391     NULL,
392     ra144_decode_frame,
393     .long_name = "RealAudio 1.0 (14.4K)",
394 };