Encodes PCM data to the AAC format and writes the result to a stream This is basically just a wrapper using https://github.com/pschatzmann/arduino-fdk-aac. More...

#include <CodecAACFDK.h>

Inheritance diagram for AACEncoderFDK:

Public Member Functions
	AACEncoderFDK ()

	AACEncoderFDK (Print &out_stream)

	~AACEncoderFDK ()

AudioInfo	audioInfo () override
	provides the actual input AudioInfo

virtual AudioInfo	audioInfoOut ()

bool	begin () override

virtual bool	begin (AudioInfo info) override
	Opens the encoder

virtual bool	begin (int input_channels=2, int input_sample_rate=44100, int input_bits_per_sample=16)
	Opens the encoder

aac_fdk::AACEncoderFDK *	driver ()

void	end () override

virtual uint32_t	frameDurationUs ()
	Optional rtsp function: provide the frame duration in microseconds.

UINT	getParameter (const AACENC_PARAM param)

const char *	mime () override
	Provides the mime type of the encoded result.

	operator bool () override

virtual uint16_t	samplesPerFrame ()
	Optional rtsp function: provide samples per the frame.

virtual void	setAfterburner (bool afterburner)
	This parameter controls the use of the afterburner feature. The afterburner is a type of analysis by synthesis algorithm which increases the audio quality but also the required processing power. It is recommended to always activate this if additional memory consumption and processing power consumption is not a problem. If increased MHz and memory consumption are an issue then the MHz and memory cost of this optional module need to be evaluated against the improvement in audio quality on a case by case basis.

void	setAudioInfo (AudioInfo from) override
	Defines the Audio Info.

virtual void	setAudioObjectType (int aot)
	Audio object type. See AUDIO_OBJECT_TYPE in FDK_audio.h.

virtual void	setBitrate (int bitrate)
	Total encoder bitrate. This parameter is mandatory and interacts with AACENC_BITRATEMODE.

void	setOutput (Print &out_stream) override
	Defines the output.

virtual void	setOutputBufferSize (int outbuf_size)
	Set the Output Buffer Size object.

int	setParameter (AACENC_PARAM param, uint32_t value)

virtual void	setSpectralBandReplication (int eld_sbr)
	Configure SBR independently of the chosen Audio Object Type AUDIO_OBJECT_TYPE. This parameter is for ELD audio object type only.

virtual void	setVariableBitrateMode (int vbr)
	Bitrate mode. Configuration can be different kind of bitrate configurations:

size_t	write (const uint8_t *data, size_t len) override

Protected Member Functions
void	writeBlocking (Print out, uint8_t data, size_t len)

Protected Attributes
aac_fdk::AACEncoderFDK *	enc =nullptr

AudioInfo	info

Detailed Description

Encodes PCM data to the AAC format and writes the result to a stream This is basically just a wrapper using https://github.com/pschatzmann/arduino-fdk-aac.

Author: Phil Schatzmann

Copyright: GPLv3

Constructor & Destructor Documentation

◆ AACEncoderFDK() [1/2]

AACEncoderFDK ( )

inline

◆ AACEncoderFDK() [2/2]

AACEncoderFDK ( Print & out_stream )

inline

◆ ~AACEncoderFDK()

~AACEncoderFDK ( )

inline

Member Function Documentation

◆ audioInfo()

AudioInfo audioInfo ( )

inlineoverridevirtualinherited

provides the actual input AudioInfo

Implements AudioInfoSupport.

Reimplemented in CodecNOP, BinaryContainerEncoder, and MP3ParserEncoder.

◆ audioInfoOut()

virtual AudioInfo audioInfoOut ( )

inlinevirtualinherited

provides the actual output AudioInfo: this is usually the same as audioInfo() unless we use a transforming stream

Reimplemented in PureDataStream, PWMAudioOutput, ChannelFormatConverterStreamT< T >, ChannelFormatConverterStream, NumberFormatConverterStreamT< TFrom, TTo >, NumberFormatConverterStream, FormatConverterStream, Pipeline, ResampleStream, and ResampleStreamT< TInterpolator >.

◆ begin() [1/3]

bool begin ( )

inlineoverridevirtual

Implements AudioWriter.

◆ begin() [2/3]

virtual bool begin ( AudioInfo info )

inlineoverridevirtual

Opens the encoder

Parameters

info

Returns: int

Reimplemented from AudioWriter.

◆ begin() [3/3]

virtual bool begin	(	int	input_channels = `2`,
		int	input_sample_rate = `44100`,
		int	input_bits_per_sample = `16`
	)

inlinevirtual

Opens the encoder

Parameters

input_channels
input_sample_rate
input_bits_per_sample

Returns: int 0 => ok; error with negative number

◆ driver()

aac_fdk::AACEncoderFDK * driver ( )

inline

◆ end()

void end ( )

inlineoverridevirtual

Implements AudioWriter.

◆ frameDurationUs()

virtual uint32_t frameDurationUs ( )

inlinevirtualinherited

Optional rtsp function: provide the frame duration in microseconds.

Reimplemented in ADPCMEncoder, OpusOggEncoder, MP3ParserEncoder, and MetaDataFilterEncoder.

◆ getParameter()

UINT getParameter ( const AACENC_PARAM param )

inline

◆ mime()

const char * mime ( )

inlineoverridevirtual

Provides the mime type of the encoded result.

Implements AudioEncoder.

◆ operator bool()

operator bool ( )

