MultiOutput Class Reference

Replicates the output to multiple destinations. More...

#include <AudioIO.h>

Inheritance diagram for MultiOutput:

Public Member Functions
	MultiOutput ()=default
	Defines a MultiOutput with no final output: Define your outputs with add()
	MultiOutput (AudioOutput &out)
	Defines a MultiOutput with a single final outputs,.
	MultiOutput (AudioOutput &out1, AudioOutput &out2)
	Defines a MultiOutput with 2 final outputs.
	MultiOutput (AudioStream &out)
	MultiOutput (AudioStream &out1, AudioStream &out2)
	Defines a MultiOutput with 2 final outputs.
	MultiOutput (Print &out)
	MultiOutput (Print &out1, Print &out2)
virtual	~MultiOutput ()
void	add (AudioOutput &out)
	Add an additional AudioOutput output.
void	add (AudioStream &stream)
	Add an AudioStream to the output.
void	add (Print &print)
virtual void	addNotifyAudioChange (AudioInfoSupport &bi)
	Adds target to be notified about audio changes.
virtual AudioInfo	audioInfo () override
	provides the actual input AudioInfo
virtual AudioInfo	audioInfoOut ()
virtual int	availableForWrite () override
virtual bool	begin ()
virtual bool	begin (AudioInfo info)
void	clear ()
	Removes all output components.
virtual void	clearNotifyAudioChange ()
	Deletes all change notify subscriptions.
virtual void	end ()
void	flush ()
virtual bool	isDeletable ()
	If true we need to release the related memory in the destructor.
bool	isNotifyActive ()
	Checks if the automatic AudioInfo update is active.
virtual	operator bool ()
virtual bool	removeNotifyAudioChange (AudioInfoSupport &bi)
	Removes a target in order not to be notified about audio changes.
void	setAudioInfo (AudioInfo info)
	Defines the input AudioInfo.
void	setNotifyActive (bool flag)
	Deactivate/Reactivate automatic AudioInfo updates: (default is active)
size_t	write (const uint8_t *data, size_t len) override
size_t	write (uint8_t ch) override
virtual void	writeSilence (size_t len)

Protected Member Functions
void	notifyAudioChange (AudioInfo info)
void	setOutput (Print &out)
	support for Pipleline

Protected Attributes
int	_timeout = 10
AudioInfo	cfg
bool	is_active = false
bool	is_notify_active = true
Vector< AudioInfoSupport * >	notify_vector
SingleBuffer< uint8_t >	tmp {MAX_SINGLE_CHARS}
int	tmpPos = 0
Vector< AudioOutput * >	vector

Detailed Description

Replicates the output to multiple destinations.

Author

Phil Schatzmann

Copyright

GPLv3

Constructor & Destructor Documentation

MultiOutput() [1/7]

MultiOutput ( )

default

Defines a MultiOutput with no final output: Define your outputs with add()

MultiOutput() [2/7]

MultiOutput ( Print &  out )

inline

MultiOutput() [3/7]

MultiOutput ( AudioOutput &  out )

inline

Defines a MultiOutput with a single final outputs,.

MultiOutput() [4/7]

MultiOutput ( AudioStream &  out )

inline

MultiOutput() [5/7]

MultiOutput ( AudioOutput &  out1, AudioOutput &  out2  )

inline

Defines a MultiOutput with 2 final outputs.

MultiOutput() [6/7]

MultiOutput ( AudioStream &  out1, AudioStream &  out2  )

inline

Defines a MultiOutput with 2 final outputs.

MultiOutput() [7/7]

MultiOutput ( Print &  out1, Print &  out2  )

inline

Defines a MultiOutput with 2 final outputs: Warning no support for AudioInfo notifications. It is recommended to use individual add calls.

~MultiOutput()

virtual ~MultiOutput ( )

inlinevirtual

Member Function Documentation

add() [1/3]

void add ( AudioOutput &  out )

inline

Add an additional AudioOutput output.

add() [2/3]

void add ( AudioStream &  stream )

inline

Add an AudioStream to the output.

add() [3/3]

void add ( Print &  print )

inline

addNotifyAudioChange()

virtual void addNotifyAudioChange ( AudioInfoSupport &  bi )

inlinevirtualinherited

Adds target to be notified about audio changes.

Reimplemented in CodecNOP, EncodedAudioOutput, EncodedAudioStream, AACDecoderFDK, DecoderBasic, CodecChain, MP3DecoderHelix, MP3DecoderMAD, OggContainerDecoder, RTSPClient< TcpClient, UdpSocket >, Pipeline, and Pipeline::ModifyingStreamAdapter.

audioInfo()

virtual AudioInfo audioInfo ( )

inlineoverridevirtualinherited

