FFmpeg
Data Structures | Macros | Enumerations | Functions | Variables
evrcdec.c File Reference
#include "libavutil/channel_layout.h"
#include "libavutil/mathematics.h"
#include "libavutil/opt.h"
#include "avcodec.h"
#include "internal.h"
#include "get_bits.h"
#include "evrcdata.h"
#include "acelp_vectors.h"
#include "lsp.h"

Go to the source code of this file.

Data Structures

struct  EVRCAFrame
 EVRC-A unpacked data frame. More...
 
struct  EVRCContext
 
struct  PfCoeff
 

Macros

#define MIN_LSP_SEP   (0.05 / (2.0 * M_PI))
 
#define MIN_DELAY   20
 
#define MAX_DELAY   120
 
#define NB_SUBFRAMES   3
 
#define SUBFRAME_SIZE   54
 
#define FILTER_ORDER   10
 
#define ACB_SIZE   128
 
#define OFFSET(x)   offsetof(EVRCContext, x)
 
#define AD   AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_DECODING_PARAM
 

Enumerations

enum  evrc_packet_rate {
  RATE_ERRS = -1, SILENCE, RATE_QUANT, RATE_QUARTER,
  RATE_HALF, RATE_FULL
}
 

Functions

static void unpack_frame (EVRCContext *e)
 Frame unpacking for RATE_FULL, RATE_HALF and RATE_QUANT. More...
 
static evrc_packet_rate buf_size2bitrate (const int buf_size)
 
static evrc_packet_rate determine_bitrate (AVCodecContext *avctx, int *buf_size, const uint8_t **buf)
 Determine the bitrate from the frame size and/or the first byte of the frame. More...
 
static void warn_insufficient_frame_quality (AVCodecContext *avctx, const char *message)
 
static av_cold int evrc_decode_init (AVCodecContext *avctx)
 Initialize the speech codec according to the specification. More...
 
static int decode_lspf (EVRCContext *e)
 Decode the 10 vector quantized line spectral pair frequencies from the LSP transmission codes of any bitrate and check for badly received packets. More...
 
static void interpolate_lsp (float *ilsp, const float *lsp, const float *prev, int index)
 
static void interpolate_delay (float *dst, float current, float prev, int index)
 
static void decode_predictor_coeffs (const float *ilspf, float *ilpc)
 
static void bl_intrp (EVRCContext *e, float *ex, float delay)
 
static void acb_excitation (EVRCContext *e, float *excitation, float gain, const float delay[3], int length)
 
static void decode_8_pulses_35bits (const uint16_t *fixed_index, float *cod)
 
static void decode_3_pulses_10bits (uint16_t fixed_index, float *cod)
 
static void fcb_excitation (EVRCContext *e, const uint16_t *codebook, float *excitation, float pitch_gain, int pitch_lag, int subframe_size)
 
static void synthesis_filter (const float *in, const float *filter_coeffs, float *memory, int buffer_length, float *samples)
 Synthesis of the decoder output signal. More...
 
static void bandwidth_expansion (float *coeff, const float *inbuf, float gamma)
 
static void residual_filter (float *output, const float *input, const float *coef, float *memory, int length)
 
static void postfilter (EVRCContext *e, float *in, const float *coeff, float *out, int idx, const struct PfCoeff *pfc, int length)
 
static void frame_erasure (EVRCContext *e, float *samples)
 
static int evrc_decode_frame (AVCodecContext *avctx, void *data, int *got_frame_ptr, AVPacket *avpkt)
 

Variables

static const struct PfCoeff postfilter_coeffs [5]
 
static const AVOption options []
 
static const AVClass evrcdec_class
 
const AVCodec ff_evrc_decoder
 

Detailed Description

Enhanced Variable Rate Codec, Service Option 3 decoder

Author
Paul B Mahol

Definition in file evrcdec.c.

Macro Definition Documentation

◆ MIN_LSP_SEP

#define MIN_LSP_SEP   (0.05 / (2.0 * M_PI))

Definition at line 38 of file evrcdec.c.

◆ MIN_DELAY

#define MIN_DELAY   20

Definition at line 39 of file evrcdec.c.

◆ MAX_DELAY

#define MAX_DELAY   120

Definition at line 40 of file evrcdec.c.

◆ NB_SUBFRAMES

#define NB_SUBFRAMES   3

Definition at line 41 of file evrcdec.c.

◆ SUBFRAME_SIZE

#define SUBFRAME_SIZE   54

Definition at line 42 of file evrcdec.c.

◆ FILTER_ORDER

#define FILTER_ORDER   10

Definition at line 43 of file evrcdec.c.

◆ ACB_SIZE

#define ACB_SIZE   128

Definition at line 44 of file evrcdec.c.

◆ OFFSET

#define OFFSET (   x)    offsetof(EVRCContext, x)

Definition at line 917 of file evrcdec.c.

◆ AD

Definition at line 918 of file evrcdec.c.

Enumeration Type Documentation

◆ evrc_packet_rate

Enumerator
RATE_ERRS 
SILENCE 
RATE_QUANT 
RATE_QUARTER 
RATE_HALF 
RATE_FULL 

Definition at line 46 of file evrcdec.c.

Function Documentation

◆ unpack_frame()

static void unpack_frame ( EVRCContext e)
static

Frame unpacking for RATE_FULL, RATE_HALF and RATE_QUANT.

Parameters
ethe context

TIA/IS-127 Table 4.21-1

Definition at line 109 of file evrcdec.c.

Referenced by evrc_decode_frame().

◆ buf_size2bitrate()

static evrc_packet_rate buf_size2bitrate ( const int  buf_size)
static

Definition at line 166 of file evrcdec.c.

Referenced by determine_bitrate().

◆ determine_bitrate()

static evrc_packet_rate determine_bitrate ( AVCodecContext avctx,
int buf_size,
const uint8_t **  buf 
)
static

Determine the bitrate from the frame size and/or the first byte of the frame.

Parameters
avctxthe AV codec context
buf_sizelength of the buffer
bufthe bufffer
Returns
the bitrate on success, RATE_ERRS if the bitrate cannot be satisfactorily determined

Definition at line 189 of file evrcdec.c.

Referenced by evrc_decode_frame().

◆ warn_insufficient_frame_quality()

static void warn_insufficient_frame_quality ( AVCodecContext avctx,
const char *  message 
)
static

Definition at line 220 of file evrcdec.c.

Referenced by evrc_decode_frame().

◆ evrc_decode_init()

static av_cold int evrc_decode_init ( AVCodecContext avctx)
static

Initialize the speech codec according to the specification.

TIA/IS-127 5.2

Definition at line 232 of file evrcdec.c.

◆ decode_lspf()

static int decode_lspf ( EVRCContext e)
static

Decode the 10 vector quantized line spectral pair frequencies from the LSP transmission codes of any bitrate and check for badly received packets.

Parameters
ethe context
Returns
0 on success, -1 if the packet is badly received

TIA/IS-127 5.2.1, 5.7.1

Definition at line 283 of file evrcdec.c.

Referenced by evrc_decode_frame().

◆ interpolate_lsp()

static void interpolate_lsp ( float *  ilsp,
const float *  lsp,
const float *  prev,
int  index 
)
static

Definition at line 316 of file evrcdec.c.

Referenced by evrc_decode_frame(), and frame_erasure().

◆ interpolate_delay()

static void interpolate_delay ( float *  dst,
float  current,
float  prev,
int  index 
)
static

Definition at line 330 of file evrcdec.c.

Referenced by evrc_decode_frame(), and frame_erasure().

◆ decode_predictor_coeffs()

static void decode_predictor_coeffs ( const float *  ilspf,
float *  ilpc 
)
static

Definition at line 347 of file evrcdec.c.

Referenced by evrc_decode_frame(), and frame_erasure().

◆ bl_intrp()

static void bl_intrp ( EVRCContext e,
float *  ex,
float  delay 
)
static

Definition at line 377 of file evrcdec.c.

Referenced by acb_excitation().

◆ acb_excitation()

static void acb_excitation ( EVRCContext e,
float *  excitation,
float  gain,
const float  delay[3],
int  length 
)
static

Definition at line 405 of file evrcdec.c.

Referenced by evrc_decode_frame(), and frame_erasure().

◆ decode_8_pulses_35bits()

static void decode_8_pulses_35bits ( const uint16_t *  fixed_index,
float *  cod 
)
static

Definition at line 432 of file evrcdec.c.

Referenced by fcb_excitation().

◆ decode_3_pulses_10bits()

static void decode_3_pulses_10bits ( uint16_t  fixed_index,
float *  cod 
)
static

Definition at line 457 of file evrcdec.c.

Referenced by fcb_excitation().

◆ fcb_excitation()

static void fcb_excitation ( EVRCContext e,
const uint16_t *  codebook,
float *  excitation,
float  pitch_gain,
int  pitch_lag,
int  subframe_size 
)
static

Definition at line 477 of file evrcdec.c.

Referenced by evrc_decode_frame().

◆ synthesis_filter()

static void synthesis_filter ( const float *  in,
const float *  filter_coeffs,
float *  memory,
int  buffer_length,
float *  samples 
)
static

