switchboard::AudioRingBuffer< T > Class Template Reference

Class providing ring buffer functionality specialized for audio (most importantly multichannel functionality). More...

#include <AudioRingBuffer.hpp>

Public Member Functions
	AudioRingBuffer (uint numberOfFrames, uint numberOfChannels, bool isInterleaved)
	Creates an AudioRingBuffer instance. Allocates underlying buffer, constructor not suitable for real-time use.
	AudioRingBuffer (uint numberOfFrames, uint numberOfChannels, bool isInterleaved, buffer::AudioData< T > &buffer)
	Creates an AudioRingBuffer instance. Does not allocate underlying buffer, suitable for real-time use.
	AudioRingBuffer (AudioRingBuffer &&)=default
	Move constructor.
AudioRingBuffer &	operator= (AudioRingBuffer &&)=default
	Move assignment operator.
void	clear ()
	Clears all data in the audio ring buffer.
uint	getAvailableFramesToProduce () const
	Returns the maximum number of frames that can be added to the audio ring buffer.
void	produce (const AudioBuffer< T > &sourceBuffer, uint numberOfFrames)
	Adds frames to the audio ring buffer.
uint	getAvailableFramesToConsume () const
	Returns the maximum number of items that can be read from the ring buffer.
void	consume (AudioBuffer< T > &destinationBuffer, uint numberOfFrames)
	Reads items from the ring buffer.
void	read (AudioBuffer< T > &destinationBuffer, uint numberOfItems)
	Reads items from the ring buffer without updating the read pointer.
void	discard (uint numberOfItems)
	Discards items from the ring buffer. Steps the read pointer without reading the items.

Detailed Description

template<typename T>
class switchboard::AudioRingBuffer< T >

Class providing ring buffer functionality specialized for audio (most importantly multichannel functionality).

AudioRingBuffer class.

Constructor & Destructor Documentation

AudioRingBuffer() [1/2]

template<typename T>

switchboard::AudioRingBuffer< T >::AudioRingBuffer	(	uint	numberOfFrames,
		uint	numberOfChannels,
		bool	isInterleaved )

Creates an AudioRingBuffer instance. Allocates underlying buffer, constructor not suitable for real-time use.

Parameters

numberOfFrames	The number of frames that the audio ring buffer can hold.
numberOfChannels	The number of channels that the audio ring buffer can hold.
isInterleaved	Indicates whether the audio ring buffer should hold interleaved data.

AudioRingBuffer() [2/2]

template<typename T>

switchboard::AudioRingBuffer< T >::AudioRingBuffer	(	uint	numberOfFrames,
		uint	numberOfChannels,
		bool	isInterleaved,
		buffer::AudioData< T > &	buffer )

Creates an AudioRingBuffer instance. Does not allocate underlying buffer, suitable for real-time use.

Does not delete the buffer on destruction. Make sure to handle deletion.

Parameters

numberOfFrames	The number of frames that the audio ring buffer can hold.
numberOfChannels	The number of channels that the audio ring buffer can hold.
isInterleaved	Indicates whether the audio ring buffer should hold interleaved data.
buffer	The underlying buffer(s) the ring buffer is operating on.

Member Function Documentation

consume()

template<typename T>

void switchboard::AudioRingBuffer< T >::consume	(	AudioBuffer< T > &	destinationBuffer,
		uint	numberOfFrames )

Reads items from the ring buffer.

Parameters

destinationBuffer	[inout] The buffer where the read frames will be copied to.
numberOfFrames	The number of frames that should be consumed.

discard()

template<typename T>

void switchboard::AudioRingBuffer< T >::discard

(

uint

numberOfItems

)

Discards items from the ring buffer. Steps the read pointer without reading the items.

Parameters

numberOfItems

The number of items that should be discarded.

getAvailableFramesToConsume()

template<typename T>

uint switchboard::AudioRingBuffer< T >::getAvailableFramesToConsume

(

)

const

Returns the maximum number of items that can be read from the ring buffer.

Returns

The number frames that can be consumed.

getAvailableFramesToProduce()

template<typename T>

uint switchboard::AudioRingBuffer< T >::getAvailableFramesToProduce ( ) const

nodiscard

Returns the maximum number of frames that can be added to the audio ring buffer.

Returns

The number of frames that can be produced.

produce()

template<typename T>

void switchboard::AudioRingBuffer< T >::produce	(	const AudioBuffer< T > &	sourceBuffer,
		uint	numberOfFrames )

Adds frames to the audio ring buffer.

Parameters

sourceBuffer	The buffer where the frames are copied from.
numberOfFrames	The number of frames that should be added to the audio ring buffer.

read()

template<typename T>

void switchboard::AudioRingBuffer< T >::read	(	AudioBuffer< T > &	destinationBuffer,
		uint	numberOfItems )

Reads items from the ring buffer without updating the read pointer.

Parameters

destinationBuffer	[inout] The buffer where the read frames will be copied to.
numberOfItems	The number of items that should be consumed.

---

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

• AudioRingBuffer.hpp