#include "libavutil/channel_layout.h"
#include "libavutil/thread.h"
#include "internal.h"

Data Structures
struct	elem_to_channel

Macros
#define	overread_err "Input buffer exhausted before END element found\n"

#define	PREFIX_FOR_22POINT2 (AV_CH_LAYOUT_7POINT1_WIDE_BACK\|AV_CH_BACK_CENTER\|AV_CH_SIDE_LEFT\|AV_CH_SIDE_RIGHT\|AV_CH_LOW_FREQUENCY_2)

#define	AACDEC_FLAGS AV_OPT_FLAG_DECODING_PARAM \| AV_OPT_FLAG_AUDIO_PARAM
	AVOptions for Japanese DTV specific extensions (ADTS only) More...

Functions
static int	output_configure (AACContext ac, uint8_t layout_map[MAX_ELEM_ID 4][3], int tags, enum OCStatus oc_type, int get_new_frame)
	Configure output channel order based on the current program configuration element. More...

static int	count_channels (uint8_t(*layout)[3], int tags)

static av_cold int	che_configure (AACContext ac, enum ChannelPosition che_pos, int type, int id, int channels)
	Check for the channel element in the current channel position configuration. More...

static int	frame_configure_elements (AVCodecContext *avctx)

static int	assign_pair (struct elem_to_channel e2c_vec[MAX_ELEM_ID], uint8_t(layout_map)[3], int offset, uint64_t left, uint64_t right, int pos, uint64_t layout)

static int	count_paired_channels (uint8_t(layout_map)[3], int tags, int pos, int current)

static uint64_t	sniff_channel_order (uint8_t(*layout_map)[3], int tags)

static int	push_output_configuration (AACContext *ac)
	Save current output configuration if and only if it has been locked. More...

static void	pop_output_configuration (AACContext *ac)
	Restore the previous output configuration if and only if the current configuration is unlocked. More...

static void	flush (AVCodecContext *avctx)

static int	set_default_channel_config (AACContext ac, AVCodecContext avctx, uint8_t(layout_map)[3], int tags, int channel_config)
	Set up channel positions based on a default channel configuration as specified in table 1.17. More...

static ChannelElement *	get_che (AACContext *ac, int type, int elem_id)

static void	decode_channel_map (uint8_t layout_map[][3], enum ChannelPosition type, GetBitContext *gb, int n)
	Decode an array of 4 bit element IDs, optionally interleaved with a stereo/mono switching bit. More...

static void	relative_align_get_bits (GetBitContext *gb, int reference_position)

static int	decode_pce (AVCodecContext avctx, MPEG4AudioConfig m4ac, uint8_t(layout_map)[3], GetBitContext gb, int byte_align_ref)
	Decode program configuration element; reference: table 4.2. More...

static int	decode_ga_specific_config (AACContext ac, AVCodecContext avctx, GetBitContext gb, int get_bit_alignment, MPEG4AudioConfig m4ac, int channel_config)
	Decode GA "General Audio" specific configuration; reference: table 4.1. More...

static int	decode_eld_specific_config (AACContext ac, AVCodecContext avctx, GetBitContext gb, MPEG4AudioConfig m4ac, int channel_config)

static int	decode_audio_specific_config_gb (AACContext ac, AVCodecContext avctx, MPEG4AudioConfig m4ac, GetBitContext gb, int get_bit_alignment, int sync_extension)
	Decode audio specific configuration; reference: table 1.13. More...

static int	decode_audio_specific_config (AACContext ac, AVCodecContext avctx, MPEG4AudioConfig m4ac, const uint8_t data, int64_t bit_size, int sync_extension)

static av_always_inline int	lcg_random (unsigned previous_val)
	linear congruential pseudorandom number generator More...

static void	reset_all_predictors (PredictorState *ps)

static int	sample_rate_idx (int rate)

static void	reset_predictor_group (PredictorState *ps, int group_num)

static void	aacdec_init (AACContext *ac)

static av_cold void	aac_static_table_init (void)

static av_cold int	aac_decode_init (AVCodecContext *avctx)

static int	skip_data_stream_element (AACContext ac, GetBitContext gb)
	Skip data_stream_element; reference: table 4.10. More...

static int	decode_prediction (AACContext ac, IndividualChannelStream ics, GetBitContext *gb)

static void	decode_ltp (LongTermPrediction ltp, GetBitContext gb, uint8_t max_sfb)
	Decode Long Term Prediction data; reference: table 4.xx. More...

static int	decode_ics_info (AACContext ac, IndividualChannelStream ics, GetBitContext *gb)
	Decode Individual Channel Stream info; reference: table 4.6. More...

static int	decode_band_types (AACContext ac, enum BandType band_type[120], int band_type_run_end[120], GetBitContext gb, IndividualChannelStream *ics)
	Decode band types (section_data payload); reference: table 4.46. More...

