#include <float.h>
#include "libavutil/channel_layout.h"
#include "libavutil/libm.h"
#include "libavutil/float_dsp.h"
#include "libavutil/mem.h"
#include "libavutil/opt.h"
#include "avcodec.h"
#include "codec_internal.h"
#include "encode.h"
#include "put_bits.h"
#include "mpeg4audio.h"
#include "sinewin.h"
#include "profiles.h"
#include "version.h"
#include "aac.h"
#include "aactab.h"
#include "aacenc.h"
#include "aacenctab.h"
#include "aacenc_utils.h"
#include "psymodel.h"

Macros
#define	WINDOW_FUNC(type)

#define	AACENC_FLAGS AV_OPT_FLAG_ENCODING_PARAM \| AV_OPT_FLAG_AUDIO_PARAM

Functions
static void	put_pce (PutBitContext pb, AVCodecContext avctx)

static int	put_audio_specific_config (AVCodecContext *avctx)
	Make AAC audio config object. More...

void	ff_quantize_band_cost_cache_init (struct AACEncContext *s)

	WINDOW_FUNC (only_long)

	WINDOW_FUNC (long_start)

	WINDOW_FUNC (long_stop)

	WINDOW_FUNC (eight_short)

static void	apply_window_and_mdct (AACEncContext s, SingleChannelElement sce, float *audio)

static void	put_ics_info (AACEncContext s, IndividualChannelStream info)
	Encode ics_info element. More...

static void	encode_ms_info (PutBitContext pb, ChannelElement cpe)
	Encode MS data. More...

static void	adjust_frame_information (ChannelElement *cpe, int chans)
	Produce integer coefficients from scalefactors provided by the model. More...

static void	apply_intensity_stereo (ChannelElement *cpe)

static void	apply_mid_side_stereo (ChannelElement *cpe)

static void	encode_band_info (AACEncContext s, SingleChannelElement sce)
	Encode scalefactor band coding type. More...

static void	encode_scale_factors (AVCodecContext avctx, AACEncContext s, SingleChannelElement *sce)
	Encode scalefactors. More...

static void	encode_pulses (AACEncContext s, Pulse pulse)
	Encode pulse data. More...

static void	encode_spectral_coeffs (AACEncContext s, SingleChannelElement sce)
	Encode spectral coefficients processed by psychoacoustic model. More...

static void	avoid_clipping (AACEncContext s, SingleChannelElement sce)
	Downscale spectral coefficients for near-clipping windows to avoid artifacts. More...

static int	encode_individual_channel (AVCodecContext avctx, AACEncContext s, SingleChannelElement *sce, int common_window)
	Encode one channel of audio data. More...

static void	put_bitstream_info (AACEncContext s, const char name)
	Write some auxiliary information about the created AAC file. More...

static void	copy_input_samples (AACEncContext s, const AVFrame frame)

static int	aac_encode_frame (AVCodecContext avctx, AVPacket avpkt, const AVFrame frame, int got_packet_ptr)

static av_cold int	aac_encode_end (AVCodecContext *avctx)

static av_cold int	dsp_init (AVCodecContext avctx, AACEncContext s)

static av_cold int	alloc_buffers (AVCodecContext avctx, AACEncContext s)

static av_cold int	aac_encode_init (AVCodecContext *avctx)

Variables
static const AACPCEInfo	aac_pce_configs []
	List of PCE (Program Configuration Element) for the channel layouts listed in channel_layout.h. More...

static void(*const	apply_window [4])(AVFloatDSPContext fdsp, SingleChannelElement sce, const float *audio)

static const AVOption	aacenc_options []

static const AVClass	aacenc_class

static const FFCodecDefault	aac_encode_defaults []

const FFCodec	ff_aac_encoder

Detailed Description

AAC encoder

Definition in file aacenc.c.

Macro Definition Documentation

◆ WINDOW_FUNC

#define WINDOW_FUNC ( type )

Value:

static void apply_ ##type ##_window(AVFloatDSPContext *fdsp, \
                                    SingleChannelElement *sce, \
                                    const float *audio)

Definition at line 410 of file aacenc.c.

◆ AACENC_FLAGS

#define AACENC_FLAGS AV_OPT_FLAG_ENCODING_PARAM | AV_OPT_FLAG_AUDIO_PARAM

Definition at line 1392 of file aacenc.c.

Function Documentation

◆ put_pce()

static void put_pce	(	PutBitContext *	pb,
		AVCodecContext *	avctx
	)

