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 "codec_internal.h"
#include "decode.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, AVFrame *frame, int *got_frame_ptr, AVPacket *avpkt)
 

Variables

static const struct PfCoeff postfilter_coeffs [5]
 
static const AVOption options []
 
static const AVClass evrcdec_class
 
const FFCodec 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 39 of file evrcdec.c.

◆ MIN_DELAY

#define MIN_DELAY   20

Definition at line 40 of file evrcdec.c.

◆ MAX_DELAY

#define MAX_DELAY   120

Definition at line 41 of file evrcdec.c.

◆ NB_SUBFRAMES

#define NB_SUBFRAMES   3

Definition at line 42 of file evrcdec.c.

◆ SUBFRAME_SIZE

#define SUBFRAME_SIZE   54

Definition at line 43 of file evrcdec.c.

◆ FILTER_ORDER

#define FILTER_ORDER   10

Definition at line 44 of file evrcdec.c.

◆ ACB_SIZE

#define ACB_SIZE   128

Definition at line 45 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 47 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 110 of file evrcdec.c.

Referenced by decode_row(), and evrc_decode_frame().

◆ buf_size2bitrate()

static evrc_packet_rate buf_size2bitrate ( const int  buf_size)
static

Definition at line 167 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 190 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 221 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 233 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 284 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 317 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 331 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 348 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 378 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 406 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 433 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 458 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 478 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.

Parameters
[in]ininput signal
[in]filter_coeffsLPC coefficients
[in/out]memory synthesis filter memory
buffer_lengthamount of data to process
[out]samplesoutput samples

TIA/IS-127 5.2.3.15, 5.7.3.4

Definition at line 506 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 522 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 533 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 573 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 654 of file evrcdec.c.

Referenced by decode_frame(), and evrc_decode_frame().

◆ evrc_decode_frame()

static int evrc_decode_frame ( AVCodecContext avctx,
AVFrame frame,
int *  got_frame_ptr,
AVPacket avpkt 
)
static

Definition at line 744 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 FFCodec ff_evrc_decoder
Initial value:
= {
.p.name = "evrc",
CODEC_LONG_NAME("EVRC (Enhanced Variable Rate Codec)"),
.p.type = AVMEDIA_TYPE_AUDIO,
.priv_data_size = sizeof(EVRCContext),
.p.priv_class = &evrcdec_class,
}

Definition at line 932 of file evrcdec.c.

evrc_decode_frame
static int evrc_decode_frame(AVCodecContext *avctx, AVFrame *frame, int *got_frame_ptr, AVPacket *avpkt)
Definition: evrcdec.c:744
FF_CODEC_DECODE_CB
#define FF_CODEC_DECODE_CB(func)
Definition: codec_internal.h:311
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
AD
#define AD
Definition: evrcdec.c:918
CODEC_LONG_NAME
#define CODEC_LONG_NAME(str)
Definition: codec_internal.h:296
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:237
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:106
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
options
static const AVOption options[]
Definition: evrcdec.c:920
AV_CODEC_ID_EVRC
@ AV_CODEC_ID_EVRC
Definition: codec_id.h:512
postfilter
static void postfilter(EVRCContext *e, float *in, const float *coeff, float *out, int idx, const struct PfCoeff *pfc, int length)
Definition: evrcdec.c:573
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Underlying C type is int.
Definition: opt.h:327
EVRCContext
Definition: evrcdec.c:71
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:233