static int	decode_scalefactors (AACContext ac, INTFLOAT sf[120], GetBitContext gb, unsigned int global_gain, IndividualChannelStream *ics, enum BandType band_type[120], int band_type_run_end[120])
	Decode scalefactors; reference: table 4.47. More...

static int	decode_pulses (Pulse pulse, GetBitContext gb, const uint16_t *swb_offset, int num_swb)
	Decode pulse data; reference: table 4.7. More...

static int	decode_tns (AACContext ac, TemporalNoiseShaping tns, GetBitContext gb, const IndividualChannelStream ics)
	Decode Temporal Noise Shaping data; reference: table 4.48. More...

static void	decode_mid_side_stereo (ChannelElement cpe, GetBitContext gb, int ms_present)
	Decode Mid/Side data; reference: table 4.54. More...

static int	decode_spectrum_and_dequant (AACContext ac, INTFLOAT coef[1024], GetBitContext gb, const INTFLOAT sf[120], int pulse_present, const Pulse pulse, const IndividualChannelStream ics, enum BandType band_type[120])
	Decode spectral data; reference: table 4.50. More...

static void	apply_prediction (AACContext ac, SingleChannelElement sce)
	Apply AAC-Main style frequency domain prediction. More...

static void	decode_gain_control (SingleChannelElement sce, GetBitContext gb)

static int	decode_ics (AACContext ac, SingleChannelElement sce, GetBitContext *gb, int common_window, int scale_flag)
	Decode an individual_channel_stream payload; reference: table 4.44. More...

static void	apply_mid_side_stereo (AACContext ac, ChannelElement cpe)
	Mid/Side stereo decoding; reference: 4.6.8.1.3. More...

static void	apply_intensity_stereo (AACContext ac, ChannelElement cpe, int ms_present)
	intensity stereo decoding; reference: 4.6.8.2.3 More...

static int	decode_cpe (AACContext ac, GetBitContext gb, ChannelElement *cpe)
	Decode a channel_pair_element; reference: table 4.4. More...

static int	decode_cce (AACContext ac, GetBitContext gb, ChannelElement *che)
	Decode coupling_channel_element; reference: table 4.8. More...

static int	decode_drc_channel_exclusions (DynamicRangeControl che_drc, GetBitContext gb)
	Parse whether channels are to be excluded from Dynamic Range Compression; reference: table 4.53. More...

static int	decode_dynamic_range (DynamicRangeControl che_drc, GetBitContext gb)
	Decode dynamic range information; reference: table 4.52. More...

static int	decode_fill (AACContext ac, GetBitContext gb, int len)

static int	decode_extension_payload (AACContext ac, GetBitContext gb, int cnt, ChannelElement *che, enum RawDataBlockType elem_type)
	Decode extension data (incomplete); reference: table 4.51. More...

static void	apply_tns (INTFLOAT coef_param[1024], TemporalNoiseShaping tns, IndividualChannelStream ics, int decode)
	Decode Temporal Noise Shaping filter coefficients and apply all-pole filters; reference: 4.6.9.3. More...

static void	windowing_and_mdct_ltp (AACContext ac, INTFLOAT out, INTFLOAT in, IndividualChannelStream ics)
	Apply windowing and MDCT to obtain the spectral coefficient from the predicted sample by LTP. More...

static void	apply_ltp (AACContext ac, SingleChannelElement sce)
	Apply the long term prediction. More...

static void	update_ltp (AACContext ac, SingleChannelElement sce)
	Update the LTP buffer for next frame. More...

static void	imdct_and_windowing (AACContext ac, SingleChannelElement sce)
	Conduct IMDCT and windowing. More...

static void	imdct_and_windowing_960 (AACContext ac, SingleChannelElement sce)
	Conduct IMDCT and windowing. More...

static void	imdct_and_windowing_ld (AACContext ac, SingleChannelElement sce)

static void	imdct_and_windowing_eld (AACContext ac, SingleChannelElement sce)

static void	apply_channel_coupling (AACContext ac, ChannelElement cc, enum RawDataBlockType type, int elem_id, enum CouplingPoint coupling_point, void(apply_coupling_method)(AACContext ac, SingleChannelElement target, ChannelElement cce, int index))
	channel coupling transformation interface More...

static void	spectral_to_sample (AACContext *ac, int samples)
	Convert spectral data to samples, applying all supported tools as appropriate. More...

static int	parse_adts_frame_header (AACContext ac, GetBitContext gb)

static int	aac_decode_er_frame (AVCodecContext avctx, void data, int got_frame_ptr, GetBitContext gb)

static int	aac_decode_frame_int (AVCodecContext avctx, AVFrame frame, int got_frame_ptr, GetBitContext gb, const AVPacket *avpkt)

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

static av_cold int	aac_decode_close (AVCodecContext *avctx)

Variables
static VLC	vlc_scalefactors

static VLC	vlc_spectral [11]

static AVOnce	aac_table_init = AV_ONCE_INIT

static const float	cce_scale []

static const AVOption	options []

static const AVClass	aac_decoder_class

Detailed Description

AAC decoder

Author: Oded Shimon ( ods15 ods15 dyndns org ); Maxim Gavrilov ( maxim.gavrilov gmail com )

AAC decoder fixed-point implementation

Author: Stanislav Ocovaj ( stanislav.ocovaj imgtec com ); Nedeljko Babic ( nedeljko.babic imgtec com )

Definition in file aacdec_template.c.

Macro Definition Documentation

◆ overread_err

#define overread_err "Input buffer exhausted before END element found\n"

Definition at line 103 of file aacdec_template.c.

◆ PREFIX_FOR_22POINT2

#define PREFIX_FOR_22POINT2 (AV_CH_LAYOUT_7POINT1_WIDE_BACK|AV_CH_BACK_CENTER|AV_CH_SIDE_LEFT|AV_CH_SIDE_RIGHT|AV_CH_LOW_FREQUENCY_2)

Definition at line 271 of file aacdec_template.c.

◆ AACDEC_FLAGS

#define AACDEC_FLAGS AV_OPT_FLAG_DECODING_PARAM | AV_OPT_FLAG_AUDIO_PARAM

AVOptions for Japanese DTV specific extensions (ADTS only)

Definition at line 3564 of file aacdec_template.c.

Function Documentation

◆ output_configure()

static int output_configure	(	AACContext *	ac,
		uint8_t	layout_map[MAX_ELEM_ID *4][3],
		int	tags,
		enum OCStatus	oc_type,
		int	get_new_frame
	)

static

Configure output channel order based on the current program configuration element.

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 533 of file aacdec_template.c.

Referenced by aac_decode_frame_int(), aac_decode_init(), decode_eld_specific_config(), decode_extension_payload(), decode_ga_specific_config(), get_che(), parse_adts_frame_header(), and pop_output_configuration().

◆ count_channels()

static int count_channels	(	uint8_t(*)	layout[3],
		int	tags
	)

static

Definition at line 105 of file aacdec_template.c.

Referenced by decode_ga_specific_config().

◆ che_configure()

static av_cold int che_configure	(	AACContext *	ac,
		enum ChannelPosition	che_pos,
		int	type,
		int	id,
		int *	channels
	)

static

Check for the channel element in the current channel position configuration.

If it exists, make sure the appropriate element is allocated and map the channel order to match the internal FFmpeg channel layout.

Parameters

che_pos	current channel position configuration
type	channel element type
id	channel element id
channels	count of the number of channels in the configuration

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 129 of file aacdec_template.c.

Referenced by output_configure().

◆ frame_configure_elements()

static int frame_configure_elements ( AVCodecContext * avctx )

static

Definition at line 160 of file aacdec_template.c.

Referenced by aac_decode_er_frame(), aac_decode_frame_int(), and output_configure().

◆ assign_pair()

static int assign_pair	(	struct elem_to_channel	e2c_vec[MAX_ELEM_ID],
		uint8_t(*)	layout_map[3],
		int	offset,
		uint64_t	left,
		uint64_t	right,
		int	pos,
		uint64_t *	layout
	)

static

Definition at line 201 of file aacdec_template.c.

Referenced by sniff_channel_order().

◆ count_paired_channels()

static int count_paired_channels	(	uint8_t(*)	layout_map[3],
		int	tags,
		int	pos,
		int *	current
	)

static

Definition at line 239 of file aacdec_template.c.

Referenced by sniff_channel_order().

◆ sniff_channel_order()

static uint64_t sniff_channel_order	(	uint8_t(*)	layout_map[3],
		int	tags
	)

static

Definition at line 272 of file aacdec_template.c.

Referenced by output_configure().

◆ push_output_configuration()

static int push_output_configuration ( AACContext * ac )

static

Save current output configuration if and only if it has been locked.

Definition at line 503 of file aacdec_template.c.

Referenced by aac_decode_frame_int(), get_che(), latm_decode_frame(), and parse_adts_frame_header().

◆ pop_output_configuration()

static void pop_output_configuration ( AACContext * ac )

static

Restore the previous output configuration if and only if the current configuration is unlocked.

Definition at line 518 of file aacdec_template.c.

Referenced by aac_decode_frame_int(), and latm_decode_frame().

◆ flush()

static void flush ( AVCodecContext * avctx )

static

Examples: transcoding.c.

Definition at line 606 of file aacdec_template.c.

Referenced by bmp_parse(), chunk_end(), decode_read(), dpx_parse(), ds_run(), encode_write_frame(), ff_hevc_output_frame(), ff_interleave_packet_per_dts(), ff_vk_unmap_buffers(), gxf_interleave_packet(), interleaved_write_packet(), mpegaudio_parse(), mxf_interleave(), mxf_interleave_get_packet(), ogg_buffer_data(), ogg_write_pages(), output_packet(), output_ready(), parse_packet(), png_parse(), reap_filters(), unmap_buffers(), and webp_parse().

◆ set_default_channel_config()

static int set_default_channel_config	(	AACContext *	ac,
		AVCodecContext *	avctx,
		uint8_t(*)	layout_map[3],
		int *	tags,
		int	channel_config
	)

static

Set up channel positions based on a default channel configuration as specified in table 1.17.

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 629 of file aacdec_template.c.

Referenced by aac_decode_init(), decode_eld_specific_config(), decode_ga_specific_config(), get_che(), and parse_adts_frame_header().

◆ get_che()

static ChannelElement* get_che	(	AACContext *	ac,
		int	type,
		int	elem_id
	)

static

Definition at line 669 of file aacdec_template.c.

Referenced by aac_decode_er_frame(), and aac_decode_frame_int().

◆ decode_channel_map()

static void decode_channel_map	(	uint8_t	layout_map[][3],
		enum ChannelPosition	type,
		GetBitContext *	gb,
		int	n
	)

static

Decode an array of 4 bit element IDs, optionally interleaved with a stereo/mono switching bit.

Parameters

type	speaker type/position for these channels

Definition at line 811 of file aacdec_template.c.

Referenced by decode_pce().

◆ relative_align_get_bits()

static void relative_align_get_bits	(	GetBitContext *	gb,
		int	reference_position
	)

inlinestatic

Definition at line 841 of file aacdec_template.c.

Referenced by decode_pce().

◆ decode_pce()

static int decode_pce	(	AVCodecContext *	avctx,
		MPEG4AudioConfig *	m4ac,
		uint8_t(*)	layout_map[3],
		GetBitContext *	gb,
		int	byte_align_ref
	)

static

Decode program configuration element; reference: table 4.2.

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 853 of file aacdec_template.c.

Referenced by aac_decode_frame_int(), and decode_ga_specific_config().

◆ decode_ga_specific_config()

static int decode_ga_specific_config	(	AACContext *	ac,
		AVCodecContext *	avctx,
		GetBitContext *	gb,
		int	get_bit_alignment,
		MPEG4AudioConfig *	m4ac,
		int	channel_config
	)

static

Decode GA "General Audio" specific configuration; reference: table 4.1.

Parameters

ac	pointer to AACContext, may be null
avctx	pointer to AVCCodecContext, used for logging

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 923 of file aacdec_template.c.

Referenced by decode_audio_specific_config_gb().

◆ decode_eld_specific_config()

static int decode_eld_specific_config	(	AACContext *	ac,
		AVCodecContext *	avctx,
		GetBitContext *	gb,
		MPEG4AudioConfig *	m4ac,
		int	channel_config
	)

static

Definition at line 1012 of file aacdec_template.c.

Referenced by decode_audio_specific_config_gb().

◆ decode_audio_specific_config_gb()

static int decode_audio_specific_config_gb	(	AACContext *	ac,
		AVCodecContext *	avctx,
		MPEG4AudioConfig *	m4ac,
		GetBitContext *	gb,
		int	get_bit_alignment,
		int	sync_extension
	)

static

Decode audio specific configuration; reference: table 1.13.

Parameters

ac	pointer to AACContext, may be null
avctx	pointer to AVCCodecContext, used for logging
m4ac	pointer to MPEG4AudioConfig, used for parsing
gb	buffer holding an audio specific config
get_bit_alignment	relative alignment for byte align operations
sync_extension	look for an appended sync extension

Returns: Returns error status or number of consumed bits. <0 - error

Definition at line 1087 of file aacdec_template.c.

Referenced by decode_audio_specific_config(), and latm_decode_audio_specific_config().

◆ decode_audio_specific_config()

static int decode_audio_specific_config	(	AACContext *	ac,
		AVCodecContext *	avctx,
		MPEG4AudioConfig *	m4ac,
		const uint8_t *	data,
		int64_t	bit_size,
		int	sync_extension
	)

static

Definition at line 1154 of file aacdec_template.c.

Referenced by aac_decode_frame(), aac_decode_init(), and latm_decode_frame().

◆ lcg_random()

static av_always_inline int lcg_random ( unsigned previous_val )

static

linear congruential pseudorandom number generator

Parameters

previous_val pointer to the current state of the generator

Returns: Returns a 32-bit pseudorandom integer

Definition at line 1187 of file aacdec_template.c.

Referenced by decode_spectrum_and_dequant(), and search_for_pns().

◆ reset_all_predictors()

static void reset_all_predictors ( PredictorState * ps )

static

Definition at line 1193 of file aacdec_template.c.

Referenced by apply_prediction().

◆ sample_rate_idx()

static int sample_rate_idx ( int rate )

static

Definition at line 1200 of file aacdec_template.c.

Referenced by aac_decode_init().

◆ reset_predictor_group()

static void reset_predictor_group	(	PredictorState *	ps,
		int	group_num
	)

static

Definition at line 1216 of file aacdec_template.c.

Referenced by apply_prediction().

◆ aacdec_init()

static void aacdec_init ( AACContext * ac )

static

Definition at line 3543 of file aacdec_template.c.

Referenced by aac_decode_init().

◆ aac_static_table_init()

static av_cold void aac_static_table_init ( void )

static

Definition at line 1225 of file aacdec_template.c.

Referenced by aac_decode_init().

◆ aac_decode_init()

static av_cold int aac_decode_init ( AVCodecContext * avctx )

static

Definition at line 1276 of file aacdec_template.c.

Referenced by latm_decode_init().

◆ skip_data_stream_element()

static int skip_data_stream_element	(	AACContext *	ac,
		GetBitContext *	gb
	)

static

Skip data_stream_element; reference: table 4.10.

Definition at line 1372 of file aacdec_template.c.

Referenced by aac_decode_frame_int().

◆ decode_prediction()

static int decode_prediction	(	AACContext *	ac,
		IndividualChannelStream *	ics,
		GetBitContext *	gb
	)

static

Definition at line 1389 of file aacdec_template.c.

Referenced by decode_ics_info().

◆ decode_ltp()

static void decode_ltp	(	LongTermPrediction *	ltp,
		GetBitContext *	gb,
		uint8_t	max_sfb
	)

static

Decode Long Term Prediction data; reference: table 4.xx.

Definition at line 1411 of file aacdec_template.c.

Referenced by decode_cpe(), and decode_ics_info().

◆ decode_ics_info()

static int decode_ics_info	(	AACContext *	ac,
		IndividualChannelStream *	ics,
		GetBitContext *	gb
	)

static

Decode Individual Channel Stream info; reference: table 4.6.

Definition at line 1425 of file aacdec_template.c.

Referenced by decode_cpe(), and decode_ics().

◆ decode_band_types()

static int decode_band_types	(	AACContext *	ac,
		enum BandType	band_type[120],
		int	band_type_run_end[120],
		GetBitContext *	gb,
		IndividualChannelStream *	ics
	)

static

Decode band types (section_data payload); reference: table 4.46.

Parameters

band_type	array of the used band type
band_type_run_end	array of the last scalefactor band of a band type run

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 1551 of file aacdec_template.c.

Referenced by decode_ics().

◆ decode_scalefactors()

static int decode_scalefactors	(	AACContext *	ac,
		INTFLOAT	sf[120],
		GetBitContext *	gb,
		unsigned int	global_gain,
		IndividualChannelStream *	ics,
		enum BandType	band_type[120],
		int	band_type_run_end[120]
	)

static

Decode scalefactors; reference: table 4.47.

Parameters

global_gain	first scalefactor value as scalefactors are differentially coded
band_type	array of the used band type
band_type_run_end	array of the last scalefactor band of a band type run
sf	array of scalefactors or intensity stereo positions

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 1600 of file aacdec_template.c.

Referenced by decode_ics().

◆ decode_pulses()

static int decode_pulses	(	Pulse *	pulse,
		GetBitContext *	gb,
		const uint16_t *	swb_offset,
		int	num_swb
	)

static

Decode pulse data; reference: table 4.7.

Definition at line 1675 of file aacdec_template.c.

Referenced by decode_ics().

◆ decode_tns()

static int decode_tns	(	AACContext *	ac,
		TemporalNoiseShaping *	tns,
		GetBitContext *	gb,
		const IndividualChannelStream *	ics
	)

static

Decode Temporal Noise Shaping data; reference: table 4.48.

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 1702 of file aacdec_template.c.

Referenced by decode_ics().

◆ decode_mid_side_stereo()

static void decode_mid_side_stereo	(	ChannelElement *	cpe,
		GetBitContext *	gb,
		int	ms_present
	)

static

Decode Mid/Side data; reference: table 4.54.

Parameters

ms_present Indicates mid/side stereo presence. [0] mask is all 0s; [1] mask is decoded from bitstream; [2] mask is all 1s; [3] reserved for scalable AAC

Definition at line 1745 of file aacdec_template.c.

Referenced by decode_cpe().

◆ decode_spectrum_and_dequant()

static int decode_spectrum_and_dequant	(	AACContext *	ac,
		INTFLOAT	coef[1024],
		GetBitContext *	gb,
		const INTFLOAT	sf[120],
		int	pulse_present,
		const Pulse *	pulse,
		const IndividualChannelStream *	ics,
		enum BandType	band_type[120]
	)

static

Decode spectral data; reference: table 4.50.

Dequantize and scale spectral data; reference: 4.6.3.3.

Parameters

coef	array of dequantized, scaled spectral data
sf	array of scalefactors or intensity stereo positions
pulse_present	set if pulses are present
pulse	pointer to pulse data struct
band_type	array of the used band type

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 1770 of file aacdec_template.c.

Referenced by decode_ics().

◆ apply_prediction()

static void apply_prediction	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Apply AAC-Main style frequency domain prediction.

Definition at line 2065 of file aacdec_template.c.

Referenced by decode_cpe(), and decode_ics().

◆ decode_gain_control()

static void decode_gain_control	(	SingleChannelElement *	sce,
		GetBitContext *	gb
	)

static

Definition at line 2093 of file aacdec_template.c.

Referenced by decode_ics().

◆ decode_ics()

static int decode_ics	(	AACContext *	ac,
		SingleChannelElement *	sce,
		GetBitContext *	gb,
		int	common_window,
		int	scale_flag
	)

static

Decode an individual_channel_stream payload; reference: table 4.44.

Parameters

common_window	Channels have independent [0], or shared [1], Individual Channel Stream information.
scale_flag	scalable [1] or non-scalable [0] AAC (Unused until scalable AAC is implemented.)

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 2128 of file aacdec_template.c.

Referenced by aac_decode_er_frame(), aac_decode_frame_int(), decode_cce(), and decode_cpe().

◆ apply_mid_side_stereo()

static void apply_mid_side_stereo	(	AACContext *	ac,
		ChannelElement *	cpe
	)

static

Mid/Side stereo decoding; reference: 4.6.8.1.3.

Definition at line 2219 of file aacdec_template.c.

Referenced by decode_cpe().

◆ apply_intensity_stereo()

static void apply_intensity_stereo	(	AACContext *	ac,
		ChannelElement *	cpe,
		int	ms_present
	)

static

intensity stereo decoding; reference: 4.6.8.2.3

Parameters

ms_present Indicates mid/side stereo presence. [0] mask is all 0s; [1] mask is decoded from bitstream; [2] mask is all 1s; [3] reserved for scalable AAC

Definition at line 2257 of file aacdec_template.c.

Referenced by decode_cpe().

◆ decode_cpe()

static int decode_cpe	(	AACContext *	ac,
		GetBitContext *	gb,
		ChannelElement *	cpe
	)

static

Decode a channel_pair_element; reference: table 4.4.

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 2307 of file aacdec_template.c.

Referenced by aac_decode_er_frame(), and aac_decode_frame_int().

◆ decode_cce()

static int decode_cce	(	AACContext *	ac,
		GetBitContext *	gb,
		ChannelElement *	che
	)

static

Decode coupling_channel_element; reference: table 4.8.

Returns: Returns error status. 0 - OK, !0 - error

Definition at line 2360 of file aacdec_template.c.

Referenced by aac_decode_frame_int().

◆ decode_drc_channel_exclusions()

static int decode_drc_channel_exclusions	(	DynamicRangeControl *	che_drc,
		GetBitContext *	gb
	)

static

Parse whether channels are to be excluded from Dynamic Range Compression; reference: table 4.53.

Returns: Returns number of bytes consumed.

Definition at line 2444 of file aacdec_template.c.

Referenced by decode_dynamic_range().

◆ decode_dynamic_range()

static int decode_dynamic_range	(	DynamicRangeControl *	che_drc,
		GetBitContext *	gb
	)

static

Decode dynamic range information; reference: table 4.52.

Returns: Returns number of bytes consumed.

Definition at line 2463 of file aacdec_template.c.

Referenced by decode_extension_payload().

◆ decode_fill()

static int decode_fill	(	AACContext *	ac,
		GetBitContext *	gb,
		int	len
	)

static

Definition at line 2510 of file aacdec_template.c.

Referenced by decode_extension_payload().

◆ decode_extension_payload()

static int decode_extension_payload	(	AACContext *	ac,
		GetBitContext *	gb,
		int	cnt,
		ChannelElement *	che,
		enum RawDataBlockType	elem_type
	)

static

Decode extension data (incomplete); reference: table 4.51.

Parameters

cnt	length of TYPE_FIL syntactic element in bytes

Returns: Returns number of bytes consumed

Definition at line 2543 of file aacdec_template.c.

Referenced by aac_decode_frame_int().

◆ apply_tns()

