libavcodec/aaccoder.c File Reference

AAC coefficients encoder. More...

#include "libavutil/libm.h"
#include <float.h>
#include "libavutil/mathematics.h"
#include "avcodec.h"
#include "put_bits.h"
#include "aac.h"
#include "aacenc.h"
#include "aactab.h"

Go to the source code of this file.

Data Structures

struct BandCodingPath

structure used in optimal codebook search More...

struct TrellisPath

Defines

#define QUANTIZE_AND_ENCODE_BAND_COST_FUNC(NAME, BT_ZERO, BT_UNSIGNED, BT_PAIR, BT_ESC)

#define quantize_and_encode_band_cost(s, pb, in, scaled, size, scale_idx, cb, lambda, uplim, bits)

#define TRELLIS_STAGES 121

#define TRELLIS_STATES (SCALE_MAX_DIFF+1)

Functions

static av_always_inline int quant (float coef, const float Q)

Quantize one coefficient.

static void quantize_bands (int *out, const float *in, const float *scaled, int size, float Q34, int is_signed, int maxval)

static void abs_pow34_v (float *out, const float *in, const int size)

static av_always_inline float quantize_and_encode_band_cost_template (struct AACEncContext *s, PutBitContext *pb, const float *in, const float *scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int *bits, int BT_ZERO, int BT_UNSIGNED, int BT_PAIR, int BT_ESC)

Calculate rate distortion cost for quantizing with given codebook.

static float quantize_band_cost (struct AACEncContext *s, const float *in, const float *scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int *bits)

static void quantize_and_encode_band (struct AACEncContext *s, PutBitContext *pb, const float *in, int size, int scale_idx, int cb, const float lambda)

static float find_max_val (int group_len, int swb_size, const float *scaled)

static int find_min_book (float maxval, int sf)

static void encode_window_bands_info (AACEncContext *s, SingleChannelElement *sce, int win, int group_len, const float lambda)

Encode band info for single window group bands.

static void codebook_trellis_rate (AACEncContext *s, SingleChannelElement *sce, int win, int group_len, const float lambda)

static av_always_inline uint8_t coef2minsf (float coef)

Return the minimum scalefactor where the quantized coef does not clip.

static av_always_inline uint8_t coef2maxsf (float coef)

Return the maximum scalefactor where the quantized coef is not zero.

static void search_for_quantizers_anmr (AVCodecContext *avctx, AACEncContext *s, SingleChannelElement *sce, const float lambda)

static void search_for_quantizers_twoloop (AVCodecContext *avctx, AACEncContext *s, SingleChannelElement *sce, const float lambda)

two-loop quantizers search taken from ISO 13818-7 Appendix C

static void search_for_quantizers_faac (AVCodecContext *avctx, AACEncContext *s, SingleChannelElement *sce, const float lambda)

static void search_for_quantizers_fast (AVCodecContext *avctx, AACEncContext *s, SingleChannelElement *sce, const float lambda)

static void search_for_ms (AACEncContext *s, ChannelElement *cpe, const float lambda)

Variables

static const uint8_t run_value_bits_long [64]

bits needed to code codebook run value for long windows

static const uint8_t run_value_bits_short [16]

bits needed to code codebook run value for short windows

static const uint8_t * run_value_bits [2]

static const uint8_t aac_cb_range [12] = {0, 3, 3, 3, 3, 9, 9, 8, 8, 13, 13, 17}

static const uint8_t aac_cb_maxval [12] = {0, 1, 1, 2, 2, 4, 4, 7, 7, 12, 12, 16}

static float(*const quantize_and_encode_band_cost_arr [])(struct AACEncContext *s, PutBitContext *pb, const float *in, const float *scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int *bits)

AACCoefficientsEncoder ff_aac_coders [AAC_CODER_NB]

Detailed Description

AAC coefficients encoder.

Definition in file aaccoder.c.

Define Documentation

#define quantize_and_encode_band_cost	(	s,
		pb,
		in,
		scaled,
		size,
		scale_idx,
		cb,
		lambda,
		uplim,
		bits	)

Value:

quantize_and_encode_band_cost_arr[cb](                              \
                                s, pb, in, scaled, size, scale_idx, cb, \
                                lambda, uplim, bits)

