FFmpeg  4.0
Data Fields
AC3DSPContext Struct Reference

#include <libavcodec/ac3dsp.h>

Data Fields

void(* ac3_exponent_min )(uint8_t *exp, int num_reuse_blocks, int nb_coefs)
 Set each encoded exponent in a block to the minimum of itself and the exponents in the same frequency bin of up to 5 following blocks. More...
 
int(* ac3_max_msb_abs_int16 )(const int16_t *src, int len)
 Calculate the maximum MSB of the absolute value of each element in an array of int16_t. More...
 
void(* ac3_lshift_int16 )(int16_t *src, unsigned int len, unsigned int shift)
 Left-shift each value in an array of int16_t by a specified amount. More...
 
void(* ac3_rshift_int32 )(int32_t *src, unsigned int len, unsigned int shift)
 Right-shift each value in an array of int32_t by a specified amount. More...
 
void(* float_to_fixed24 )(int32_t *dst, const float *src, unsigned int len)
 Convert an array of float in range [-1.0,1.0] to int32_t with range [-(1<<24),(1<<24)]. More...
 
void(* bit_alloc_calc_bap )(int16_t *mask, int16_t *psd, int start, int end, int snr_offset, int floor, const uint8_t *bap_tab, uint8_t *bap)
 Calculate bit allocation pointers. More...
 
void(* update_bap_counts )(uint16_t mant_cnt[16], uint8_t *bap, int len)
 Update bap counts using the supplied array of bap. More...
 
int(* compute_mantissa_size )(uint16_t mant_cnt[6][16])
 Calculate the number of bits needed to encode a set of mantissas. More...
 
void(* extract_exponents )(uint8_t *exp, int32_t *coef, int nb_coefs)
 
void(* sum_square_butterfly_int32 )(int64_t sum[4], const int32_t *coef0, const int32_t *coef1, int len)
 
void(* sum_square_butterfly_float )(float sum[4], const float *coef0, const float *coef1, int len)
 
int out_channels
 
int in_channels
 
void(* downmix )(float **samples, float **matrix, int len)
 
void(* downmix_fixed )(int32_t **samples, int16_t **matrix, int len)
 
void(* apply_window_int16 )(int16_t *output, const int16_t *input, const int16_t *window, unsigned int len)
 Apply symmetric window in 16-bit fixed-point. More...
 

Detailed Description

Definition at line 33 of file ac3dsp.h.

Field Documentation

◆ ac3_exponent_min

void(* AC3DSPContext::ac3_exponent_min) (uint8_t *exp, int num_reuse_blocks, int nb_coefs)

Set each encoded exponent in a block to the minimum of itself and the exponents in the same frequency bin of up to 5 following blocks.

Parameters
exppointer to the start of the current block of exponents. constraints: align 16
num_reuse_blocksnumber of blocks that will reuse exponents from the current block. constraints: range 0 to 5
nb_coefsnumber of frequency coefficients.

Definition at line 43 of file ac3dsp.h.

Referenced by encode_exponents(), ff_ac3dsp_init(), ff_ac3dsp_init_arm(), and ff_ac3dsp_init_x86().

◆ ac3_max_msb_abs_int16

int(* AC3DSPContext::ac3_max_msb_abs_int16) (const int16_t *src, int len)

Calculate the maximum MSB of the absolute value of each element in an array of int16_t.

Parameters
srcinput array constraints: align 16. values must be in range [-32767,32767]
lennumber of values in the array constraints: multiple of 16 greater than 0
Returns
a value with the same MSB as max(abs(src[]))

Definition at line 54 of file ac3dsp.h.

Referenced by ff_ac3dsp_init(), ff_ac3dsp_init_arm(), ff_ac3dsp_init_x86(), and normalize_samples().

◆ ac3_lshift_int16

void(* AC3DSPContext::ac3_lshift_int16) (int16_t *src, unsigned int len, unsigned int shift)

Left-shift each value in an array of int16_t by a specified amount.

Parameters
srcinput array constraints: align 16
lennumber of values in the array constraints: multiple of 32 greater than 0
shiftleft shift amount constraints: range [0,15]

Definition at line 65 of file ac3dsp.h.

Referenced by ff_ac3dsp_init(), ff_ac3dsp_init_arm(), ff_ac3dsp_init_x86(), and normalize_samples().

◆ ac3_rshift_int32

void(* AC3DSPContext::ac3_rshift_int32) (int32_t *src, unsigned int len, unsigned int shift)

Right-shift each value in an array of int32_t by a specified amount.

Parameters
srcinput array constraints: align 16
lennumber of values in the array constraints: multiple of 16 greater than 0
shiftright shift amount constraints: range [0,31]

Definition at line 76 of file ac3dsp.h.

Referenced by ff_ac3dsp_init(), ff_ac3dsp_init_arm(), ff_ac3dsp_init_x86(), and scale_coefficients().

◆ float_to_fixed24

void(* AC3DSPContext::float_to_fixed24) (int32_t *dst, const float *src, unsigned int len)