static void apply_tns	(	INTFLOAT	coef_param[1024],
		TemporalNoiseShaping *	tns,
		IndividualChannelStream *	ics,
		int	decode
	)

static

Decode Temporal Noise Shaping filter coefficients and apply all-pole filters; reference: 4.6.9.3.

Parameters

decode	1 if tool is used normally, 0 if tool is used in LTP.
coef	spectral coefficients

Definition at line 2609 of file aacdec_template.c.

Referenced by aacdec_init().

◆ windowing_and_mdct_ltp()

static void windowing_and_mdct_ltp	(	AACContext *	ac,
		INTFLOAT *	out,
		INTFLOAT *	in,
		IndividualChannelStream *	ics
	)

static

Apply windowing and MDCT to obtain the spectral coefficient from the predicted sample by LTP.

Definition at line 2669 of file aacdec_template.c.

Referenced by aacdec_init().

◆ apply_ltp()

static void apply_ltp	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Apply the long term prediction.

Definition at line 2695 of file aacdec_template.c.

Referenced by aacdec_init().

◆ update_ltp()

static void update_ltp	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Update the LTP buffer for next frame.

Definition at line 2727 of file aacdec_template.c.

Referenced by aacdec_init().

◆ imdct_and_windowing()

static void imdct_and_windowing	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Conduct IMDCT and windowing.

Definition at line 2765 of file aacdec_template.c.

Referenced by aacdec_init().

◆ imdct_and_windowing_960()

static void imdct_and_windowing_960	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Conduct IMDCT and windowing.

Definition at line 2833 of file aacdec_template.c.

Referenced by spectral_to_sample().

◆ imdct_and_windowing_ld()

static void imdct_and_windowing_ld	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Definition at line 2896 of file aacdec_template.c.

Referenced by spectral_to_sample().

◆ imdct_and_windowing_eld()

static void imdct_and_windowing_eld	(	AACContext *	ac,
		SingleChannelElement *	sce
	)

static

Definition at line 2929 of file aacdec_template.c.

Referenced by spectral_to_sample().

◆ apply_channel_coupling()

static void apply_channel_coupling	(	AACContext *	ac,
		ChannelElement *	cc,
		enum RawDataBlockType	type,
		int	elem_id,
		enum CouplingPoint	coupling_point,
		void()(AACContext ac, SingleChannelElement target, ChannelElement cce, int index)	apply_coupling_method
	)

static

channel coupling transformation interface

Parameters

apply_coupling_method pointer to (in)dependent coupling function

Definition at line 3002 of file aacdec_template.c.

Referenced by spectral_to_sample().

◆ spectral_to_sample()

static void spectral_to_sample	(	AACContext *	ac,
		int	samples
	)

static

Convert spectral data to samples, applying all supported tools as appropriate.

Definition at line 3035 of file aacdec_template.c.

Referenced by aac_decode_er_frame(), and aac_decode_frame_int().

◆ parse_adts_frame_header()

static int parse_adts_frame_header	(	AACContext *	ac,
		GetBitContext *	gb
	)

static

dual mono frames in Japanese DTV can have chan_config 0 WITHOUT specifying PCE. thus, set dual mono as default.

Definition at line 3107 of file aacdec_template.c.

Referenced by aac_decode_frame_int().

◆ aac_decode_er_frame()

static int aac_decode_er_frame	(	AVCodecContext *	avctx,
		void *	data,
		int *	got_frame_ptr,
		GetBitContext *	gb
	)

static

Definition at line 3169 of file aacdec_template.c.

Referenced by aac_decode_frame(), and latm_decode_frame().

◆ aac_decode_frame_int()

static int aac_decode_frame_int	(	AVCodecContext *	avctx,
		AVFrame *	frame,
		int *	got_frame_ptr,
		GetBitContext *	gb,
		const AVPacket *	avpkt
	)

static

Definition at line 3241 of file aacdec_template.c.

Referenced by aac_decode_frame(), and latm_decode_frame().

◆ aac_decode_frame()

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

static

Definition at line 3454 of file aacdec_template.c.

◆ aac_decode_close()

static av_cold int aac_decode_close ( AVCodecContext * avctx )

static

Definition at line 3517 of file aacdec_template.c.

Variable Documentation

◆ vlc_scalefactors

VLC vlc_scalefactors

static

Definition at line 96 of file aacdec_template.c.

Referenced by aac_static_table_init(), decode_cce(), and decode_scalefactors().

◆ vlc_spectral

VLC vlc_spectral[11]

static

Definition at line 97 of file aacdec_template.c.

Referenced by aac_static_table_init(), and decode_spectrum_and_dequant().

◆ aac_table_init

AVOnce aac_table_init = AV_ONCE_INIT

static

Definition at line 1274 of file aacdec_template.c.

