Generates a Sound with the help of sin() function. If performance is of concern, I suggest to use theSineFromTable, the FastSineGenerator or the FastIntSineGenerator. More...

#include <SoundGenerator.h>

Inheritance diagram for FloatSineGenerator< T >:

Public Member Functions
	FloatSineGenerator (float amplitude=NumberConverter::maxValueT< T >(), float phase=0.0f)

virtual AudioInfo	audioInfo ()
	Provides the AudioInfo.

bool	begin () override
	Starts the processing.

bool	begin (AudioInfo info) override
	Starts the processing with the provided AudioInfo.

bool	begin (AudioInfo info, float frequency)

bool	begin (int channels, int sample_rate, float frequency)

virtual AudioInfo	defaultConfig () override
	Provides the default configuration.

virtual void	end ()

virtual void	end (bool allow_rampdown)

virtual bool	isActive ()
	Checks if the begin method has been called - after end() isActive is false.

virtual size_t	readBytes (uint8_t *data, size_t len)
	Provides the data as byte array with the requested number of channels.

virtual T	readSample () override
	Provides a single sample.

virtual size_t	readSamples (T *data, size_t len)

virtual void	restart ()
	Restarts the generator, e.g. after a play time has been defined and reached.

void	setAmplitude (float amp)

virtual void	setAudioInfo (AudioInfo info) override
	Defines/updates the AudioInfo.

void	setFrequency (float frequency) override
	Defines the frequency - after the processing has been started.

virtual void	setPlayTime (uint32_t playMs, uint8_t upPercent=20, uint8_t downPercent=30)
	Defines the play time in ms and the ramp up and ramp down time in percent.

virtual void	setRampTimes (uint32_t playMs, uint32_t upMs=5, uint32_t downMs=5)

Protected Member Functions
T	applyRamp (T sample)

void	logStatus ()

size_t	readBytesFrames (uint8_t *buffer, size_t lengthBytes, int frames, int channels)

size_t	readBytesFromBuffer (uint8_t *buffer, size_t lengthBytes, int frame_size, int channels)

void	recalculatePlayTime ()

Protected Attributes
bool	active = false

bool	activeWarningIssued = false

uint32_t	currentSample = 0

const float	double_Pi = 2.0f * PI

uint32_t	downMs = 0

uint8_t	downPercent = 40

uint32_t	downSamples = 0

float	factor = 1.0f

AudioInfo	info

float	m_amplitude = 1.0f

float	m_cycles = 0.0f

float	m_deltaTime = 0.0f

volatile float	m_frequency = 0.0f

float	m_phase = 0.0f

uint32_t	playMs = 0

uint32_t	playSamples = 0

float	rampDownDec = 0.0

float	rampUpInc = 0.0

RingBuffer< uint8_t >	ring_buffer {0}

uint32_t	upMs = 0

uint8_t	upPercent = 5

uint32_t	upSamples = 0

Detailed Description

template<class T = int16_t>
class audio_tools::FloatSineGenerator< T >

Generates a Sound with the help of sin() function. If performance is of concern, I suggest to use theSineFromTable, the FastSineGenerator or the FastIntSineGenerator.

Note: Prefer SineGenerator instead of using this class directly: it automatically picks this (float) or FastIntSineGenerator, whichever is optimal for the target platform (see PREFER_FIXEDPOINT).

Author: Phil Schatzmann

Copyright: GPLv3

Constructor & Destructor Documentation

◆ FloatSineGenerator()

template<class T = int16_t>

FloatSineGenerator	(	float	amplitude = `NumberConverter::maxValueT<T>()`,
		float	phase = `0.0f`
	)

inline

Member Function Documentation

◆ applyRamp()

template<class T = int16_t>

T applyRamp ( T sample )

inlineprotectedinherited

◆ audioInfo()

template<class T = int16_t>

virtual AudioInfo audioInfo ( )

inlinevirtualinherited

Provides the AudioInfo.

◆ begin() [1/4]

template<class T = int16_t>

bool begin ( )

inlineoverridevirtual

Starts the processing.

Reimplemented from SoundGenerator< T >.

◆ begin() [2/4]

template<class T = int16_t>

bool begin ( AudioInfo info )

inlineoverridevirtual

Starts the processing with the provided AudioInfo.

Reimplemented from SoundGenerator< T >.

◆ begin() [3/4]

template<class T = int16_t>

bool begin	(	AudioInfo	info,
		float	frequency
	)

inline

◆ begin() [4/4]

template<class T = int16_t>

bool begin	(	int	channels,
		int	sample_rate,
		float	frequency
	)

inline

◆ defaultConfig()

template<class T = int16_t>

virtual AudioInfo defaultConfig ( )

inlineoverridevirtual

Provides the default configuration.

Reimplemented from SoundGenerator< T >.

◆ end() [1/2]

template<class T = int16_t>

virtual void end ( )

inlinevirtualinherited

Reimplemented in GeneratorFromArray< T >, and GeneratorQueue< T >.

◆ end() [2/2]

template<class T = int16_t>

virtual void end ( bool allow_rampdown )

inlinevirtualinherited

Ends the processing. If either setPlayTime() or setRampTimes() have been set, then allow_rampdown=true will start a ramp-down instead of stopping immediately.

◆ isActive()

template<class T = int16_t>

virtual bool isActive ( )

inlinevirtualinherited

Checks if the begin method has been called - after end() isActive is false.

◆ logStatus()

template<class T = int16_t>

void logStatus ( )

inlineprotected

◆ readBytes()

template<class T = int16_t>

virtual size_t readBytes	(	uint8_t *	data,
		size_t	len
	)

inlinevirtualinherited

Provides the data as byte array with the requested number of channels.

Reimplemented in GeneratorQueue< T >.

◆ readBytesFrames()

template<class T = int16_t>

size_t readBytesFrames	(	uint8_t *	buffer,
		size_t	lengthBytes,
		int	frames,
		int	channels
	)

inlineprotectedinherited

◆ readBytesFromBuffer()

template<class T = int16_t>

size_t readBytesFromBuffer	(	uint8_t *	buffer,
		size_t	lengthBytes,
		int	frame_size,
		int	channels
	)

inlineprotectedinherited

◆ readSample()

template<class T = int16_t>

virtual T readSample ( )

inlineoverridevirtual

Provides a single sample.

Implements SoundGenerator< T >.

Reimplemented in FastSineGenerator< T >.

◆ readSamples()

template<class T = int16_t>

virtual size_t readSamples	(	T *	data,
		size_t	len
	)

inlinevirtualinherited

Provides the data as T array (interleaved by channel) with the requested number of samples (values, not frames)

Reimplemented in GeneratorQueue< T >.

◆ recalculatePlayTime()

template<class T = int16_t>

void recalculatePlayTime ( )

inlineprotectedinherited

◆ restart()

template<class T = int16_t>

virtual void restart ( )

inlinevirtualinherited

Restarts the generator, e.g. after a play time has been defined and reached.

◆ setAmplitude()

template<class T = int16_t>

void setAmplitude ( float amp )

inline

◆ setAudioInfo()

template<class T = int16_t>

virtual void setAudioInfo ( AudioInfo info )

inlineoverridevirtual

Defines/updates the AudioInfo.

Reimplemented from SoundGenerator< T >.

◆ setFrequency()

template<class T = int16_t>

void setFrequency ( float frequency )

inlineoverridevirtual

Defines the frequency - after the processing has been started.

Reimplemented from SoundGenerator< T >.

◆ setPlayTime()

template<class T = int16_t>

virtual void setPlayTime	(	uint32_t	playMs,
		uint8_t	upPercent = `20`,
		uint8_t	downPercent = `30`
	)

inlinevirtualinherited

Defines the play time in ms and the ramp up and ramp down time in percent.