Convert an array of float in range [-1.0,1.0] to int32_t with range [-(1<<24),(1<<24)].

Parameters
dstdestination array of int32_t. constraints: 16-byte aligned
srcsource array of float. constraints: 16-byte aligned
lennumber of elements to convert. constraints: multiple of 32 greater than zero

Definition at line 89 of file ac3dsp.h.

Referenced by apply_channel_coupling(), ff_ac3dsp_init(), ff_ac3dsp_init_arm(), ff_ac3dsp_init_mips(), ff_ac3dsp_init_x86(), and scale_coefficients().

◆ bit_alloc_calc_bap

void(* AC3DSPContext::bit_alloc_calc_bap) (int16_t *mask, int16_t *psd, int start, int end, int snr_offset, int floor, const uint8_t *bap_tab, uint8_t *bap)

Calculate bit allocation pointers.

The SNR is the difference between the masking curve and the signal. AC-3 uses this value for each frequency bin to allocate bits. The snroffset parameter is a global adjustment to the SNR for all bins.

Parameters
[in]maskmasking curve
[in]psdsignal power for each frequency bin
[in]startstarting bin location
[in]endending bin location
[in]snr_offsetSNR adjustment
[in]floornoise floor
[in]bap_tablook-up table for bit allocation pointers
[out]bapbit allocation pointers

Definition at line 106 of file ac3dsp.h.

Referenced by bit_alloc(), ff_ac3dsp_init(), ff_ac3dsp_init_arm(), and ff_ac3dsp_init_mips().

◆ update_bap_counts

void(* AC3DSPContext::update_bap_counts) (uint16_t mant_cnt[16], uint8_t *bap, int len)

Update bap counts using the supplied array of bap.

Parameters
[out]mant_cntbap counts for 1 block
[in]baparray of bap, pointing to start coef bin
[in]lennumber of elements to process

Definition at line 117 of file ac3dsp.h.

Referenced by count_mantissa_bits_update_ch(), ff_ac3dsp_init(), ff_ac3dsp_init_arm(), and ff_ac3dsp_init_mips().

◆ compute_mantissa_size

int(* AC3DSPContext::compute_mantissa_size) (uint16_t mant_cnt[6][16])

Calculate the number of bits needed to encode a set of mantissas.

Parameters
[in]mant_cntbap counts for all blocks
Returns
mantissa bit count

Definition at line 125 of file ac3dsp.h.

Referenced by count_mantissa_bits(), ff_ac3dsp_init(), and ff_ac3dsp_init_x86().

◆ extract_exponents

void(* AC3DSPContext::extract_exponents) (uint8_t *exp, int32_t *coef, int nb_coefs)

◆ sum_square_butterfly_int32

void(* AC3DSPContext::sum_square_butterfly_int32) (int64_t sum[4], const int32_t *coef0, const int32_t *coef1, int len)

Definition at line 129 of file ac3dsp.h.

Referenced by ff_ac3dsp_init(), ff_ac3dsp_init_arm(), and sum_square_butterfly().

◆ sum_square_butterfly_float

void(* AC3DSPContext::sum_square_butterfly_float) (float sum[4], const float *coef0, const float *coef1, int len)

Definition at line 132 of file ac3dsp.h.

Referenced by ff_ac3dsp_init(), ff_ac3dsp_init_arm(), and sum_square_butterfly().

◆ out_channels

int AC3DSPContext::out_channels

Definition at line 135 of file ac3dsp.h.

Referenced by ff_ac3dsp_downmix(), ff_ac3dsp_downmix_fixed(), and ff_ac3dsp_init().

◆ in_channels

int AC3DSPContext::in_channels

Definition at line 136 of file ac3dsp.h.

Referenced by ff_ac3dsp_downmix(), ff_ac3dsp_downmix_fixed(), and ff_ac3dsp_init().

◆ downmix

void(* AC3DSPContext::downmix) (float **samples, float **matrix, int len)

Definition at line 137 of file ac3dsp.h.

Referenced by ff_ac3dsp_downmix(), and ff_ac3dsp_init().

◆ downmix_fixed

void(* AC3DSPContext::downmix_fixed) (int32_t **samples, int16_t **matrix, int len)

Definition at line 138 of file ac3dsp.h.

Referenced by ff_ac3dsp_downmix_fixed(), and ff_ac3dsp_init().

◆ apply_window_int16

void(* AC3DSPContext::apply_window_int16) (int16_t *output, const int16_t *input, const int16_t *window, unsigned int len)

Apply symmetric window in 16-bit fixed-point.

Parameters
outputdestination array constraints: 16-byte aligned
inputsource array constraints: 16-byte aligned
windowwindow array constraints: 16-byte aligned, at least len/2 elements
lenfull window length constraints: multiple of ? greater than zero

Definition at line 151 of file ac3dsp.h.

Referenced by apply_mdct(), ff_ac3dsp_init(), ff_ac3dsp_init_arm(), and ff_ac3dsp_init_x86().


The documentation for this struct was generated from the following file: