ac3enc.h File Reference

AC-3 encoder & E-AC-3 encoder common header. More...

#include <stdint.h>
#include "libavutil/float_dsp.h"
#include "ac3.h"
#include "ac3dsp.h"
#include "avcodec.h"
#include "fft.h"
#include "mathops.h"
#include "me_cmp.h"
#include "put_bits.h"
#include "audiodsp.h"

Go to the source code of this file.

Classes
struct	AC3EncOptions
	Encoding Options used by AVOption. More...
struct	AC3Block
	Data for a single audio block. More...
struct	AC3EncodeContext
	AC-3 encoder private context. More...

Macros
#define	CONFIG_AC3ENC_FLOAT   0
#define	OFFSET(param)   offsetof(AC3EncodeContext, options.param)
#define	AC3ENC_PARAM   (AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_ENCODING_PARAM)
#define	AC3ENC_TYPE_AC3_FIXED   0
#define	AC3ENC_TYPE_AC3   1
#define	AC3ENC_TYPE_EAC3   2
#define	AC3_NAME(x)   ff_ac3_fixed_ ## x
#define	MAC_COEF(d, a, b)   MAC64(d,a,b)
#define	COEF_MIN   -16777215
#define	COEF_MAX   16777215
#define	NEW_CPL_COORD_THRESHOLD   503317
#define	AC3ENC_OPT_NONE   -1
#define	AC3ENC_OPT_AUTO   -1
#define	AC3ENC_OPT_OFF   0
#define	AC3ENC_OPT_ON   1
#define	AC3ENC_OPT_NOT_INDICATED   0
#define	AC3ENC_OPT_MODE_ON   2
#define	AC3ENC_OPT_MODE_OFF   1
#define	AC3ENC_OPT_DSUREX_DPLIIZ   3
#define	AC3ENC_OPT_LARGE_ROOM   1
#define	AC3ENC_OPT_SMALL_ROOM   2
#define	AC3ENC_OPT_DOWNMIX_LTRT   1
#define	AC3ENC_OPT_DOWNMIX_LORO   2
#define	AC3ENC_OPT_DOWNMIX_DPLII   3
#define	AC3ENC_OPT_ADCONV_STANDARD   0
#define	AC3ENC_OPT_ADCONV_HDCD   1

Typedefs
typedef int16_t	SampleType
typedef int32_t	CoefType
typedef int64_t	CoefSumType
typedef struct AC3EncOptions	AC3EncOptions
	Encoding Options used by AVOption.
typedef struct AC3Block	AC3Block
	Data for a single audio block.
typedef struct AC3EncodeContext	AC3EncodeContext
	AC-3 encoder private context.

Functions
int	ff_ac3_encode_init (AVCodecContext *avctx)
int	ff_ac3_float_encode_init (AVCodecContext *avctx)
int	ff_ac3_encode_close (AVCodecContext *avctx)
	Finalize encoding and free any memory allocated by the encoder. More...
int	ff_ac3_validate_metadata (AC3EncodeContext *s)
	Validate metadata options as set by AVOption system. More...
void	ff_ac3_adjust_frame_size (AC3EncodeContext *s)
	Adjust the frame size to make the average bit rate match the target bit rate. More...
void	ff_ac3_compute_coupling_strategy (AC3EncodeContext *s)
	Set the initial coupling strategy parameters prior to coupling analysis. More...
void	ff_ac3_apply_rematrixing (AC3EncodeContext *s)
	Apply stereo rematrixing to coefficients based on rematrixing flags. More...
void	ff_ac3_process_exponents (AC3EncodeContext *s)
	Calculate final exponents from the supplied MDCT coefficients and exponent shift. More...
int	ff_ac3_compute_bit_allocation (AC3EncodeContext *s)
void	ff_ac3_group_exponents (AC3EncodeContext *s)
	Group exponents. More...
void	ff_ac3_quantize_mantissas (AC3EncodeContext *s)
	Quantize mantissas using coefficients, exponents, and bit allocation pointers. More...
void	ff_ac3_output_frame (AC3EncodeContext *s, unsigned char *frame)
	Write the frame to the output bitstream. More...