Reimplemented in GeneratorQueue< T >.

◆ setRampTimes()

template<class T = int16_t>

virtual void setRampTimes	(	uint32_t	playMs,
		uint32_t	upMs = `5`,
		uint32_t	downMs = `5`
	)

inlinevirtualinherited

Alternative to setPlayTime. It sets ramp-up and ramp-down times in ms instead of percentages. If playMs == 0, it will play indefinitely. restart();begin(); starts the ramp-up and sustain as normal, but it will sustain forever. end(true) triggers a ramp-down then inactive.

Member Data Documentation

◆ active

template<class T = int16_t>

bool active = false

protectedinherited

◆ activeWarningIssued

template<class T = int16_t>

bool activeWarningIssued = false

protectedinherited

◆ currentSample

template<class T = int16_t>

uint32_t currentSample = 0

protectedinherited

◆ double_Pi

template<class T = int16_t>

const float double_Pi = 2.0f * PI

protected

◆ downMs

template<class T = int16_t>

uint32_t downMs = 0

protectedinherited

◆ downPercent

template<class T = int16_t>

uint8_t downPercent = 40

protectedinherited

◆ downSamples

template<class T = int16_t>

uint32_t downSamples = 0

protectedinherited

◆ factor

template<class T = int16_t>

float factor = 1.0f

protectedinherited

◆ info

template<class T = int16_t>

AudioInfo info

protectedinherited

◆ m_amplitude

template<class T = int16_t>

float m_amplitude = 1.0f

protected

◆ m_cycles

template<class T = int16_t>

float m_cycles = 0.0f

protected

◆ m_deltaTime

template<class T = int16_t>

float m_deltaTime = 0.0f

protected

◆ m_frequency

template<class T = int16_t>

volatile float m_frequency = 0.0f

protected

◆ m_phase

template<class T = int16_t>

float m_phase = 0.0f

protected

◆ playMs

template<class T = int16_t>

uint32_t playMs = 0

protectedinherited

◆ playSamples

template<class T = int16_t>

uint32_t playSamples = 0

protectedinherited

◆ rampDownDec

template<class T = int16_t>

float rampDownDec = 0.0

protectedinherited

◆ rampUpInc

template<class T = int16_t>

float rampUpInc = 0.0

protectedinherited

◆ ring_buffer

template<class T = int16_t>

RingBuffer<uint8_t> ring_buffer {0}

protectedinherited

◆ upMs

template<class T = int16_t>

uint32_t upMs = 0

protectedinherited

◆ upPercent

template<class T = int16_t>

uint8_t upPercent = 5

protectedinherited

◆ upSamples

template<class T = int16_t>

uint32_t upSamples = 0

protectedinherited

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

src/AudioTools/CoreAudio/AudioEffects/SoundGenerator.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ FloatSineGenerator()

Member Function Documentation

◆ applyRamp()

◆ audioInfo()

◆ begin() [1/4]

◆ begin() [2/4]

◆ begin() [3/4]

◆ begin() [4/4]

◆ defaultConfig()

◆ end() [1/2]

◆ end() [2/2]

◆ isActive()

◆ logStatus()

◆ readBytes()

◆ readBytesFrames()

◆ readBytesFromBuffer()

◆ readSample()

◆ readSamples()

◆ recalculatePlayTime()

◆ restart()

◆ setAmplitude()

◆ setAudioInfo()

◆ setFrequency()

◆ setPlayTime()

◆ setRampTimes()

Member Data Documentation

◆ active

◆ activeWarningIssued

◆ currentSample

◆ double_Pi

◆ downMs

◆ downPercent

◆ downSamples

◆ factor

◆ info

◆ m_amplitude

◆ m_cycles

◆ m_deltaTime

◆ m_frequency

◆ m_phase

◆ playMs

◆ playSamples

◆ rampDownDec

◆ rampUpInc

◆ ring_buffer

◆ upMs

◆ upPercent

◆ upSamples