#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"

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

#define AD AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_DECODING_PARAM

Definition at line 918 of file evrcdec.c.

Enumeration Type Documentation

◆ evrc_packet_rate

enum 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

e	the 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

avctx	the AV codec context
buf_size	length of the buffer
buf	the 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

e	the 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,
    .version    = LIBAVUTIL_VERSION_INT,
}

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)"),
    .type           = AVMEDIA_TYPE_AUDIO,
    .id             = AV_CODEC_ID_EVRC,
    .init           = evrc_decode_init,
    .decode         = evrc_decode_frame,
    .capabilities   = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_CHANNEL_CONF,
    .priv_data_size = sizeof(EVRCContext),
    .priv_class     = &evrcdec_class,
    .caps_internal  = FF_CODEC_CAP_INIT_THREADSAFE,
}

Definition at line 932 of file evrcdec.c.

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ MIN_LSP_SEP

◆ MIN_DELAY

◆ MAX_DELAY

◆ NB_SUBFRAMES

◆ SUBFRAME_SIZE

◆ FILTER_ORDER

◆ ACB_SIZE

◆ OFFSET

◆ AD

Enumeration Type Documentation

◆ evrc_packet_rate

Function Documentation

◆ unpack_frame()

◆ buf_size2bitrate()

◆ determine_bitrate()

◆ warn_insufficient_frame_quality()

◆ evrc_decode_init()

◆ decode_lspf()

◆ interpolate_lsp()

◆ interpolate_delay()

◆ decode_predictor_coeffs()

◆ bl_intrp()

◆ acb_excitation()

◆ decode_8_pulses_35bits()

◆ decode_3_pulses_10bits()

◆ fcb_excitation()

◆ synthesis_filter()

◆ bandwidth_expansion()

◆ residual_filter()

◆ postfilter()

◆ frame_erasure()

◆ evrc_decode_frame()

Variable Documentation

◆ postfilter_coeffs

◆ options

◆ evrcdec_class

◆ ff_evrc_decoder