Definition at line 251 of file aaccoder.c.

Referenced by quantize_and_encode_band(), and quantize_band_cost().

#define QUANTIZE_AND_ENCODE_BAND_COST_FUNC	(	NAME,
		BT_ZERO,
		BT_UNSIGNED,
		BT_PAIR,
		BT_ESC	)

Value:

static float quantize_and_encode_band_cost_ ## NAME(                                        \
                                struct AACEncContext *s,                                \
                                PutBitContext *pb, const float *in,                     \
                                const float *scaled, int size, int scale_idx,           \
                                int cb, const float lambda, const float uplim,          \
                                int *bits) {                                            \
    return quantize_and_encode_band_cost_template(                                      \
                                s, pb, in, scaled, size, scale_idx,                     \
                                BT_ESC ? ESC_BT : cb, lambda, uplim, bits,              \
                                BT_ZERO, BT_UNSIGNED, BT_PAIR, BT_ESC);                 \
}

Definition at line 209 of file aaccoder.c.

#define TRELLIS_STAGES 121

Definition at line 550 of file aaccoder.c.

Referenced by search_for_quantizers_anmr().

#define TRELLIS_STATES (SCALE_MAX_DIFF+1)

Definition at line 551 of file aaccoder.c.

Referenced by search_for_quantizers_anmr().

Function Documentation

static void abs_pow34_v	(	float *	out,
		const float *	in,
		const int	size
	)			`[static]`

Definition at line 86 of file aaccoder.c.

Referenced by codebook_trellis_rate(), encode_window_bands_info(), quantize_and_encode_band_cost_template(), search_for_ms(), search_for_quantizers_anmr(), search_for_quantizers_faac(), and search_for_quantizers_twoloop().

static void codebook_trellis_rate	(	AACEncContext *	s,
		SingleChannelElement *	sce,
		int	win,
		int	group_len,
		const float	lambda
	)			`[static]`

Definition at line 412 of file aaccoder.c.

static av_always_inline uint8_t coef2maxsf ( float coef ) [static]

Return the maximum scalefactor where the quantized coef is not zero.

Definition at line 541 of file aaccoder.c.

Referenced by search_for_quantizers_anmr().

static av_always_inline uint8_t coef2minsf ( float coef ) [static]

Return the minimum scalefactor where the quantized coef does not clip.

Definition at line 536 of file aaccoder.c.

Referenced by search_for_quantizers_anmr().

static void encode_window_bands_info	(	AACEncContext *	s,
		SingleChannelElement *	sce,
		int	win,
		int	group_len,
		const float	lambda
	)			`[static]`

Encode band info for single window group bands.

Definition at line 311 of file aaccoder.c.

static float find_max_val	(	int	group_len,
		int	swb_size,
		const float *	scaled
	)			`[static]`

Definition at line 273 of file aaccoder.c.

Referenced by search_for_quantizers_anmr(), and search_for_quantizers_twoloop().

static int find_min_book	(	float	maxval,
		int	sf
	)			`[static]`

Definition at line 284 of file aaccoder.c.

Referenced by search_for_quantizers_anmr(), and search_for_quantizers_twoloop().

static av_always_inline int quant	(	float	coef,
		const float	Q
	)			`[static]`

Quantize one coefficient.

Returns:: absolute value of the quantized coefficient

See also:: 3GPP TS26.403 5.6.2 "Scalefactor determination"

Definition at line 66 of file aaccoder.c.

static void quantize_and_encode_band	(	struct AACEncContext *	s,
		PutBitContext *	pb,
		const float *	in,
		int	size,
		int	scale_idx,
		int	cb,
		const float	lambda
	)			`[static]`

Definition at line 265 of file aaccoder.c.

static av_always_inline float quantize_and_encode_band_cost_template	(	struct AACEncContext *	s,
		PutBitContext *	pb,
		const float *	in,
		const float *	scaled,
		int	size,
		int	scale_idx,
		int	cb,
		const float	lambda,
		const float	uplim,
		int *	bits,
		int	BT_ZERO,
		int	BT_UNSIGNED,
		int	BT_PAIR,
		int	BT_ESC
	)			`[static]`

Calculate rate distortion cost for quantizing with given codebook.

Returns:: quantization distortion