Referenced by aac_decode_init().

◆ cce_scale

const float cce_scale[]

static

Initial value:

= {
    1.09050773266525765921, 
    1.18920711500272106672, 
    M_SQRT2,
    2,
}

Definition at line 2348 of file aacdec_template.c.

Referenced by decode_cce().

◆ options

const AVOption options[]

static

Initial value:

= {
    {"dual_mono_mode", "Select the channel to decode for dual mono",
     0x42, AV_OPT_TYPE_INT, {.i64=-1}, -1, 2,
     AACDEC_FLAGS, "dual_mono_mode"},
 
    {"auto", "autoselection",            0, AV_OPT_TYPE_CONST, {.i64=-1}, INT_MIN, INT_MAX, AACDEC_FLAGS, "dual_mono_mode"},
    {"main", "Select Main/Left channel", 0, AV_OPT_TYPE_CONST, {.i64= 1}, INT_MIN, INT_MAX, AACDEC_FLAGS, "dual_mono_mode"},
    {"sub" , "Select Sub/Right channel", 0, AV_OPT_TYPE_CONST, {.i64= 2}, INT_MIN, INT_MAX, AACDEC_FLAGS, "dual_mono_mode"},
    {"both", "Select both channels",     0, AV_OPT_TYPE_CONST, {.i64= 0}, INT_MIN, INT_MAX, AACDEC_FLAGS, "dual_mono_mode"},
 
    { "channel_order", "Order in which the channels are to be exported",
        0x42, AV_OPT_TYPE_INT,
        { .i64 = CHANNEL_ORDER_DEFAULT }, 0, 1, AACDEC_FLAGS, "channel_order" },
      { "default", "normal libavcodec channel order", 0, AV_OPT_TYPE_CONST,
        { .i64 = CHANNEL_ORDER_DEFAULT }, .flags = AACDEC_FLAGS, "channel_order" },
      { "coded",    "order in which the channels are coded in the bitstream",
        0, AV_OPT_TYPE_CONST, { .i64 = CHANNEL_ORDER_CODED }, .flags = AACDEC_FLAGS, "channel_order" },
 
    {NULL},
}

Definition at line 3565 of file aacdec_template.c.

◆ aac_decoder_class

const AVClass aac_decoder_class

static

Initial value:

= {
    .class_name = "AAC decoder",
    .item_name  = av_default_item_name,
    .option     = options,
    .version    = LIBAVUTIL_VERSION_INT,
}

Definition at line 3586 of file aacdec_template.c.

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ overread_err

◆ PREFIX_FOR_22POINT2

◆ AACDEC_FLAGS

Function Documentation

◆ output_configure()

◆ count_channels()

◆ che_configure()

◆ frame_configure_elements()

◆ assign_pair()

◆ count_paired_channels()

◆ sniff_channel_order()

◆ push_output_configuration()

◆ pop_output_configuration()

◆ flush()

◆ set_default_channel_config()

◆ get_che()

◆ decode_channel_map()

◆ relative_align_get_bits()

◆ decode_pce()

◆ decode_ga_specific_config()

◆ decode_eld_specific_config()

◆ decode_audio_specific_config_gb()

◆ decode_audio_specific_config()

◆ lcg_random()

◆ reset_all_predictors()

◆ sample_rate_idx()

◆ reset_predictor_group()

◆ aacdec_init()

◆ aac_static_table_init()

◆ aac_decode_init()

◆ skip_data_stream_element()

◆ decode_prediction()

◆ decode_ltp()

◆ decode_ics_info()

◆ decode_band_types()

◆ decode_scalefactors()

◆ decode_pulses()

◆ decode_tns()

◆ decode_mid_side_stereo()

◆ decode_spectrum_and_dequant()

◆ apply_prediction()

◆ decode_gain_control()

◆ decode_ics()

◆ apply_mid_side_stereo()

◆ apply_intensity_stereo()

◆ decode_cpe()

◆ decode_cce()

◆ decode_drc_channel_exclusions()

◆ decode_dynamic_range()

◆ decode_fill()

◆ decode_extension_payload()

◆ apply_tns()

◆ windowing_and_mdct_ltp()

◆ apply_ltp()

◆ update_ltp()

◆ imdct_and_windowing()

◆ imdct_and_windowing_960()

◆ imdct_and_windowing_ld()

◆ imdct_and_windowing_eld()

◆ apply_channel_coupling()

◆ spectral_to_sample()

◆ parse_adts_frame_header()

◆ aac_decode_er_frame()

◆ aac_decode_frame_int()

◆ aac_decode_frame()

◆ aac_decode_close()

Variable Documentation

◆ vlc_scalefactors

◆ vlc_spectral

◆ aac_table_init

◆ cce_scale

◆ options

◆ aac_decoder_class