inlineoverridevirtual

Implements AudioWriter.

◆ samplesPerFrame()

virtual uint16_t samplesPerFrame ( )

inlinevirtualinherited

Optional rtsp function: provide samples per the frame.

Reimplemented in MP3ParserEncoder, and MetaDataFilterEncoder.

◆ setAfterburner()

virtual void setAfterburner ( bool afterburner )

inlinevirtual

This parameter controls the use of the afterburner feature. The afterburner is a type of analysis by synthesis algorithm which increases the audio quality but also the required processing power. It is recommended to always activate this if additional memory consumption and processing power consumption is not a problem. If increased MHz and memory consumption are an issue then the MHz and memory cost of this optional module need to be evaluated against the improvement in audio quality on a case by case basis.

0: Disable afterburner (default).
1: Enable afterburner.

◆ setAudioInfo()

void setAudioInfo ( AudioInfo from )

inlineoverridevirtual

Defines the Audio Info.

Implements AudioWriter.

◆ setAudioObjectType()

virtual void setAudioObjectType ( int aot )

inlinevirtual

Audio object type. See AUDIO_OBJECT_TYPE in FDK_audio.h.

2: MPEG-4 AAC Low Complexity.
5: MPEG-4 AAC Low Complexity with Spectral Band Replication (HE-AAC).
29: MPEG-4 AAC Low Complexity with Spectral Band Replication and Parametric Stereo (HE-AAC v2). This configuration can be used only with stereo input audio data.
23: MPEG-4 AAC Low-Delay.
39: MPEG-4 AAC Enhanced Low-Delay. Since there is no AUDIO_OBJECT_TYPE for ELD in combination with SBR defined, enable SBR explicitely by AACENC_SBR_MODE parameter. The ELD v2 212 configuration can be configured by AACENC_CHANNELMODE parameter.
129: MPEG-2 AAC Low Complexity.
132: MPEG-2 AAC Low Complexity with Spectral Band Replication (HE-AAC).

Please note that the virtual MPEG-2 AOT's basically disables non-existing Perceptual Noise Substitution tool in AAC encoder and controls the MPEG_ID flag in adts header. The virtual MPEG-2 AOT doesn't prohibit specific transport formats.

◆ setBitrate()

virtual void setBitrate ( int bitrate )

inlinevirtual

Total encoder bitrate. This parameter is
mandatory and interacts with AACENC_BITRATEMODE.

CBR: Bitrate in bits/second.
VBR: Variable bitrate. Bitrate argument will be ignored. See suppBitrates for details.

◆ setOutput()

void setOutput ( Print & out_stream )

inlineoverridevirtual

Defines the output.

Reimplemented from AudioEncoder.

◆ setOutputBufferSize()

virtual void setOutputBufferSize ( int outbuf_size )

inlinevirtual

Set the Output Buffer Size object.

Parameters

outbuf_size

◆ setParameter()

int setParameter	(	AACENC_PARAM	param,
		uint32_t	value
	)

inline

◆ setSpectralBandReplication()

virtual void setSpectralBandReplication ( int eld_sbr )

inlinevirtual

Configure SBR independently of the chosen Audio Object Type AUDIO_OBJECT_TYPE. This parameter is for ELD audio object type only.

-1: Use ELD SBR auto configurator (default).
0: Disable Spectral Band Replication.
1: Enable Spectral Band Replication.

◆ setVariableBitrateMode()

virtual void setVariableBitrateMode ( int vbr )

inlinevirtual

Bitrate mode. Configuration can be different kind of bitrate configurations:

0: Constant bitrate, use bitrate according to AACENC_BITRATE. (default) Within none LD/ELD AUDIO_OBJECT_TYPE, the CBR mode makes use of full allowed bitreservoir. In contrast, at Low-Delay AUDIO_OBJECT_TYPE the bitreservoir is kept very small.
1: Variable bitrate mode, very low bitrate.
2: Variable bitrate mode, low bitrate.
3: Variable bitrate mode, medium bitrate.
4: Variable bitrate mode, high bitrate.
5: Variable bitrate mode, very high bitrate.

◆ write()

size_t write	(	const uint8_t *	data,
		size_t	len
	)

inlineoverridevirtual

Implements AudioWriter.

◆ writeBlocking()

void writeBlocking	(	Print *	out,
		uint8_t *	data,
		size_t	len
	)

inlineprotectedinherited

Member Data Documentation

◆ enc

aac_fdk::AACEncoderFDK* enc =nullptr

protected

◆ info

AudioInfo info

protectedinherited

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

src/AudioTools/AudioCodecs/CodecAACFDK.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ AACEncoderFDK() [1/2]

◆ AACEncoderFDK() [2/2]

◆ ~AACEncoderFDK()

Member Function Documentation

◆ audioInfo()

◆ audioInfoOut()

◆ begin() [1/3]

◆ begin() [2/3]

◆ begin() [3/3]

◆ driver()

◆ end()

◆ frameDurationUs()

◆ getParameter()

◆ mime()

◆ operator bool()

◆ samplesPerFrame()

◆ setAfterburner()

◆ setAudioInfo()

◆ setAudioObjectType()

◆ setBitrate()

◆ setOutput()

◆ setOutputBufferSize()

◆ setParameter()

◆ setSpectralBandReplication()

◆ setVariableBitrateMode()

◆ write()

◆ writeBlocking()

Member Data Documentation

◆ enc

◆ info