provides the actual input AudioInfo

Implements AudioInfoSupport.

Reimplemented in AdapterPrintToAudioOutput, EncodedAudioOutput, and AdapterAudioStreamToAudioOutput.

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

availableForWrite()

virtual int availableForWrite ( )

inlineoverridevirtualinherited

Reimplemented from Print.

Reimplemented in AudioESP32ULP, RTSPOutput< Platform >, SPIAudioMaster, EncodedAudioOutput, AudioServerEx, AudioSyncWriter, AdapterAudioStreamToAudioOutput, CsvOutput< T >, MemoryOutput, and PWMAudioOutput.

begin() [1/2]

virtual bool begin ( )

inlinevirtualinherited

Reimplemented in OSCContainerEncoder::OSCOutput, AudioOutputWithCallback, AudioServerEx, RTSPOutput< Platform >, PitchShiftOutput< T, BufferT >, PWMAudioOutput, RTTTLOutput< T >, EncodedAudioOutput, OggContainerOutput, FFTEffect, FFTPitchShift, R2ROutput, AdapterAudioStreamToAudioOutput, ChannelsSelectOutput, MetaDataFilter, CsvOutput< T >, HexDumpOutput, MemoryOutput, and RTTTLOutput< T >.

begin() [2/2]

virtual bool begin ( AudioInfo  info )

inlinevirtualinherited

Reimplemented in AudioESP32ULP, RTSPOutput< Platform >, RTTTLOutput< T >, ChannelsSelectOutput, CsvOutput< T >, and EncodedAudioOutput.

clear()

void clear ( )

inline

Removes all output components.

clearNotifyAudioChange()

virtual void clearNotifyAudioChange ( )

inlinevirtualinherited

Deletes all change notify subscriptions.

Reimplemented in RTSPClient< TcpClient, UdpSocket >.

end()

virtual void end ( )

inlinevirtualinherited

Reimplemented in AudioESP32ULP, AudioServerEx, AudioSyncWriter, RTSPOutput< Platform >, SPIAudioMaster, PitchShiftOutput< T, BufferT >, MetaDataOutput, EncodedAudioOutput, OggContainerOutput, AdapterAudioStreamToAudioOutput, MetaDataFilter, and PWMAudioOutput.

flush()

void flush ( )

inlinevirtual

Reimplemented from AudioOutput.

isDeletable()

virtual bool isDeletable ( )

inlinevirtualinherited

If true we need to release the related memory in the destructor.

Reimplemented in AdapterPrintToAudioOutput, and AdapterAudioStreamToAudioOutput.

isNotifyActive()

bool isNotifyActive ( )

inlineinherited

Checks if the automatic AudioInfo update is active.

notifyAudioChange()

void notifyAudioChange ( AudioInfo  info )

inlineprotectedinherited

operator bool()

virtual operator bool ( )

inlinevirtualinherited

Reimplemented in RTSPOutput< Platform >, EncodedAudioOutput, and AdapterAudioStreamToAudioOutput.

removeNotifyAudioChange()

virtual bool removeNotifyAudioChange ( AudioInfoSupport &  bi )

inlinevirtualinherited

Removes a target in order not to be notified about audio changes.

Reimplemented in RTSPClient< TcpClient, UdpSocket >.

setAudioInfo()

void setAudioInfo ( AudioInfo  info )

inlinevirtual

Defines the input AudioInfo.

Reimplemented from AudioOutput.

setNotifyActive()

void setNotifyActive ( bool  flag )

inlineinherited

Deactivate/Reactivate automatic AudioInfo updates: (default is active)

setOutput()

void setOutput ( Print &  out )

inlineprotectedvirtual

support for Pipleline

Implements ModifyingOutput.

write() [1/2]

size_t write ( const uint8_t *  data, size_t  len  )

inlineoverridevirtual

Implements AudioOutput.

write() [2/2]

size_t write ( uint8_t  ch )

inlineoverridevirtual

Reimplemented from AudioOutput.

writeSilence()

virtual void writeSilence ( size_t  len )

inlinevirtualinherited

Writes n 0 values (= silence)

Parameters

len

Member Data Documentation

_timeout

int _timeout = 10

protectedinherited

cfg

AudioInfo cfg

protectedinherited

is_active

bool is_active = false

protectedinherited

is_notify_active

bool is_notify_active = true

protectedinherited

notify_vector

Vector<AudioInfoSupport*> notify_vector

protectedinherited

tmp

SingleBuffer<uint8_t> tmp {MAX_SINGLE_CHARS}

protectedinherited

tmpPos

int tmpPos = 0

protectedinherited

vector

Vector<AudioOutput*> vector

protected

---

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

• src/AudioTools/CoreAudio/AudioIO.h