annotate ffmpeg/libavcodec/evrcdec.c @ 13:844d341cf643 tip

Back up before ISMIR
author Yading Song <yading.song@eecs.qmul.ac.uk>
date Thu, 31 Oct 2013 13:17:06 +0000
parents 6840f77b83aa
children
rev   line source
yading@10 1 /*
yading@10 2 * Enhanced Variable Rate Codec, Service Option 3 decoder
yading@10 3 * Copyright (c) 2013 Paul B Mahol
yading@10 4 *
yading@10 5 * This file is part of FFmpeg.
yading@10 6 *
yading@10 7 * FFmpeg is free software; you can redistribute it and/or
yading@10 8 * modify it under the terms of the GNU Lesser General Public
yading@10 9 * License as published by the Free Software Foundation; either
yading@10 10 * version 2.1 of the License, or (at your option) any later version.
yading@10 11 *
yading@10 12 * FFmpeg is distributed in the hope that it will be useful,
yading@10 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
yading@10 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
yading@10 15 * Lesser General Public License for more details.
yading@10 16 *
yading@10 17 * You should have received a copy of the GNU Lesser General Public
yading@10 18 * License along with FFmpeg; if not, write to the Free Software
yading@10 19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
yading@10 20 */
yading@10 21
yading@10 22 /**
yading@10 23 * @file
yading@10 24 * Enhanced Variable Rate Codec, Service Option 3 decoder
yading@10 25 * @author Paul B Mahol
yading@10 26 */
yading@10 27
yading@10 28 #include "libavutil/mathematics.h"
yading@10 29 #include "avcodec.h"
yading@10 30 #include "internal.h"
yading@10 31 #include "get_bits.h"
yading@10 32 #include "evrcdata.h"
yading@10 33 #include "acelp_vectors.h"
yading@10 34 #include "lsp.h"
yading@10 35
yading@10 36 #define MIN_LSP_SEP (0.05 / (2.0 * M_PI))
yading@10 37 #define MIN_DELAY 20
yading@10 38 #define MAX_DELAY 120
yading@10 39 #define NB_SUBFRAMES 3
yading@10 40 #define SUBFRAME_SIZE 54
yading@10 41 #define FILTER_ORDER 10
yading@10 42 #define ACB_SIZE 128
yading@10 43
yading@10 44 typedef enum {
yading@10 45 RATE_ERRS = -1,
yading@10 46 SILENCE,
yading@10 47 RATE_QUANT,
yading@10 48 RATE_QUARTER,
yading@10 49 RATE_HALF,
yading@10 50 RATE_FULL,
yading@10 51 } evrc_packet_rate;
yading@10 52
yading@10 53 /**
yading@10 54 * EVRC-A unpacked data frame
yading@10 55 */
yading@10 56 typedef struct EVRCAFrame {
yading@10 57 uint8_t lpc_flag; ///< spectral change indicator
yading@10 58 uint16_t lsp[4]; ///< index into LSP codebook
yading@10 59 uint8_t pitch_delay; ///< pitch delay for entire frame
yading@10 60 uint8_t delay_diff; ///< delay difference for entire frame
yading@10 61 uint8_t acb_gain[3]; ///< adaptive codebook gain
yading@10 62 uint16_t fcb_shape[3][4]; ///< fixed codebook shape
yading@10 63 uint8_t fcb_gain[3]; ///< fixed codebook gain index
yading@10 64 uint8_t energy_gain; ///< frame energy gain index
yading@10 65 uint8_t tty; ///< tty baud rate bit
yading@10 66 } EVRCAFrame;
yading@10 67
yading@10 68 typedef struct EVRCContext {
yading@10 69 GetBitContext gb;
yading@10 70 evrc_packet_rate bitrate;
yading@10 71 evrc_packet_rate last_valid_bitrate;
yading@10 72 EVRCAFrame frame;
yading@10 73
yading@10 74 float lspf[FILTER_ORDER];
yading@10 75 float prev_lspf[FILTER_ORDER];
yading@10 76 float synthesis[FILTER_ORDER];
yading@10 77 float postfilter_fir[FILTER_ORDER];
yading@10 78 float postfilter_iir[FILTER_ORDER];
yading@10 79 float postfilter_residual[ACB_SIZE + SUBFRAME_SIZE];
yading@10 80 float pitch_delay;
yading@10 81 float prev_pitch_delay;
yading@10 82 float avg_acb_gain; ///< average adaptive codebook gain
yading@10 83 float avg_fcb_gain; ///< average fixed codebook gain
yading@10 84 float pitch[ACB_SIZE + FILTER_ORDER + SUBFRAME_SIZE];
yading@10 85 float pitch_back[ACB_SIZE];
yading@10 86 float interpolation_coeffs[136];
yading@10 87 float energy_vector[NB_SUBFRAMES];
yading@10 88 float fade_scale;
yading@10 89 float last;
yading@10 90
yading@10 91 uint8_t prev_energy_gain;
yading@10 92 uint8_t prev_error_flag;
yading@10 93 uint8_t warned_buf_mismatch_bitrate;
yading@10 94 } EVRCContext;
yading@10 95
yading@10 96 /**
yading@10 97 * Frame unpacking for RATE_FULL, RATE_HALF and RATE_QUANT
yading@10 98 *
yading@10 99 * @param e the context
yading@10 100 *
yading@10 101 * TIA/IS-127 Table 4.21-1
yading@10 102 */
yading@10 103 static void unpack_frame(EVRCContext *e)
yading@10 104 {
yading@10 105 EVRCAFrame *frame = &e->frame;
yading@10 106 GetBitContext *gb = &e->gb;
yading@10 107
yading@10 108 switch (e->bitrate) {
yading@10 109 case RATE_FULL:
yading@10 110 frame->lpc_flag = get_bits1(gb);
yading@10 111 frame->lsp[0] = get_bits(gb, 6);
yading@10 112 frame->lsp[1] = get_bits(gb, 6);
yading@10 113 frame->lsp[2] = get_bits(gb, 9);
yading@10 114 frame->lsp[3] = get_bits(gb, 7);
yading@10 115 frame->pitch_delay = get_bits(gb, 7);
yading@10 116 frame->delay_diff = get_bits(gb, 5);
yading@10 117 frame->acb_gain[0] = get_bits(gb, 3);
yading@10 118 frame->fcb_shape[0][0] = get_bits(gb, 8);
yading@10 119 frame->fcb_shape[0][1] = get_bits(gb, 8);
yading@10 120 frame->fcb_shape[0][2] = get_bits(gb, 8);
yading@10 121 frame->fcb_shape[0][3] = get_bits(gb, 11);
yading@10 122 frame->fcb_gain[0] = get_bits(gb, 5);
yading@10 123 frame->acb_gain[1] = get_bits(gb, 3);
yading@10 124 frame->fcb_shape[1][0] = get_bits(gb, 8);
yading@10 125 frame->fcb_shape[1][1] = get_bits(gb, 8);
yading@10 126 frame->fcb_shape[1][2] = get_bits(gb, 8);
yading@10 127 frame->fcb_shape[1][3] = get_bits(gb, 11);
yading@10 128 frame->fcb_gain [1] = get_bits(gb, 5);
yading@10 129 frame->acb_gain [2] = get_bits(gb, 3);
yading@10 130 frame->fcb_shape[2][0] = get_bits(gb, 8);
yading@10 131 frame->fcb_shape[2][1] = get_bits(gb, 8);
yading@10 132 frame->fcb_shape[2][2] = get_bits(gb, 8);
yading@10 133 frame->fcb_shape[2][3] = get_bits(gb, 11);
yading@10 134 frame->fcb_gain [2] = get_bits(gb, 5);
yading@10 135 frame->tty = get_bits1(gb);
yading@10 136 break;
yading@10 137 case RATE_HALF:
yading@10 138 frame->lsp [0] = get_bits(gb, 7);
yading@10 139 frame->lsp [1] = get_bits(gb, 7);
yading@10 140 frame->lsp [2] = get_bits(gb, 8);
yading@10 141 frame->pitch_delay = get_bits(gb, 7);
yading@10 142 frame->acb_gain [0] = get_bits(gb, 3);
yading@10 143 frame->fcb_shape[0][0] = get_bits(gb, 10);
yading@10 144 frame->fcb_gain [0] = get_bits(gb, 4);
yading@10 145 frame->acb_gain [1] = get_bits(gb, 3);
yading@10 146 frame->fcb_shape[1][0] = get_bits(gb, 10);
yading@10 147 frame->fcb_gain [1] = get_bits(gb, 4);
yading@10 148 frame->acb_gain [2] = get_bits(gb, 3);
yading@10 149 frame->fcb_shape[2][0] = get_bits(gb, 10);
yading@10 150 frame->fcb_gain [2] = get_bits(gb, 4);
yading@10 151 break;
yading@10 152 case RATE_QUANT:
yading@10 153 frame->lsp [0] = get_bits(gb, 4);
yading@10 154 frame->lsp [1] = get_bits(gb, 4);
yading@10 155 frame->energy_gain = get_bits(gb, 8);
yading@10 156 break;
yading@10 157 }
yading@10 158 }
yading@10 159
yading@10 160 static evrc_packet_rate buf_size2bitrate(const int buf_size)
yading@10 161 {
yading@10 162 switch (buf_size) {
yading@10 163 case 23: return RATE_FULL;
yading@10 164 case 11: return RATE_HALF;
yading@10 165 case 6: return RATE_QUARTER;
yading@10 166 case 3: return RATE_QUANT;
yading@10 167 case 1: return SILENCE;
yading@10 168 }
yading@10 169
yading@10 170 return RATE_ERRS;
yading@10 171 }
yading@10 172
yading@10 173 /**
yading@10 174 * Determine the bitrate from the frame size and/or the first byte of the frame.
yading@10 175 *
yading@10 176 * @param avctx the AV codec context
yading@10 177 * @param buf_size length of the buffer
yading@10 178 * @param buf the bufffer
yading@10 179 *
yading@10 180 * @return the bitrate on success,
yading@10 181 * RATE_ERRS if the bitrate cannot be satisfactorily determined
yading@10 182 */
yading@10 183 static evrc_packet_rate determine_bitrate(AVCodecContext *avctx,
yading@10 184 int *buf_size,
yading@10 185 const uint8_t **buf)
yading@10 186 {
yading@10 187 evrc_packet_rate bitrate;
yading@10 188
yading@10 189 if ((bitrate = buf_size2bitrate(*buf_size)) >= 0) {
yading@10 190 if (bitrate > **buf) {
yading@10 191 EVRCContext *e = avctx->priv_data;
yading@10 192 if (!e->warned_buf_mismatch_bitrate) {
yading@10 193 av_log(avctx, AV_LOG_WARNING,
yading@10 194 "Claimed bitrate and buffer size mismatch.\n");
yading@10 195 e->warned_buf_mismatch_bitrate = 1;
yading@10 196 }
yading@10 197 bitrate = **buf;
yading@10 198 } else if (bitrate < **buf) {
yading@10 199 av_log(avctx, AV_LOG_ERROR,
yading@10 200 "Buffer is too small for the claimed bitrate.\n");
yading@10 201 return RATE_ERRS;
yading@10 202 }
yading@10 203 (*buf)++;
yading@10 204 *buf_size -= 1;
yading@10 205 } else if ((bitrate = buf_size2bitrate(*buf_size + 1)) >= 0) {
yading@10 206 av_log(avctx, AV_LOG_DEBUG,
yading@10 207 "Bitrate byte is missing, guessing the bitrate from packet size.\n");
yading@10 208 } else
yading@10 209 return RATE_ERRS;
yading@10 210
yading@10 211 return bitrate;
yading@10 212 }
yading@10 213
yading@10 214 static void warn_insufficient_frame_quality(AVCodecContext *avctx,
yading@10 215 const char *message)
yading@10 216 {
yading@10 217 av_log(avctx, AV_LOG_WARNING, "Frame #%d, %s\n",
yading@10 218 avctx->frame_number, message);
yading@10 219 }
yading@10 220
yading@10 221 /**
yading@10 222 * Initialize the speech codec according to the specification.
yading@10 223 *
yading@10 224 * TIA/IS-127 5.2
yading@10 225 */
yading@10 226 static av_cold int evrc_decode_init(AVCodecContext *avctx)
yading@10 227 {
yading@10 228 EVRCContext *e = avctx->priv_data;
yading@10 229 int i, n, idx = 0;
yading@10 230 float denom = 2.0 / (2.0 * 8.0 + 1.0);
yading@10 231
yading@10 232 avctx->channels = 1;
yading@10 233 avctx->channel_layout = AV_CH_LAYOUT_MONO;
yading@10 234 avctx->sample_fmt = AV_SAMPLE_FMT_FLT;
yading@10 235
yading@10 236 for (i = 0; i < FILTER_ORDER; i++) {
yading@10 237 e->prev_lspf[i] = (i + 1) * 0.048;
yading@10 238 e->synthesis[i] = 0.0;
yading@10 239 }
yading@10 240
yading@10 241 for (i = 0; i < ACB_SIZE; i++)
yading@10 242 e->pitch[i] = e->pitch_back[i] = 0.0;
yading@10 243
yading@10 244 e->last_valid_bitrate = RATE_QUANT;
yading@10 245 e->prev_pitch_delay = 40.0;
yading@10 246 e->fade_scale = 1.0;
yading@10 247 e->prev_error_flag = 0;
yading@10 248 e->avg_acb_gain = e->avg_fcb_gain = 0.0;
yading@10 249
yading@10 250 for (i = 0; i < 8; i++) {
yading@10 251 float tt = ((float)i - 8.0 / 2.0) / 8.0;
yading@10 252
yading@10 253 for (n = -8; n <= 8; n++, idx++) {
yading@10 254 float arg1 = M_PI * 0.9 * (tt - n);
yading@10 255 float arg2 = M_PI * (tt - n);
yading@10 256
yading@10 257 e->interpolation_coeffs[idx] = 0.9;
yading@10 258 if (arg1)
yading@10 259 e->interpolation_coeffs[idx] *= (0.54 + 0.46 * cos(arg2 * denom)) *
yading@10 260 sin(arg1) / arg1;
yading@10 261 }
yading@10 262 }
yading@10 263
yading@10 264 return 0;
yading@10 265 }
yading@10 266
yading@10 267 /**
yading@10 268 * Decode the 10 vector quantized line spectral pair frequencies from the LSP
yading@10 269 * transmission codes of any bitrate and check for badly received packets.
yading@10 270 *
yading@10 271 * @param e the context
yading@10 272 *
yading@10 273 * @return 0 on success, -1 if the packet is badly received
yading@10 274 *
yading@10 275 * TIA/IS-127 5.2.1, 5.7.1
yading@10 276 */
yading@10 277 static int decode_lspf(EVRCContext *e)
yading@10 278 {
yading@10 279 const float **codebooks = evrc_lspq_codebooks[e->bitrate];
yading@10 280 int i, j, k = 0;
yading@10 281
yading@10 282 for (i = 0; i < evrc_lspq_nb_codebooks[e->bitrate]; i++) {
yading@10 283 int row_size = evrc_lspq_codebooks_row_sizes[e->bitrate][i];
yading@10 284 const float *codebook = codebooks[i];
yading@10 285
yading@10 286 for (j = 0; j < row_size; j++)
yading@10 287 e->lspf[k++] = codebook[e->frame.lsp[i] * row_size + j];
yading@10 288 }
yading@10 289
yading@10 290 // check for monotonic LSPs
yading@10 291 for (i = 1; i < FILTER_ORDER; i++)
yading@10 292 if (e->lspf[i] <= e->lspf[i - 1])
yading@10 293 return -1;
yading@10 294
yading@10 295 // check for minimum separation of LSPs at the splits
yading@10 296 for (i = 0, k = 0; i < evrc_lspq_nb_codebooks[e->bitrate] - 1; i++) {
yading@10 297 k += evrc_lspq_codebooks_row_sizes[e->bitrate][i];
yading@10 298 if (e->lspf[k] - e->lspf[k - 1] <= MIN_LSP_SEP)
yading@10 299 return -1;
yading@10 300 }
yading@10 301
yading@10 302 return 0;
yading@10 303 }
yading@10 304
yading@10 305 /*
yading@10 306 * Interpolation of LSP parameters.
yading@10 307 *
yading@10 308 * TIA/IS-127 5.2.3.1, 5.7.3.2
yading@10 309 */
yading@10 310 static void interpolate_lsp(float *ilsp, const float *lsp,
yading@10 311 const float *prev, int index)
yading@10 312 {
yading@10 313 static const float lsp_interpolation_factors[] = { 0.1667, 0.5, 0.8333 };
yading@10 314 ff_weighted_vector_sumf(ilsp, prev, lsp,
yading@10 315 1.0 - lsp_interpolation_factors[index],
yading@10 316 lsp_interpolation_factors[index], FILTER_ORDER);
yading@10 317 }
yading@10 318
yading@10 319 /*
yading@10 320 * Reconstruction of the delay contour.
yading@10 321 *
yading@10 322 * TIA/IS-127 5.2.2.3.2
yading@10 323 */
yading@10 324 static void interpolate_delay(float *dst, float current, float prev, int index)
yading@10 325 {
yading@10 326 static const float d_interpolation_factors[] = { 0, 0.3313, 0.6625, 1, 1 };
yading@10 327 dst[0] = (1.0 - d_interpolation_factors[index ]) * prev
yading@10 328 + d_interpolation_factors[index ] * current;
yading@10 329 dst[1] = (1.0 - d_interpolation_factors[index + 1]) * prev
yading@10 330 + d_interpolation_factors[index + 1] * current;
yading@10 331 dst[2] = (1.0 - d_interpolation_factors[index + 2]) * prev
yading@10 332 + d_interpolation_factors[index + 2] * current;
yading@10 333 }
yading@10 334
yading@10 335 /*
yading@10 336 * Convert the quantized, interpolated line spectral frequencies,
yading@10 337 * to prediction coefficients.
yading@10 338 *
yading@10 339 * TIA/IS-127 5.2.3.2, 4.7.2.2
yading@10 340 */
yading@10 341 static void decode_predictor_coeffs(const float *ilspf, float *ilpc)
yading@10 342 {
yading@10 343 double lsp[FILTER_ORDER];
yading@10 344 float a[FILTER_ORDER / 2 + 1], b[FILTER_ORDER / 2 + 1];
yading@10 345 float a1[FILTER_ORDER / 2] = { 0 };
yading@10 346 float a2[FILTER_ORDER / 2] = { 0 };
yading@10 347 float b1[FILTER_ORDER / 2] = { 0 };
yading@10 348 float b2[FILTER_ORDER / 2] = { 0 };
yading@10 349 int i, k;
yading@10 350
yading@10 351 ff_acelp_lsf2lspd(lsp, ilspf, FILTER_ORDER);
yading@10 352
yading@10 353 for (k = 0; k <= FILTER_ORDER; k++) {
yading@10 354 a[0] = k < 2 ? 0.25 : 0;
yading@10 355 b[0] = k < 2 ? k < 1 ? 0.25 : -0.25 : 0;
yading@10 356
yading@10 357 for (i = 0; i < FILTER_ORDER / 2; i++) {
yading@10 358 a[i + 1] = a[i] - 2 * lsp[i * 2 ] * a1[i] + a2[i];
yading@10 359 b[i + 1] = b[i] - 2 * lsp[i * 2 + 1] * b1[i] + b2[i];
yading@10 360 a2[i] = a1[i];
yading@10 361 a1[i] = a[i];
yading@10 362 b2[i] = b1[i];
yading@10 363 b1[i] = b[i];
yading@10 364 }
yading@10 365
yading@10 366 if (k)
yading@10 367 ilpc[k - 1] = 2.0 * (a[FILTER_ORDER / 2] + b[FILTER_ORDER / 2]);
yading@10 368 }
yading@10 369 }
yading@10 370
yading@10 371 static void bl_intrp(EVRCContext *e, float *ex, float delay)
yading@10 372 {
yading@10 373 float *f;
yading@10 374 int offset, i, coef_idx;
yading@10 375 int16_t t;
yading@10 376
yading@10 377 offset = lrintf(fabs(delay));
yading@10 378
yading@10 379 t = (offset - delay + 0.5) * 8.0 + 0.5;
yading@10 380 if (t == 8) {
yading@10 381 t = 0;
yading@10 382 offset--;
yading@10 383 }
yading@10 384
yading@10 385 f = ex - offset - 8;
yading@10 386
yading@10 387 coef_idx = t * (2 * 8 + 1);
yading@10 388
yading@10 389 ex[0] = 0.0;
yading@10 390 for (i = 0; i < 2 * 8 + 1; i++)
yading@10 391 ex[0] += e->interpolation_coeffs[coef_idx + i] * f[i];
yading@10 392 }
yading@10 393
yading@10 394 /*
yading@10 395 * Adaptive codebook excitation.
yading@10 396 *
yading@10 397 * TIA/IS-127 5.2.2.3.3, 4.12.5.2
yading@10 398 */
yading@10 399 static void acb_excitation(EVRCContext *e, float *excitation, float gain,
yading@10 400 const float delay[3], int length)
yading@10 401 {
yading@10 402 float denom, locdelay, dpr, invl;
yading@10 403 int i;
yading@10 404
yading@10 405 invl = 1.0 / ((float) length);
yading@10 406 dpr = length;
yading@10 407
yading@10 408 /* first at-most extra samples */
yading@10 409 denom = (delay[1] - delay[0]) * invl;
yading@10 410 for (i = 0; i < dpr; i++) {
yading@10 411 locdelay = delay[0] + i * denom;
yading@10 412 bl_intrp(e, excitation + i, locdelay);
yading@10 413 }
yading@10 414
yading@10 415 denom = (delay[2] - delay[1]) * invl;
yading@10 416 /* interpolation */
yading@10 417 for (i = dpr; i < dpr + 10; i++) {
yading@10 418 locdelay = delay[1] + (i - dpr) * denom;
yading@10 419 bl_intrp(e, excitation + i, locdelay);
yading@10 420 }
yading@10 421
yading@10 422 for (i = 0; i < length; i++)
yading@10 423 excitation[i] *= gain;
yading@10 424 }
yading@10 425
yading@10 426 static void decode_8_pulses_35bits(const uint16_t *fixed_index, float *cod)
yading@10 427 {
yading@10 428 int i, pos1, pos2, offset;
yading@10 429
yading@10 430 offset = (fixed_index[3] >> 9) & 3;
yading@10 431
yading@10 432 for (i = 0; i < 3; i++) {
yading@10 433 pos1 = ((fixed_index[i] & 0x7f) / 11) * 5 + ((i + offset) % 5);
yading@10 434 pos2 = ((fixed_index[i] & 0x7f) % 11) * 5 + ((i + offset) % 5);
yading@10 435
yading@10 436 cod[pos1] = (fixed_index[i] & 0x80) ? -1.0 : 1.0;
yading@10 437
yading@10 438 if (pos2 < pos1)
yading@10 439 cod[pos2] = -cod[pos1];
yading@10 440 else
yading@10 441 cod[pos2] += cod[pos1];
yading@10 442 }
yading@10 443
yading@10 444 pos1 = ((fixed_index[3] & 0x7f) / 11) * 5 + ((3 + offset) % 5);
yading@10 445 pos2 = ((fixed_index[3] & 0x7f) % 11) * 5 + ((4 + offset) % 5);
yading@10 446
yading@10 447 cod[pos1] = (fixed_index[3] & 0x100) ? -1.0 : 1.0;
yading@10 448 cod[pos2] = (fixed_index[3] & 0x80 ) ? -1.0 : 1.0;
yading@10 449 }
yading@10 450
yading@10 451 static void decode_3_pulses_10bits(uint16_t fixed_index, float *cod)
yading@10 452 {
yading@10 453 float sign;
yading@10 454 int pos;
yading@10 455
yading@10 456 sign = (fixed_index & 0x200) ? -1.0 : 1.0;
yading@10 457
yading@10 458 pos = ((fixed_index & 0x7) * 7) + 4;
yading@10 459 cod[pos] += sign;
yading@10 460 pos = (((fixed_index >> 3) & 0x7) * 7) + 2;
yading@10 461 cod[pos] -= sign;
yading@10 462 pos = (((fixed_index >> 6) & 0x7) * 7);
yading@10 463 cod[pos] += sign;
yading@10 464 }
yading@10 465
yading@10 466 /*
yading@10 467 * Reconstruction of ACELP fixed codebook excitation for full and half rate.
yading@10 468 *
yading@10 469 * TIA/IS-127 5.2.3.7
yading@10 470 */
yading@10 471 static void fcb_excitation(EVRCContext *e, const uint16_t *codebook,
yading@10 472 float *excitation, float pitch_gain,
yading@10 473 int pitch_lag, int subframe_size)
yading@10 474 {
yading@10 475 int i;
yading@10 476
yading@10 477 if (e->bitrate == RATE_FULL)
yading@10 478 decode_8_pulses_35bits(codebook, excitation);
yading@10 479 else
yading@10 480 decode_3_pulses_10bits(*codebook, excitation);
yading@10 481
yading@10 482 pitch_gain = av_clipf(pitch_gain, 0.2, 0.9);
yading@10 483
yading@10 484 for (i = pitch_lag; i < subframe_size; i++)
yading@10 485 excitation[i] += pitch_gain * excitation[i - pitch_lag];
yading@10 486 }
yading@10 487
yading@10 488 /**
yading@10 489 * Synthesis of the decoder output signal.
yading@10 490 *
yading@10 491 * param[in] in input signal
yading@10 492 * param[in] filter_coeffs LPC coefficients
yading@10 493 * param[in/out] memory synthesis filter memory
yading@10 494 * param buffer_length amount of data to process
yading@10 495 * param[out] samples output samples
yading@10 496 *
yading@10 497 * TIA/IS-127 5.2.3.15, 5.7.3.4
yading@10 498 */
yading@10 499 static void synthesis_filter(const float *in, const float *filter_coeffs,
yading@10 500 float *memory, int buffer_length, float *samples)
yading@10 501 {
yading@10 502 int i, j;
yading@10 503
yading@10 504 for (i = 0; i < buffer_length; i++) {
yading@10 505 samples[i] = in[i];
yading@10 506 for (j = FILTER_ORDER - 1; j > 0; j--) {
yading@10 507 samples[i] -= filter_coeffs[j] * memory[j];
yading@10 508 memory[j] = memory[j - 1];
yading@10 509 }
yading@10 510 samples[i] -= filter_coeffs[0] * memory[0];
yading@10 511 memory[0] = samples[i];
yading@10 512 }
yading@10 513 }
yading@10 514
yading@10 515 static void bandwidth_expansion(float *coeff, const float *inbuf, float gamma)
yading@10 516 {
yading@10 517 double fac = gamma;
yading@10 518 int i;
yading@10 519
yading@10 520 for (i = 0; i < FILTER_ORDER; i++) {
yading@10 521 coeff[i] = inbuf[i] * fac;
yading@10 522 fac *= gamma;
yading@10 523 }
yading@10 524 }
yading@10 525
yading@10 526 static void residual_filter(float *output, const float *input,
yading@10 527 const float *coef, float *memory, int length)
yading@10 528 {
yading@10 529 float sum;
yading@10 530 int i, j;
yading@10 531
yading@10 532 for (i = 0; i < length; i++) {
yading@10 533 sum = input[i];
yading@10 534
yading@10 535 for (j = FILTER_ORDER - 1; j > 0; j--) {
yading@10 536 sum += coef[j] * memory[j];
yading@10 537 memory[j] = memory[j - 1];
yading@10 538 }
yading@10 539 sum += coef[0] * memory[0];
yading@10 540 memory[0] = input[i];
yading@10 541 output[i] = sum;
yading@10 542 }
yading@10 543 }
yading@10 544
yading@10 545 /*
yading@10 546 * TIA/IS-127 Table 5.9.1-1.
yading@10 547 */
yading@10 548 static const struct PfCoeff {
yading@10 549 float tilt;
yading@10 550 float ltgain;
yading@10 551 float p1;
yading@10 552 float p2;
yading@10 553 } postfilter_coeffs[5] = {
yading@10 554 { 0.0 , 0.0 , 0.0 , 0.0 },
yading@10 555 { 0.0 , 0.0 , 0.57, 0.57 },
yading@10 556 { 0.0 , 0.0 , 0.0 , 0.0 },
yading@10 557 { 0.35, 0.50, 0.50, 0.75 },
yading@10 558 { 0.20, 0.50, 0.57, 0.75 },
yading@10 559 };
yading@10 560
yading@10 561 /*
yading@10 562 * Adaptive postfilter.
yading@10 563 *
yading@10 564 * TIA/IS-127 5.9
yading@10 565 */
yading@10 566 static void postfilter(EVRCContext *e, float *in, const float *coeff,
yading@10 567 float *out, int idx, const struct PfCoeff *pfc,
yading@10 568 int length)
yading@10 569 {
yading@10 570 float wcoef1[FILTER_ORDER], wcoef2[FILTER_ORDER],
yading@10 571 scratch[SUBFRAME_SIZE], temp[SUBFRAME_SIZE],
yading@10 572 mem[SUBFRAME_SIZE];
yading@10 573 float sum1 = 0.0, sum2 = 0.0, gamma, gain;
yading@10 574 float tilt = pfc->tilt;
yading@10 575 int i, n, best;
yading@10 576
yading@10 577 bandwidth_expansion(wcoef1, coeff, pfc->p1);
yading@10 578 bandwidth_expansion(wcoef2, coeff, pfc->p2);
yading@10 579
yading@10 580 /* Tilt compensation filter, TIA/IS-127 5.9.1 */
yading@10 581 for (i = 0; i < length - 1; i++)
yading@10 582 sum2 += in[i] * in[i + 1];
yading@10 583 if (sum2 < 0.0)
yading@10 584 tilt = 0.0;
yading@10 585
yading@10 586 for (i = 0; i < length; i++) {
yading@10 587 scratch[i] = in[i] - tilt * e->last;
yading@10 588 e->last = in[i];
yading@10 589 }
yading@10 590
yading@10 591 /* Short term residual filter, TIA/IS-127 5.9.2 */
yading@10 592 residual_filter(&e->postfilter_residual[ACB_SIZE], scratch, wcoef1, e->postfilter_fir, length);
yading@10 593
yading@10 594 /* Long term postfilter */
yading@10 595 best = idx;
yading@10 596 for (i = FFMIN(MIN_DELAY, idx - 3); i <= FFMAX(MAX_DELAY, idx + 3); i++) {
yading@10 597 for (n = ACB_SIZE, sum2 = 0; n < ACB_SIZE + length; n++)
yading@10 598 sum2 += e->postfilter_residual[n] * e->postfilter_residual[n - i];
yading@10 599 if (sum2 > sum1) {
yading@10 600 sum1 = sum2;
yading@10 601 best = i;
yading@10 602 }
yading@10 603 }
yading@10 604
yading@10 605 for (i = ACB_SIZE, sum1 = 0; i < ACB_SIZE + length; i++)
yading@10 606 sum1 += e->postfilter_residual[i - best] * e->postfilter_residual[i - best];
yading@10 607 for (i = ACB_SIZE, sum2 = 0; i < ACB_SIZE + length; i++)
yading@10 608 sum2 += e->postfilter_residual[i] * e->postfilter_residual[i - best];
yading@10 609
yading@10 610 if (sum2 * sum1 == 0 || e->bitrate == RATE_QUANT) {
yading@10 611 memcpy(temp, e->postfilter_residual + ACB_SIZE, length * sizeof(float));
yading@10 612 } else {
yading@10 613 gamma = sum2 / sum1;
yading@10 614 if (gamma < 0.5)
yading@10 615 memcpy(temp, e->postfilter_residual + ACB_SIZE, length * sizeof(float));
yading@10 616 else {
yading@10 617 gamma = FFMIN(gamma, 1.0);
yading@10 618
yading@10 619 for (i = 0; i < length; i++) {
yading@10 620 temp[i] = e->postfilter_residual[ACB_SIZE + i] + gamma *
yading@10 621 pfc->ltgain * e->postfilter_residual[ACB_SIZE + i - best];
yading@10 622 }
yading@10 623 }
yading@10 624 }
yading@10 625
yading@10 626 memcpy(scratch, temp, length * sizeof(float));
yading@10 627 memcpy(mem, e->postfilter_iir, FILTER_ORDER * sizeof(float));
yading@10 628 synthesis_filter(scratch, wcoef2, mem, length, scratch);
yading@10 629
yading@10 630 /* Gain computation, TIA/IS-127 5.9.4-2 */
yading@10 631 for (i = 0, sum1 = 0, sum2 = 0; i < length; i++) {
yading@10 632 sum1 += in[i] * in[i];
yading@10 633 sum2 += scratch[i] * scratch[i];
yading@10 634 }
yading@10 635 gain = sum2 ? sqrt(sum1 / sum2) : 1.0;
yading@10 636
yading@10 637 for (i = 0; i < length; i++)
yading@10 638 temp[i] *= gain;
yading@10 639
yading@10 640 /* Short term postfilter */
yading@10 641 synthesis_filter(temp, wcoef2, e->postfilter_iir, length, out);
yading@10 642
yading@10 643 memmove(e->postfilter_residual,
yading@10 644 e->postfilter_residual + length, ACB_SIZE * sizeof(float));
yading@10 645 }
yading@10 646
yading@10 647 static void frame_erasure(EVRCContext *e, float *samples)
yading@10 648 {
yading@10 649 float ilspf[FILTER_ORDER], ilpc[FILTER_ORDER], idelay[NB_SUBFRAMES],
yading@10 650 tmp[SUBFRAME_SIZE + 6], f;
yading@10 651 int i, j;
yading@10 652
yading@10 653 for (i = 0; i < FILTER_ORDER; i++) {
yading@10 654 if (e->bitrate != RATE_QUANT)
yading@10 655 e->lspf[i] = e->prev_lspf[i] * 0.875 + 0.125 * (i + 1) * 0.048;
yading@10 656 else
yading@10 657 e->lspf[i] = e->prev_lspf[i];
yading@10 658 }
yading@10 659
yading@10 660 if (e->prev_error_flag)
yading@10 661 e->avg_acb_gain *= 0.75;
yading@10 662 if (e->bitrate == RATE_FULL)
yading@10 663 memcpy(e->pitch_back, e->pitch, ACB_SIZE * sizeof(float));
yading@10 664 if (e->last_valid_bitrate == RATE_QUANT)
yading@10 665 e->bitrate = RATE_QUANT;
yading@10 666 else
yading@10 667 e->bitrate = RATE_FULL;
yading@10 668
yading@10 669 if (e->bitrate == RATE_FULL || e->bitrate == RATE_HALF) {
yading@10 670 e->pitch_delay = e->prev_pitch_delay;
yading@10 671 } else {
yading@10 672 float sum = 0;
yading@10 673
yading@10 674 idelay[0] = idelay[1] = idelay[2] = MIN_DELAY;
yading@10 675
yading@10 676 for (i = 0; i < NB_SUBFRAMES; i++)
yading@10 677 sum += evrc_energy_quant[e->prev_energy_gain][i];
yading@10 678 sum /= (float) NB_SUBFRAMES;
yading@10 679 sum = pow(10, sum);
yading@10 680 for (i = 0; i < NB_SUBFRAMES; i++)
yading@10 681 e->energy_vector[i] = sum;
yading@10 682 }
yading@10 683
yading@10 684 if (fabs(e->pitch_delay - e->prev_pitch_delay) > 15)
yading@10 685 e->prev_pitch_delay = e->pitch_delay;
yading@10 686
yading@10 687 for (i = 0; i < NB_SUBFRAMES; i++) {
yading@10 688 int subframe_size = subframe_sizes[i];
yading@10 689 int pitch_lag;
yading@10 690
yading@10 691 interpolate_lsp(ilspf, e->lspf, e->prev_lspf, i);
yading@10 692
yading@10 693 if (e->bitrate != RATE_QUANT) {
yading@10 694 if (e->avg_acb_gain < 0.3) {
yading@10 695 idelay[0] = estimation_delay[i];
yading@10 696 idelay[1] = estimation_delay[i + 1];
yading@10 697 idelay[2] = estimation_delay[i + 2];
yading@10 698 } else {
yading@10 699 interpolate_delay(idelay, e->pitch_delay, e->prev_pitch_delay, i);
yading@10 700 }
yading@10 701 }
yading@10 702
yading@10 703 pitch_lag = lrintf((idelay[1] + idelay[0]) / 2.0);
yading@10 704 decode_predictor_coeffs(ilspf, ilpc);
yading@10 705
yading@10 706 if (e->bitrate != RATE_QUANT) {
yading@10 707 acb_excitation(e, e->pitch + ACB_SIZE,
yading@10 708 e->avg_acb_gain, idelay, subframe_size);
yading@10 709 for (j = 0; j < subframe_size; j++)
yading@10 710 e->pitch[ACB_SIZE + j] *= e->fade_scale;
yading@10 711 e->fade_scale = FFMAX(e->fade_scale - 0.05, 0.0);
yading@10 712 } else {
yading@10 713 for (j = 0; j < subframe_size; j++)
yading@10 714 e->pitch[ACB_SIZE + j] = e->energy_vector[i];
yading@10 715 }
yading@10 716
yading@10 717 memmove(e->pitch, e->pitch + subframe_size, ACB_SIZE * sizeof(float));
yading@10 718
yading@10 719 if (e->bitrate != RATE_QUANT && e->avg_acb_gain < 0.4) {
yading@10 720 f = 0.1 * e->avg_fcb_gain;
yading@10 721 for (j = 0; j < subframe_size; j++)
yading@10 722 e->pitch[ACB_SIZE + j] += f;
yading@10 723 } else if (e->bitrate == RATE_QUANT) {
yading@10 724 for (j = 0; j < subframe_size; j++)
yading@10 725 e->pitch[ACB_SIZE + j] = e->energy_vector[i];
yading@10 726 }
yading@10 727
yading@10 728 synthesis_filter(e->pitch + ACB_SIZE, ilpc,
yading@10 729 e->synthesis, subframe_size, tmp);
yading@10 730 postfilter(e, tmp, ilpc, samples, pitch_lag,
yading@10 731 &postfilter_coeffs[e->bitrate], subframe_size);
yading@10 732
yading@10 733 samples += subframe_size;
yading@10 734 }
yading@10 735 }
yading@10 736
yading@10 737 static int evrc_decode_frame(AVCodecContext *avctx, void *data,
yading@10 738 int *got_frame_ptr, AVPacket *avpkt)
yading@10 739 {
yading@10 740 const uint8_t *buf = avpkt->data;
yading@10 741 AVFrame *frame = data;
yading@10 742 EVRCContext *e = avctx->priv_data;
yading@10 743 int buf_size = avpkt->size;
yading@10 744 float ilspf[FILTER_ORDER], ilpc[FILTER_ORDER], idelay[NB_SUBFRAMES];
yading@10 745 float *samples;
yading@10 746 int i, j, ret, error_flag = 0;
yading@10 747
yading@10 748 frame->nb_samples = 160;
yading@10 749 if ((ret = ff_get_buffer(avctx, frame, 0)) < 0)
yading@10 750 return ret;
yading@10 751 samples = (float *)frame->data[0];
yading@10 752
yading@10 753 if ((e->bitrate = determine_bitrate(avctx, &buf_size, &buf)) == RATE_ERRS) {
yading@10 754 warn_insufficient_frame_quality(avctx, "bitrate cannot be determined.");
yading@10 755 goto erasure;
yading@10 756 }
yading@10 757 if (e->bitrate <= SILENCE || e->bitrate == RATE_QUARTER)
yading@10 758 goto erasure;
yading@10 759 if (e->bitrate == RATE_QUANT && e->last_valid_bitrate == RATE_FULL
yading@10 760 && !e->prev_error_flag)
yading@10 761 goto erasure;
yading@10 762
yading@10 763 init_get_bits(&e->gb, buf, 8 * buf_size);
yading@10 764 memset(&e->frame, 0, sizeof(EVRCAFrame));
yading@10 765
yading@10 766 unpack_frame(e);
yading@10 767
yading@10 768 if (e->bitrate != RATE_QUANT) {
yading@10 769 uint8_t *p = (uint8_t *) &e->frame;
yading@10 770 for (i = 0; i < sizeof(EVRCAFrame); i++) {
yading@10 771 if (p[i])
yading@10 772 break;
yading@10 773 }
yading@10 774 if (i == sizeof(EVRCAFrame))
yading@10 775 goto erasure;
yading@10 776 } else if (e->frame.lsp[0] == 0xf &&
yading@10 777 e->frame.lsp[1] == 0xf &&
yading@10 778 e->frame.energy_gain == 0xff) {
yading@10 779 goto erasure;
yading@10 780 }
yading@10 781
yading@10 782 if (decode_lspf(e) < 0)
yading@10 783 goto erasure;
yading@10 784
yading@10 785 if (e->bitrate == RATE_FULL || e->bitrate == RATE_HALF) {
yading@10 786 /* Pitch delay parameter checking as per TIA/IS-127 5.1.5.1 */
yading@10 787 if (e->frame.pitch_delay > MAX_DELAY - MIN_DELAY)
yading@10 788 goto erasure;
yading@10 789
yading@10 790 e->pitch_delay = e->frame.pitch_delay + MIN_DELAY;
yading@10 791
yading@10 792 /* Delay diff parameter checking as per TIA/IS-127 5.1.5.2 */
yading@10 793 if (e->frame.delay_diff) {
yading@10 794 int p = e->pitch_delay - e->frame.delay_diff + 16;
yading@10 795 if (p < MIN_DELAY || p > MAX_DELAY)
yading@10 796 goto erasure;
yading@10 797 }
yading@10 798
yading@10 799 /* Delay contour reconstruction as per TIA/IS-127 5.2.2.2 */
yading@10 800 if (e->frame.delay_diff &&
yading@10 801 e->bitrate == RATE_FULL && e->prev_error_flag) {
yading@10 802 float delay;
yading@10 803
yading@10 804 memcpy(e->pitch, e->pitch_back, ACB_SIZE * sizeof(float));
yading@10 805
yading@10 806 delay = e->prev_pitch_delay;
yading@10 807 e->prev_pitch_delay = delay - e->frame.delay_diff + 16.0;
yading@10 808
yading@10 809 if (fabs(e->pitch_delay - delay) > 15)
yading@10 810 delay = e->pitch_delay;
yading@10 811
yading@10 812 for (i = 0; i < NB_SUBFRAMES; i++) {
yading@10 813 int subframe_size = subframe_sizes[i];
yading@10 814
yading@10 815 interpolate_delay(idelay, delay, e->prev_pitch_delay, i);
yading@10 816 acb_excitation(e, e->pitch + ACB_SIZE, e->avg_acb_gain, idelay, subframe_size);
yading@10 817 memmove(e->pitch, e->pitch + subframe_size, ACB_SIZE * sizeof(float));
yading@10 818 }
yading@10 819 }
yading@10 820
yading@10 821 /* Smoothing of the decoded delay as per TIA/IS-127 5.2.2.5 */
yading@10 822 if (fabs(e->pitch_delay - e->prev_pitch_delay) > 15)
yading@10 823 e->prev_pitch_delay = e->pitch_delay;
yading@10 824
yading@10 825 e->avg_acb_gain = e->avg_fcb_gain = 0.0;
yading@10 826 } else {
yading@10 827 idelay[0] = idelay[1] = idelay[2] = MIN_DELAY;
yading@10 828
yading@10 829 /* Decode frame energy vectors as per TIA/IS-127 5.7.2 */
yading@10 830 for (i = 0; i < NB_SUBFRAMES; i++)
yading@10 831 e->energy_vector[i] = pow(10, evrc_energy_quant[e->frame.energy_gain][i]);
yading@10 832 e->prev_energy_gain = e->frame.energy_gain;
yading@10 833 }
yading@10 834
yading@10 835 for (i = 0; i < NB_SUBFRAMES; i++) {
yading@10 836 float tmp[SUBFRAME_SIZE + 6] = { 0 };
yading@10 837 int subframe_size = subframe_sizes[i];
yading@10 838 int pitch_lag;
yading@10 839
yading@10 840 interpolate_lsp(ilspf, e->lspf, e->prev_lspf, i);
yading@10 841
yading@10 842 if (e->bitrate != RATE_QUANT)
yading@10 843 interpolate_delay(idelay, e->pitch_delay, e->prev_pitch_delay, i);
yading@10 844
yading@10 845 pitch_lag = lrintf((idelay[1] + idelay[0]) / 2.0);
yading@10 846 decode_predictor_coeffs(ilspf, ilpc);
yading@10 847
yading@10 848 /* Bandwidth expansion as per TIA/IS-127 5.2.3.3 */
yading@10 849 if (e->frame.lpc_flag && e->prev_error_flag)
yading@10 850 bandwidth_expansion(ilpc, ilpc, 0.75);
yading@10 851
yading@10 852 if (e->bitrate != RATE_QUANT) {
yading@10 853 float acb_sum, f;
yading@10 854
yading@10 855 f = exp((e->bitrate == RATE_HALF ? 0.5 : 0.25)
yading@10 856 * (e->frame.fcb_gain[i] + 1));
yading@10 857 acb_sum = pitch_gain_vq[e->frame.acb_gain[i]];
yading@10 858 e->avg_acb_gain += acb_sum / NB_SUBFRAMES;
yading@10 859 e->avg_fcb_gain += f / NB_SUBFRAMES;
yading@10 860
yading@10 861 acb_excitation(e, e->pitch + ACB_SIZE,
yading@10 862 acb_sum, idelay, subframe_size);
yading@10 863 fcb_excitation(e, e->frame.fcb_shape[i], tmp,
yading@10 864 acb_sum, pitch_lag, subframe_size);
yading@10 865
yading@10 866 /* Total excitation generation as per TIA/IS-127 5.2.3.9 */
yading@10 867 for (j = 0; j < subframe_size; j++)
yading@10 868 e->pitch[ACB_SIZE + j] += f * tmp[j];
yading@10 869 e->fade_scale = FFMIN(e->fade_scale + 0.2, 1.0);
yading@10 870 } else {
yading@10 871 for (j = 0; j < subframe_size; j++)
yading@10 872 e->pitch[ACB_SIZE + j] = e->energy_vector[i];
yading@10 873 }
yading@10 874
yading@10 875 memmove(e->pitch, e->pitch + subframe_size, ACB_SIZE * sizeof(float));
yading@10 876
yading@10 877 synthesis_filter(e->pitch + ACB_SIZE, ilpc,
yading@10 878 e->synthesis, subframe_size, tmp);
yading@10 879 postfilter(e, tmp, ilpc, samples, pitch_lag,
yading@10 880 &postfilter_coeffs[e->bitrate], subframe_size);
yading@10 881
yading@10 882 samples += subframe_size;
yading@10 883 }
yading@10 884
yading@10 885 if (error_flag) {
yading@10 886 erasure:
yading@10 887 error_flag = 1;
yading@10 888 av_log(avctx, AV_LOG_WARNING, "frame erasure\n");
yading@10 889 frame_erasure(e, samples);
yading@10 890 }
yading@10 891
yading@10 892 memcpy(e->prev_lspf, e->lspf, sizeof(e->prev_lspf));
yading@10 893 e->prev_error_flag = error_flag;
yading@10 894 e->last_valid_bitrate = e->bitrate;
yading@10 895
yading@10 896 if (e->bitrate != RATE_QUANT)
yading@10 897 e->prev_pitch_delay = e->pitch_delay;
yading@10 898
yading@10 899 samples = (float *)frame->data[0];
yading@10 900 for (i = 0; i < 160; i++)
yading@10 901 samples[i] /= 32768;
yading@10 902
yading@10 903 *got_frame_ptr = 1;
yading@10 904
yading@10 905 return avpkt->size;
yading@10 906 }
yading@10 907
yading@10 908 AVCodec ff_evrc_decoder = {
yading@10 909 .name = "evrc",
yading@10 910 .type = AVMEDIA_TYPE_AUDIO,
yading@10 911 .id = AV_CODEC_ID_EVRC,
yading@10 912 .init = evrc_decode_init,
yading@10 913 .decode = evrc_decode_frame,
yading@10 914 .capabilities = CODEC_CAP_DR1,
yading@10 915 .priv_data_size = sizeof(EVRCContext),
yading@10 916 .long_name = NULL_IF_CONFIG_SMALL("EVRC (Enhanced Variable Rate Codec)"),
yading@10 917 };