Definition at line 105 of file aaccoder.c.

static float quantize_band_cost	(	struct AACEncContext *	s,
		const float *	in,
		const float *	scaled,
		int	size,
		int	scale_idx,
		int	cb,
		const float	lambda,
		const float	uplim,
		int *	bits
	)			`[static]`

Definition at line 256 of file aaccoder.c.

Referenced by codebook_trellis_rate(), encode_window_bands_info(), search_for_ms(), search_for_quantizers_anmr(), search_for_quantizers_faac(), and search_for_quantizers_twoloop().

static void quantize_bands	(	int *	out,
		const float *	in,
		const float *	scaled,
		int	size,
		float	Q34,
		int	is_signed,
		int	maxval
	)			`[static]`

Definition at line 72 of file aaccoder.c.

Referenced by quantize_and_encode_band_cost_template().

static void search_for_ms	(	AACEncContext *	s,
		ChannelElement *	cpe,
		const float	lambda
	)			`[static]`

Definition at line 1054 of file aaccoder.c.

static void search_for_quantizers_anmr	(	AVCodecContext *	avctx,
		AACEncContext *	s,
		SingleChannelElement *	sce,
		const float	lambda
	)			`[static]`

Definition at line 553 of file aaccoder.c.

static void search_for_quantizers_faac	(	AVCodecContext *	avctx,
		AACEncContext *	s,
		SingleChannelElement *	sce,
		const float	lambda
	)			`[static]`

Definition at line 852 of file aaccoder.c.

static void search_for_quantizers_fast	(	AVCodecContext *	avctx,
		AACEncContext *	s,
		SingleChannelElement *	sce,
		const float	lambda
	)			`[static]`

Definition at line 1020 of file aaccoder.c.

static void search_for_quantizers_twoloop	(	AVCodecContext *	avctx,
		AACEncContext *	s,
		SingleChannelElement *	sce,
		const float	lambda
	)			`[static]`

two-loop quantizers search taken from ISO 13818-7 Appendix C

Definition at line 709 of file aaccoder.c.

Variable Documentation

const uint8_t aac_cb_maxval[12] = {0, 1, 1, 2, 2, 4, 4, 7, 7, 12, 12, 16} [static]

Definition at line 98 of file aaccoder.c.

Referenced by quantize_and_encode_band_cost_template().

const uint8_t aac_cb_range[12] = {0, 3, 3, 3, 3, 9, 9, 8, 8, 13, 13, 17} [static]

Definition at line 97 of file aaccoder.c.

Referenced by quantize_and_encode_band_cost_template().

AACCoefficientsEncoder ff_aac_coders[AAC_CODER_NB]

Initial value:

 {
    {
        search_for_quantizers_faac,
        encode_window_bands_info,
        quantize_and_encode_band,
        search_for_ms,
    },
    {
        search_for_quantizers_anmr,
        encode_window_bands_info,
        quantize_and_encode_band,
        search_for_ms,
    },
    {
        search_for_quantizers_twoloop,
        codebook_trellis_rate,
        quantize_and_encode_band,
        search_for_ms,
    },
    {
        search_for_quantizers_fast,
        encode_window_bands_info,
        quantize_and_encode_band,
        search_for_ms,
    },
}

Definition at line 1115 of file aaccoder.c.

Referenced by aac_encode_init().

float(*const quantize_and_encode_band_cost_arr[])(struct AACEncContext *s, PutBitContext *pb, const float *in, const float *scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int *bits) [static]

Initial value:

 {
    quantize_and_encode_band_cost_ZERO,
    quantize_and_encode_band_cost_SQUAD,
    quantize_and_encode_band_cost_SQUAD,
    quantize_and_encode_band_cost_UQUAD,
    quantize_and_encode_band_cost_UQUAD,
    quantize_and_encode_band_cost_SPAIR,
    quantize_and_encode_band_cost_SPAIR,
    quantize_and_encode_band_cost_UPAIR,
    quantize_and_encode_band_cost_UPAIR,
    quantize_and_encode_band_cost_UPAIR,
    quantize_and_encode_band_cost_UPAIR,
    quantize_and_encode_band_cost_ESC,
}

const uint8_t* run_value_bits[2] [static]