static

Definition at line 328 of file aacenc.c.

Referenced by put_audio_specific_config().

◆ put_audio_specific_config()

static int put_audio_specific_config ( AVCodecContext * avctx )

static

Make AAC audio config object.

See also: 1.6.2.1 "Syntax - AudioSpecificConfig"

Definition at line 369 of file aacenc.c.

Referenced by aac_encode_init().

◆ ff_quantize_band_cost_cache_init()

void ff_quantize_band_cost_cache_init ( struct AACEncContext * s )

Definition at line 401 of file aacenc.c.

Referenced by search_for_quantizers_fast(), and search_for_quantizers_twoloop().

◆ WINDOW_FUNC() [1/4]

WINDOW_FUNC ( only_long )

Definition at line 415 of file aacenc.c.

◆ WINDOW_FUNC() [2/4]

WINDOW_FUNC ( long_start )

Definition at line 425 of file aacenc.c.

◆ WINDOW_FUNC() [3/4]

WINDOW_FUNC ( long_stop )

Definition at line 437 of file aacenc.c.

◆ WINDOW_FUNC() [4/4]

WINDOW_FUNC ( eight_short )

Definition at line 449 of file aacenc.c.

◆ apply_window_and_mdct()

static void apply_window_and_mdct	(	AACEncContext *	s,
		SingleChannelElement *	sce,
		float *	audio
	)

static

Definition at line 475 of file aacenc.c.

Referenced by aac_encode_frame().

◆ put_ics_info()

static void put_ics_info	(	AACEncContext *	s,
		IndividualChannelStream *	info
	)

static

Encode ics_info element.

See also: Table 4.6 (syntax of ics_info)

Definition at line 496 of file aacenc.c.

Referenced by aac_encode_frame(), and encode_individual_channel().

◆ encode_ms_info()

static void encode_ms_info	(	PutBitContext *	pb,
		ChannelElement *	cpe
	)

static

Encode MS data.

See also: 4.6.8.1 "Joint Coding - M/S Stereo"

Definition at line 517 of file aacenc.c.

Referenced by aac_encode_frame().

◆ adjust_frame_information()

static void adjust_frame_information	(	ChannelElement *	cpe,
		int	chans
	)

static

Produce integer coefficients from scalefactors provided by the model.

Definition at line 531 of file aacenc.c.

Referenced by aac_encode_frame().

◆ apply_intensity_stereo()

static void apply_intensity_stereo ( ChannelElement * cpe )

static

Definition at line 579 of file aacenc.c.

Referenced by aac_encode_frame().

◆ apply_mid_side_stereo()

static void apply_mid_side_stereo ( ChannelElement * cpe )

static

Definition at line 608 of file aacenc.c.

Referenced by aac_encode_frame().

◆ encode_band_info()

static void encode_band_info	(	AACEncContext *	s,
		SingleChannelElement *	sce
	)

static

Encode scalefactor band coding type.

Definition at line 643 of file aacenc.c.

Referenced by encode_individual_channel().

◆ encode_scale_factors()

static void encode_scale_factors	(	AVCodecContext *	avctx,
		AACEncContext *	s,
		SingleChannelElement *	sce
	)

static

Encode scalefactors.

Definition at line 657 of file aacenc.c.

Referenced by encode_individual_channel().

◆ encode_pulses()

static void encode_pulses	(	AACEncContext *	s,
		Pulse *	pulse
	)

static

Encode pulse data.

Definition at line 693 of file aacenc.c.

Referenced by encode_individual_channel().

◆ encode_spectral_coeffs()

static void encode_spectral_coeffs	(	AACEncContext *	s,
		SingleChannelElement *	sce
	)

static

Encode spectral coefficients processed by psychoacoustic model.

Definition at line 712 of file aacenc.c.

Referenced by encode_individual_channel().

◆ avoid_clipping()

static void avoid_clipping	(	AACEncContext *	s,
		SingleChannelElement *	sce
	)

static

Downscale spectral coefficients for near-clipping windows to avoid artifacts.

Definition at line 740 of file aacenc.c.

Referenced by aac_encode_frame().

◆ encode_individual_channel()

static int encode_individual_channel	(	AVCodecContext *	avctx,
		AACEncContext *	s,
		SingleChannelElement *	sce,
		int	common_window
	)

static

Encode one channel of audio data.

Definition at line 760 of file aacenc.c.

Referenced by aac_encode_frame().