void	ff_ac3_fixed_mdct_end (AC3EncodeContext *s)
	Finalize MDCT and free allocated memory. More...
void	ff_ac3_float_mdct_end (AC3EncodeContext *s)
	Finalize MDCT and free allocated memory. More...
int	ff_ac3_fixed_mdct_init (AC3EncodeContext *s)
	Initialize MDCT tables. More...
int	ff_ac3_float_mdct_init (AC3EncodeContext *s)
	Initialize MDCT tables. More...
int	ff_ac3_fixed_allocate_sample_buffers (AC3EncodeContext *s)
int	ff_ac3_float_allocate_sample_buffers (AC3EncodeContext *s)
int	ff_ac3_fixed_encode_frame (AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
int	ff_ac3_float_encode_frame (AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)

Variables
const uint64_t	ff_ac3_channel_layouts [19]
	List of supported channel layouts.

Detailed Description

AC-3 encoder & E-AC-3 encoder common header.

Function Documentation

ff_ac3_adjust_frame_size()

void ff_ac3_adjust_frame_size

(

AC3EncodeContext *

s

)

Adjust the frame size to make the average bit rate match the target bit rate.

This is only needed for 11025, 22050, and 44100 sample rates or any E-AC-3.

Parameters

s	AC-3 encoder private context

ff_ac3_apply_rematrixing()

void ff_ac3_apply_rematrixing

(

AC3EncodeContext *

s

)

Apply stereo rematrixing to coefficients based on rematrixing flags.

Parameters

s	AC-3 encoder private context

ff_ac3_compute_coupling_strategy()

void ff_ac3_compute_coupling_strategy

(

AC3EncodeContext *

s

)

Set the initial coupling strategy parameters prior to coupling analysis.

Parameters

s	AC-3 encoder private context

ff_ac3_encode_close()

int ff_ac3_encode_close

(

AVCodecContext *

avctx

)

Finalize encoding and free any memory allocated by the encoder.

Parameters

avctx

Codec context

ff_ac3_fixed_mdct_end()

void ff_ac3_fixed_mdct_end

(

AC3EncodeContext *

s

)

Finalize MDCT and free allocated memory.

Parameters

s	AC-3 encoder private context

ff_ac3_fixed_mdct_init()

int ff_ac3_fixed_mdct_init

(

AC3EncodeContext *

s

)

Initialize MDCT tables.

Parameters

s	AC-3 encoder private context

Returns

0 on success, negative error code on failure

ff_ac3_float_mdct_end()

void ff_ac3_float_mdct_end

(

AC3EncodeContext *

s

)

Finalize MDCT and free allocated memory.

Parameters

s	AC-3 encoder private context

ff_ac3_float_mdct_init()

int ff_ac3_float_mdct_init

(

AC3EncodeContext *

s

)

Initialize MDCT tables.

Parameters

s	AC-3 encoder private context

Returns

0 on success, negative error code on failure

ff_ac3_group_exponents()

void ff_ac3_group_exponents

(

AC3EncodeContext *

s

)

Group exponents.

3 delta-encoded exponents are in each 7-bit group. The number of groups varies depending on exponent strategy and bandwidth.

Parameters

s	AC-3 encoder private context

ff_ac3_output_frame()

void ff_ac3_output_frame	(	AC3EncodeContext *	s,
		unsigned char *	frame
	)

Write the frame to the output bitstream.

Parameters

s	AC-3 encoder private context
frame	output data buffer

ff_ac3_process_exponents()

void ff_ac3_process_exponents

(

AC3EncodeContext *

s

)

Calculate final exponents from the supplied MDCT coefficients and exponent shift.

Extract exponents from MDCT coefficients, calculate exponent strategies, and encode final exponents.

Parameters

s	AC-3 encoder private context

ff_ac3_quantize_mantissas()

void ff_ac3_quantize_mantissas

(

AC3EncodeContext *

s

)

Quantize mantissas using coefficients, exponents, and bit allocation pointers.

Parameters

s	AC-3 encoder private context

ff_ac3_validate_metadata()

int ff_ac3_validate_metadata

(

AC3EncodeContext *

s

)

Validate metadata options as set by AVOption system.

These values can optionally be changed per-frame.

Parameters

s	AC-3 encoder private context