MayaFlux 0.3.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
MayaFlux::Buffers::FeedbackBuffer Class Reference

Buffer with temporal memory for recursive processing. More...

#include <FeedbackBuffer.hpp>

+ Inheritance diagram for MayaFlux::Buffers::FeedbackBuffer:
+ Collaboration diagram for MayaFlux::Buffers::FeedbackBuffer:

Public Member Functions

 FeedbackBuffer (uint32_t channel_id, uint32_t num_samples, float feedback=0.5F, uint32_t feed_samples=512)
 Construct feedback buffer.
 
float get_feedback () const
 Get feedback coefficient.
 
void set_feedback (float amount)
 Set feedback coefficient.
 
Memory::HistoryBuffer< double > & get_history_buffer ()
 Get mutable access to the history buffer.
 
const Memory::HistoryBuffer< double > & get_history_buffer () const
 Get read-only access to the history buffer.
 
void process_default () override
 Applies the default audio transformation to the buffer's data.
 
void set_feed_samples (uint32_t samples)
 Set delay length in samples.
 
uint32_t get_feed_samples () const
 Get delay length in samples.
 
- Public Member Functions inherited from MayaFlux::Buffers::AudioBuffer
 AudioBuffer ()
 Creates a new uninitialized audio buffer.
 
 AudioBuffer (uint32_t channel_id, uint32_t num_samples=512)
 Creates a new audio buffer with specified channel and capacity.
 
 ~AudioBuffer () override=default
 Virtual destructor for proper resource management.
 
virtual void setup (uint32_t channel, uint32_t num_samples)
 Initializes the audio buffer with specified channel and capacity.
 
virtual void setup_processors (ProcessingToken token)
 Sets up audio processors for the specified processing token.
 
virtual void resize (uint32_t num_samples)
 Adjusts the audio buffer's sample capacity.
 
void clear () override
 Resets all audio samples in the buffer to silence.
 
virtual uint32_t get_num_samples () const
 Gets the current capacity of the audio buffer.
 
virtual std::vector< double > & get_data ()
 Gets mutable access to the buffer's underlying audio data.
 
virtual const std::vector< double > & get_data () const
 Gets read-only access to the buffer's underlying audio data.
 
virtual uint32_t get_channel_id () const
 Gets the audio channel identifier for this buffer.
 
void set_channel_id (uint32_t id)
 Sets the audio channel identifier for this buffer.
 
virtual void set_num_samples (uint32_t num_samples)
 Sets the capacity of the audio buffer.
 
void set_default_processor (const std::shared_ptr< BufferProcessor > &processor) override
 Sets the default audio transformation processor for this buffer.
 
std::shared_ptr< BufferProcessorget_default_processor () const override
 Gets the current default audio transformation processor.
 
std::shared_ptr< BufferProcessingChainget_processing_chain () override
 Gets the audio transformation chain attached to this buffer.
 
void set_processing_chain (const std::shared_ptr< BufferProcessingChain > &chain, bool force=false) override
 Sets the audio transformation chain for this buffer.
 
virtual double & get_sample (uint32_t index)
 Gets a reference to a specific audio sample in the buffer.
 
bool has_data_for_cycle () const override
 Checks if the audio buffer has data for the current processing cycle.
 
bool needs_removal () const override
 Checks if the buffer should be removed from the processing chain This is relevant when using SignalSourceContainers.
 
void mark_for_processing (bool has_data) override
 Marks the audio buffer for processing in the current cycle.
 
void mark_for_removal () override
 Marks the audio buffer for removal from processing chains.
 
void enforce_default_processing (bool should_process) override
 Controls whether the audio buffer should use default processing.
 
bool needs_default_processing () override
 Checks if the audio buffer should undergo default processing.
 
bool try_acquire_processing () override
 Attempts to acquire processing rights for the buffer.
 
void release_processing () override
 Releases processing rights for the buffer.
 
bool is_processing () const override
 Checks if the buffer is currently being processed.
 
virtual std::shared_ptr< AudioBufferclone_to (uint32_t channel)
 Creates a clone of this audio buffer for a specific channel.
 
std::shared_ptr< Bufferclone_to (uint8_t dest_desc) override
 Creates a clone of this buffer for a specific channel or usage enum.
 
virtual bool read_once (const std::shared_ptr< AudioBuffer > &buffer, bool force=false)
 Reads audio data into the buffer from the audio backend.
 
void force_internal_usage (bool internal) override
 Marks the buffer as internal-only, preventing root aggregation.
 
bool is_internal_only () const override
 Checks if the buffer is marked as internal-only.
 
const BufferRoutingStateget_routing_state () const
 Retrieves the current routing state of the buffer.
 
BufferRoutingStateget_routing_state ()
 Retrieves the current routing state of the buffer (non-const)
 
bool needs_routing () const
 Checks if the buffer is currently in a routing transition phase.
 
- Public Member Functions inherited from MayaFlux::Buffers::Buffer
virtual ~Buffer ()=default
 Virtual destructor for proper resource management.
 

Protected Member Functions

std::shared_ptr< BufferProcessorcreate_default_processor () override
 Creates a default audio transformation processor for this buffer type.
 

Private Attributes

float m_feedback_amount
 
uint32_t m_feed_samples
 
Memory::HistoryBuffer< double > m_history
 

Additional Inherited Members

- Protected Attributes inherited from MayaFlux::Buffers::AudioBuffer
uint32_t m_channel_id
 Audio channel identifier for this buffer.
 
uint32_t m_num_samples
 Capacity of the buffer in audio samples.
 
std::vector< double > m_data
 Vector storing the actual double-precision audio sample data.
 
std::shared_ptr< BufferProcessorm_default_processor
 Default audio transformation processor for this buffer.
 
std::shared_ptr< BufferProcessingChainm_processing_chain
 Audio transformation processing chain for this buffer.
 
bool m_has_data
 Whether the audio buffer has data to process this cycle.
 
bool m_should_remove
 Whether the audio buffer should be removed from processing chains.
 
bool m_process_default
 Whether the audio buffer should be processed using its default processor.
 
BufferRoutingState m_routing_state
 Internal state tracking for routing transitions.
 

Detailed Description

Buffer with temporal memory for recursive processing.

FeedbackBuffer extends AudioBuffer with a HistoryBuffer that maintains the previous processing state, enabling delay-line feedback and recursive algorithms. The history buffer provides proper temporal indexing where [0] = most recent sample and [k] = k samples ago.

The feedback path is: output[n] = input[n] + feedback_amount * history[feed_samples]

For filtering in the feedback path, attach a FilterProcessor to the buffer's processing chain rather than relying on hardcoded averaging.

Definition at line 25 of file FeedbackBuffer.hpp.


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