Initial value:

 {
    run_value_bits_long, run_value_bits_short
}

Definition at line 56 of file aaccoder.c.

Referenced by codebook_trellis_rate(), and encode_window_bands_info().

const uint8_t run_value_bits_long[64] [static]

Initial value:

 {
     5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,
     5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5,  5, 10,
    10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10,
    10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 15
}

bits needed to code codebook run value for long windows

Definition at line 44 of file aaccoder.c.

const uint8_t run_value_bits_short[16] [static]

Initial value:

 {
    3, 3, 3, 3, 3, 3, 3, 6, 6, 6, 6, 6, 6, 6, 6, 9
}

bits needed to code codebook run value for short windows

Definition at line 52 of file aaccoder.c.


Data Structures
struct	BandCodingPath
	structure used in optimal codebook search More...
struct	TrellisPath
Defines
#define	QUANTIZE_AND_ENCODE_BAND_COST_FUNC(NAME, BT_ZERO, BT_UNSIGNED, BT_PAIR, BT_ESC)
#define	quantize_and_encode_band_cost(s, pb, in, scaled, size, scale_idx, cb, lambda, uplim, bits)
#define	TRELLIS_STAGES 121
#define	TRELLIS_STATES (SCALE_MAX_DIFF+1)
Functions
static av_always_inline int	quant (float coef, const float Q)
	Quantize one coefficient.
static void	quantize_bands (int out, const float in, const float *scaled, int size, float Q34, int is_signed, int maxval)
static void	abs_pow34_v (float out, const float in, const int size)
static av_always_inline float	quantize_and_encode_band_cost_template (struct AACEncContext s, PutBitContext pb, const float in, const float scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int *bits, int BT_ZERO, int BT_UNSIGNED, int BT_PAIR, int BT_ESC)
	Calculate rate distortion cost for quantizing with given codebook.
static float	quantize_band_cost (struct AACEncContext s, const float in, const float scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int bits)
static void	quantize_and_encode_band (struct AACEncContext s, PutBitContext pb, const float *in, int size, int scale_idx, int cb, const float lambda)
static float	find_max_val (int group_len, int swb_size, const float *scaled)
static int	find_min_book (float maxval, int sf)
static void	encode_window_bands_info (AACEncContext s, SingleChannelElement sce, int win, int group_len, const float lambda)
	Encode band info for single window group bands.
static void	codebook_trellis_rate (AACEncContext s, SingleChannelElement sce, int win, int group_len, const float lambda)
static av_always_inline uint8_t	coef2minsf (float coef)
	Return the minimum scalefactor where the quantized coef does not clip.
static av_always_inline uint8_t	coef2maxsf (float coef)
	Return the maximum scalefactor where the quantized coef is not zero.
static void	search_for_quantizers_anmr (AVCodecContext avctx, AACEncContext s, SingleChannelElement *sce, const float lambda)
static void	search_for_quantizers_twoloop (AVCodecContext avctx, AACEncContext s, SingleChannelElement *sce, const float lambda)
	two-loop quantizers search taken from ISO 13818-7 Appendix C
static void	search_for_quantizers_faac (AVCodecContext avctx, AACEncContext s, SingleChannelElement *sce, const float lambda)
static void	search_for_quantizers_fast (AVCodecContext avctx, AACEncContext s, SingleChannelElement *sce, const float lambda)
static void	search_for_ms (AACEncContext s, ChannelElement cpe, const float lambda)
Variables
static const uint8_t	run_value_bits_long [64]
	bits needed to code codebook run value for long windows
static const uint8_t	run_value_bits_short [16]
	bits needed to code codebook run value for short windows
static const uint8_t *	run_value_bits [2]
static const uint8_t	aac_cb_range [12] = {0, 3, 3, 3, 3, 9, 9, 8, 8, 13, 13, 17}
static const uint8_t	aac_cb_maxval [12] = {0, 1, 1, 2, 2, 4, 4, 7, 7, 12, 12, 16}
static float(*const	quantize_and_encode_band_cost_arr [])(struct AACEncContext s, PutBitContext pb, const float in, const float scaled, int size, int scale_idx, int cb, const float lambda, const float uplim, int *bits)
AACCoefficientsEncoder	ff_aac_coders [AAC_CODER_NB]