Synthesis of the decoder output signal.

param[in] in input signal param[in] filter_coeffs LPC coefficients param[in/out] memory synthesis filter memory param buffer_length amount of data to process param[out] samples output samples

TIA/IS-127 5.2.3.15, 5.7.3.4

Definition at line 505 of file evrcdec.c.

Referenced by evrc_decode_frame(), frame_erasure(), and postfilter().

◆ bandwidth_expansion()

static void bandwidth_expansion ( float *  coeff,
const float *  inbuf,
float  gamma 
)
static

Definition at line 521 of file evrcdec.c.

Referenced by evrc_decode_frame(), and postfilter().

◆ residual_filter()

static void residual_filter ( float *  output,
const float *  input,
const float *  coef,
float *  memory,
int  length 
)
static

Definition at line 532 of file evrcdec.c.

Referenced by postfilter().

◆ postfilter()

static void postfilter ( EVRCContext e,
float *  in,
const float *  coeff,
float *  out,
int  idx,
const struct PfCoeff pfc,
int  length 
)
static

Definition at line 572 of file evrcdec.c.

Referenced by evrc_decode_frame(), and frame_erasure().

◆ frame_erasure()

static void frame_erasure ( EVRCContext e,
float *  samples 
)
static

Definition at line 653 of file evrcdec.c.

Referenced by decode_frame(), and evrc_decode_frame().

◆ evrc_decode_frame()

static int evrc_decode_frame ( AVCodecContext avctx,
void *  data,
int got_frame_ptr,
AVPacket avpkt 
)
static

Definition at line 743 of file evrcdec.c.

Variable Documentation

◆ postfilter_coeffs

const struct PfCoeff postfilter_coeffs[5]
static
Initial value:
= {
{ 0.0 , 0.0 , 0.0 , 0.0 },
{ 0.0 , 0.0 , 0.57, 0.57 },
{ 0.0 , 0.0 , 0.0 , 0.0 },
{ 0.35, 0.50, 0.50, 0.75 },
{ 0.20, 0.50, 0.57, 0.75 },
}

Referenced by evrc_decode_frame(), and frame_erasure().

◆ options

const AVOption options[]
static
Initial value:
= {
{ "postfilter", "enable postfilter", OFFSET(postfilter), AV_OPT_TYPE_BOOL, {.i64 = 1}, 0, 1, AD },
{ NULL }
}

Definition at line 920 of file evrcdec.c.

◆ evrcdec_class

const AVClass evrcdec_class
static
Initial value:
= {
.class_name = "evrc",
.item_name = av_default_item_name,
.option = options,
}

Definition at line 925 of file evrcdec.c.

◆ ff_evrc_decoder

const AVCodec ff_evrc_decoder
Initial value:
= {
.name = "evrc",
.long_name = NULL_IF_CONFIG_SMALL("EVRC (Enhanced Variable Rate Codec)"),
.decode = evrc_decode_frame,
.priv_data_size = sizeof(EVRCContext),
.priv_class = &evrcdec_class,
.caps_internal = FF_CODEC_CAP_INIT_THREADSAFE,
}

Definition at line 932 of file evrcdec.c.

FF_CODEC_CAP_INIT_THREADSAFE
#define FF_CODEC_CAP_INIT_THREADSAFE
The codec does not modify any global variables in the init function, allowing to call the init functi...
Definition: internal.h:42
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
AD
#define AD
Definition: evrcdec.c:918
evrc_decode_frame
static int evrc_decode_frame(AVCodecContext *avctx, void *data, int *got_frame_ptr, AVPacket *avpkt)
Definition: evrcdec.c:743
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
NULL
#define NULL
Definition: coverity.c:32
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:235
OFFSET
#define OFFSET(x)
Definition: evrcdec.c:917
AV_CODEC_CAP_CHANNEL_CONF
#define AV_CODEC_CAP_CHANNEL_CONF
Codec should fill in channel configuration and samplerate instead of container.
Definition: codec.h:109
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
options
static const AVOption options[]
Definition: evrcdec.c:920
AV_CODEC_ID_EVRC
@ AV_CODEC_ID_EVRC
Definition: codec_id.h:494
postfilter
static void postfilter(EVRCContext *e, float *in, const float *coeff, float *out, int idx, const struct PfCoeff *pfc, int length)
Definition: evrcdec.c:572
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:241
EVRCContext
Definition: evrcdec.c:70
evrcdec_class
static const AVClass evrcdec_class
Definition: evrcdec.c:925
evrc_decode_init
static av_cold int evrc_decode_init(AVCodecContext *avctx)
Initialize the speech codec according to the specification.
Definition: evrcdec.c:232