An Adapter Class which lets you use any Stream as a Generator. More...

#include <SoundGenerator.h>

Inheritance diagram for GeneratorFromStream< T >:

Public Member Functions
	GeneratorFromStream ()

	GeneratorFromStream (Stream &input, int channels=1, float volume=1.0)
	Constructs a new Generator from a Stream object that can be used e.g. as input for AudioEffectss.

virtual AudioInfo	audioInfo ()
	Provides the AudioInfo.

virtual bool	begin ()
	Starts the processing.

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

virtual AudioInfo	defaultConfig ()
	Provides the default configuration.

virtual void	end ()
	Ends the processing.

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.

T	readSample ()
	Provides a single sample from the stream.

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

void	setChannels (int channels)

virtual void	setFrequency (float frequency)
	Abstract method: not implemented! Just provides an error message...

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.

void	setStream (Stream &input)
	(Re-)Assigns a stream to the Adapter class

virtual bool	setVolume (float volume)
	define the actual volume in the range of 0.0f to 1.0f

virtual float	volume ()
	provides the actual volume in the range of 0.0f to 1.0f

Protected Member Functions
T	applyRamp (T sample)

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

int	channels = 1

uint32_t	currentSample = 0

uint8_t	downPercent = 40

float	factor = 1.0f

AudioInfo	info

float	maxValue

Stream *	p_stream = nullptr

uint32_t	playMs = 0

uint32_t	playSamples = 0

float	rampDownDec = 0.0

uint32_t	rampDownSamples = 0

float	rampUpInc = 0.0

RingBuffer< uint8_t >	ring_buffer {0}

uint8_t	upPercent = 5

uint32_t	upSamples = 0

float	volume_value = 1.0f

Detailed Description

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

An Adapter Class which lets you use any Stream as a Generator.

Author: Phil Schatzmann

Copyright: GPLv3

Template Parameters

T

Constructor & Destructor Documentation

◆ GeneratorFromStream() [1/2]

template<class T = int16_t>

GeneratorFromStream ( )

inline

◆ GeneratorFromStream() [2/2]

template<class T = int16_t>

GeneratorFromStream	(	Stream &	input,
		int	channels = `1`,
		float	volume = `1.0`
	)

inline

Constructs a new Generator from a Stream object that can be used e.g. as input for AudioEffectss.

Parameters

input	Stream
channels	number of channels of the Stream
volume	factor my which the sample value is multiplied - default 1.0; Use it e.g. to reduce the volume (e.g. with 0.5)

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/2]

template<class T = int16_t>

virtual bool begin ( )

inlinevirtualinherited

Starts the processing.

Reimplemented in SineFromTable< T >, SineGenerator< T >, SineGenerator< int16_t >, GeneratorFromArray< T >, and GeneratorFixedValue< T >.

◆ begin() [2/2]

template<class T = int16_t>

virtual bool begin ( AudioInfo info )

inlinevirtualinherited

Starts the processing with the provided AudioInfo.

Reimplemented in STKGenerator< StkCls, T >, STKGenerator< stk::Instrmnt, int16_t >, STKGenerator< StkCls, int16_t >, Synthesizer, GeneratorFixedValue< T >, SoundGeneratorModulation< T >, SineGenerator< T >, SineGenerator< int16_t >, and GeneratorFromArray< T >.

◆ defaultConfig()

template<class T = int16_t>

virtual AudioInfo defaultConfig ( )

inlinevirtualinherited

Provides the default configuration.

Reimplemented in STKGenerator< StkCls, T >, STKGenerator< stk::Instrmnt, int16_t >, STKGenerator< StkCls, int16_t >, SineGenerator< T >, and SineGenerator< int16_t >.

◆ end()

template<class T = int16_t>

virtual void end ( )

inlinevirtualinherited

Ends the processing.

Reimplemented in GeneratorFromArray< T >.

◆ isActive()

template<class T = int16_t>