◆ put_bitstream_info()

static void put_bitstream_info	(	AACEncContext *	s,
		const char *	name
	)

static

Write some auxiliary information about the created AAC file.

Definition at line 786 of file aacenc.c.

Referenced by aac_encode_frame().

◆ copy_input_samples()

static void copy_input_samples	(	AACEncContext *	s,
		const AVFrame *	frame
	)

static

Definition at line 807 of file aacenc.c.

Referenced by aac_encode_frame().

◆ aac_encode_frame()

static int aac_encode_frame	(	AVCodecContext *	avctx,
		AVPacket *	avpkt,
		const AVFrame *	frame,
		int *	got_packet_ptr
	)

static

Definition at line 829 of file aacenc.c.

◆ aac_encode_end()

static av_cold int aac_encode_end ( AVCodecContext * avctx )

static

Definition at line 1186 of file aacenc.c.

◆ dsp_init()

static av_cold int dsp_init	(	AVCodecContext *	avctx,
		AACEncContext *	s
	)

static

Definition at line 1205 of file aacenc.c.

Referenced by aac_encode_init().

◆ alloc_buffers()

static av_cold int alloc_buffers	(	AVCodecContext *	avctx,
		AACEncContext *	s
	)

static

Definition at line 1224 of file aacenc.c.

Referenced by aac_encode_init().

◆ aac_encode_init()

static av_cold int aac_encode_init ( AVCodecContext * avctx )

static

Definition at line 1237 of file aacenc.c.

Variable Documentation

◆ aac_pce_configs

const AACPCEInfo aac_pce_configs[]

static

List of PCE (Program Configuration Element) for the channel layouts listed in channel_layout.h.

For those wishing in the future to add other layouts:

num_ele: number of elements in each group of front, side, back, lfe channels (an element is of type SCE (single channel), CPE (channel pair) for the first 3 groups; and is LFE for LFE group).
pairing: 0 for an SCE element or 1 for a CPE; does not apply to LFE group
index: there are three independent indices for SCE, CPE and LFE; they are incremented irrespective of the group to which the element belongs; they are not reset when going from one group to another

Example: for 7.0 channel layout, .pairing = { { 1, 0 }, { 1 }, { 1 }, }, (3 CPE and 1 SCE in front group) .index = { { 0, 0 }, { 1 }, { 2 }, }, (index is 0 for the single SCE but goes from 0 to 2 for the CPEs)

The index order impacts the channel ordering. But is otherwise arbitrary (the sequence could have been 2, 0, 1 instead of 0, 1, 2).

Spec allows for discontinuous indices, e.g. if one has a total of two SCE, SCE.0 SCE.15 is OK per spec; BUT it won't be decoded by our AAC decoder which at this time requires that indices fully cover some range starting from 0 (SCE.1 SCE.0 is OK but not SCE.0 SCE.15).
config_map: total number of elements and their types. Beware, the way the types are ordered impacts the final channel ordering.
reorder_map: reorders the channels.

Definition at line 90 of file aacenc.c.

Referenced by aac_encode_init().

◆ apply_window

void(*const apply_window[4])(AVFloatDSPContext *fdsp, SingleChannelElement *sce, const float *audio)

static

Initial value:

= {
    [ONLY_LONG_SEQUENCE]   = apply_only_long_window,
    [LONG_START_SEQUENCE]  = apply_long_start_window,
    [EIGHT_SHORT_SEQUENCE] = apply_eight_short_window,
    [LONG_STOP_SEQUENCE]   = apply_long_stop_window
}

Definition at line 466 of file aacenc.c.

Referenced by aac_encode_frame(), apply_window_and_mdct(), and ff_mpa_synth_filter_TMPL().

◆ aacenc_options

const AVOption aacenc_options[]

static

Initial value:

= {
    {"aac_coder", "Coding algorithm", 0x42, AV_OPT_TYPE_INT, {.i64 = AAC_CODER_TWOLOOP}, 0, AAC_CODER_NB-1, AACENC_FLAGS, .unit = "coder"},
        {"anmr",     "ANMR method",               0, AV_OPT_TYPE_CONST, {.i64 = AAC_CODER_ANMR},    INT_MIN, INT_MAX, AACENC_FLAGS, .unit = "coder"},
        {"twoloop",  "Two loop searching method", 0, AV_OPT_TYPE_CONST, {.i64 = AAC_CODER_TWOLOOP}, INT_MIN, INT_MAX, AACENC_FLAGS, .unit = "coder"},
        {"fast",     "Fast search",               0, AV_OPT_TYPE_CONST, {.i64 = AAC_CODER_FAST},    INT_MIN, INT_MAX, AACENC_FLAGS, .unit = "coder"},
    {"aac_ms", "Force M/S stereo coding", 0x42, AV_OPT_TYPE_BOOL, {.i64 = -1}, -1, 1, AACENC_FLAGS},
    {"aac_is", "Intensity stereo coding", 0x42, AV_OPT_TYPE_BOOL, {.i64 = 1}, -1, 1, AACENC_FLAGS},
    {"aac_pns", "Perceptual noise substitution", 0x42, AV_OPT_TYPE_BOOL, {.i64 = 1}, -1, 1, AACENC_FLAGS},
    {"aac_tns", "Temporal noise shaping", 0x42, AV_OPT_TYPE_BOOL, {.i64 = 1}, -1, 1, AACENC_FLAGS},
    {"aac_ltp", "Long term prediction", 0x42, AV_OPT_TYPE_BOOL, {.i64 = 0}, -1, 1, AACENC_FLAGS},
    {"aac_pred", "AAC-Main prediction", 0x42, AV_OPT_TYPE_BOOL, {.i64 = 0}, -1, 1, AACENC_FLAGS},
    {"aac_pce", "Forces the use of PCEs", 0x42, AV_OPT_TYPE_BOOL, {.i64 = 0}, -1, 1, AACENC_FLAGS},
    FF_AAC_PROFILE_OPTS
    {NULL}
}

Definition at line 1393 of file aacenc.c.

◆ aacenc_class

const AVClass aacenc_class

static

Initial value:

= {
    .class_name = "AAC encoder",
    .item_name  = av_default_item_name,
    .option     = aacenc_options,
    .version    = LIBAVUTIL_VERSION_INT,
}

Definition at line 1409 of file aacenc.c.

◆ aac_encode_defaults

const FFCodecDefault aac_encode_defaults[]

static

Initial value:

= {
    { "b", "0" },
    { NULL }
}

Definition at line 1416 of file aacenc.c.

◆ ff_aac_encoder

const FFCodec ff_aac_encoder

Initial value:

= {
    .p.name         = "aac",
    CODEC_LONG_NAME("AAC (Advanced Audio Coding)"),
    .p.type         = AVMEDIA_TYPE_AUDIO,
    .p.id           = AV_CODEC_ID_AAC,
    .p.capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_DELAY |
                      AV_CODEC_CAP_SMALL_LAST_FRAME,
    .priv_data_size = sizeof(AACEncContext),
    .init           = aac_encode_init,
    FF_CODEC_ENCODE_CB(aac_encode_frame),
    .close          = aac_encode_end,
    .defaults       = aac_encode_defaults,
    .p.supported_samplerates = ff_mpeg4audio_sample_rates,
    .caps_internal  = FF_CODEC_CAP_INIT_CLEANUP,
    .p.sample_fmts  = (const enum AVSampleFormat[]){ AV_SAMPLE_FMT_FLTP,
                                                     AV_SAMPLE_FMT_NONE },
    .p.priv_class   = &aacenc_class,
}

Definition at line 1421 of file aacenc.c.

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ WINDOW_FUNC

◆ AACENC_FLAGS

Function Documentation

◆ put_pce()

◆ put_audio_specific_config()

◆ ff_quantize_band_cost_cache_init()

◆ WINDOW_FUNC() [1/4]

◆ WINDOW_FUNC() [2/4]

◆ WINDOW_FUNC() [3/4]

◆ WINDOW_FUNC() [4/4]

◆ apply_window_and_mdct()

◆ put_ics_info()

◆ encode_ms_info()

◆ adjust_frame_information()

◆ apply_intensity_stereo()

◆ apply_mid_side_stereo()

◆ encode_band_info()

◆ encode_scale_factors()

◆ encode_pulses()

◆ encode_spectral_coeffs()

◆ avoid_clipping()

◆ encode_individual_channel()

◆ put_bitstream_info()

◆ copy_input_samples()

◆ aac_encode_frame()

◆ aac_encode_end()

◆ dsp_init()

◆ alloc_buffers()

◆ aac_encode_init()

Variable Documentation

◆ aac_pce_configs

◆ apply_window

◆ aacenc_options

◆ aacenc_class

◆ aac_encode_defaults

◆ ff_aac_encoder