virtual bool isActive ( )

inlinevirtualinherited

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

◆ 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.

◆ 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>

T readSample ( )

inlinevirtual

Provides a single sample from the stream.

Implements SoundGenerator< T >.

◆ recalculatePlayTime()

template<class T = int16_t>

void recalculatePlayTime ( )

inlineprotectedinherited

◆ setAudioInfo()

template<class T = int16_t>

virtual void setAudioInfo ( AudioInfo info )

inlinevirtualinherited

Defines/updates the AudioInfo.

Reimplemented in SineGenerator< T >, and SineGenerator< int16_t >.

◆ setChannels()

template<class T = int16_t>

void setChannels ( int channels )

inline

◆ setFrequency()

template<class T = int16_t>

virtual void setFrequency ( float frequency )

inlinevirtualinherited

Abstract method: not implemented! Just provides an error message...

Reimplemented in SineFromTable< T >, STKInstrument< StkCls, T >, SineGenerator< T >, SineGenerator< int16_t >, and GeneratorFromArray< T >.

◆ setPlayTime()

template<class T = int16_t>

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

inlineinherited

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

◆ setStream()

template<class T = int16_t>

void setStream ( Stream & input )

inline

(Re-)Assigns a stream to the Adapter class

◆ setVolume()

virtual bool setVolume ( float volume )

inlinevirtualinherited

define the actual volume in the range of 0.0f to 1.0f

Reimplemented in Maximilian, I2SCodecStream, VS1053Stream, VolumeStream, A2DPStream, and AudioPlayer.

◆ volume()

virtual float volume ( )

inlinevirtualinherited

provides the actual volume in the range of 0.0f to 1.0f

Reimplemented in I2SCodecStream, VS1053Stream, AudioPlayer, and VolumeStream.

Member Data Documentation

◆ active

template<class T = int16_t>

bool active = false

protectedinherited

◆ activeWarningIssued

template<class T = int16_t>

bool activeWarningIssued = false

protectedinherited

◆ channels

template<class T = int16_t>

int channels = 1

protected

◆ currentSample

template<class T = int16_t>

uint32_t currentSample = 0

protectedinherited

◆ downPercent

template<class T = int16_t>

uint8_t downPercent = 40

protectedinherited

◆ factor

template<class T = int16_t>

float factor = 1.0f

protectedinherited

◆ info

template<class T = int16_t>

AudioInfo info

protectedinherited

◆ maxValue

template<class T = int16_t>

float maxValue

protected

◆ p_stream

template<class T = int16_t>

Stream* p_stream = nullptr

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

◆ rampDownSamples

template<class T = int16_t>

uint32_t rampDownSamples = 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

◆ upPercent

template<class T = int16_t>

uint8_t upPercent = 5

protectedinherited

◆ upSamples

template<class T = int16_t>

uint32_t upSamples = 0

protectedinherited

◆ volume_value

float volume_value = 1.0f

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

◆ GeneratorFromStream() [1/2]

◆ GeneratorFromStream() [2/2]

Member Function Documentation

◆ applyRamp()

◆ audioInfo()

◆ begin() [1/2]

◆ begin() [2/2]

◆ defaultConfig()

◆ end()

◆ isActive()

◆ readBytes()

◆ readBytesFrames()

◆ readBytesFromBuffer()

◆ readSample()

◆ recalculatePlayTime()

◆ setAudioInfo()

◆ setChannels()

◆ setFrequency()

◆ setPlayTime()

◆ setStream()

◆ setVolume()

◆ volume()

Member Data Documentation

◆ active

◆ activeWarningIssued

◆ channels

◆ currentSample

◆ downPercent

◆ factor

◆ info

◆ maxValue

◆ p_stream

◆ playMs

◆ playSamples

◆ rampDownDec

◆ rampDownSamples

◆ rampUpInc

◆ ring_buffer

◆ upPercent

◆ upSamples

◆ volume_value