MayaFlux 0.2.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
BufferManager.cpp
Go to the documentation of this file.
1#include "BufferManager.hpp"
2
4
9
14
15namespace MayaFlux::Buffers {
16
18 uint32_t default_out_channels,
19 uint32_t default_in_channels,
20 uint32_t default_buffer_size,
21 ProcessingToken default_audio_token,
22 ProcessingToken default_graphics_token)
23 : m_unit_manager(std::make_unique<TokenUnitManager>(default_audio_token, default_graphics_token))
24 , m_access_control(std::make_unique<BufferAccessControl>(*m_unit_manager))
25 , m_processor_control(std::make_unique<BufferProcessingControl>(*m_unit_manager, *m_access_control))
26 , m_input_control(std::make_unique<BufferInputControl>())
27 , m_supply_mixing(std::make_unique<BufferSupplyMixing>(*m_unit_manager, *m_access_control))
28 , m_global_processing_chain(std::make_shared<BufferProcessingChain>())
29{
30 validate_num_channels(default_audio_token, default_out_channels, default_buffer_size);
31
32 if (default_in_channels) {
33 m_input_control->setup_audio_input_buffers(default_in_channels, default_buffer_size);
34 }
35
36 auto& a_unit = m_unit_manager->get_or_create_audio_unit(default_audio_token);
37 if (a_unit.channel_count > 0) {
38 auto limiter = std::make_shared<FinalLimiterProcessor>();
39 m_processor_control->set_audio_final_processor(limiter, default_audio_token);
40 }
41
42 auto& g_unit = m_unit_manager->get_or_create_graphics_unit(default_graphics_token);
43 auto present_processor = std::make_shared<PresentProcessor>();
44 m_processor_control->set_graphics_final_processor(present_processor, default_graphics_token);
45}
46
48
49// ============================================================================
50// Processing and Token Management
51// ============================================================================
52
63
65{
66 for (const auto& token : m_unit_manager->get_active_audio_tokens()) {
67 process_token(token, m_unit_manager->get_audio_buffer_size(token));
68 }
69}
70
73 uint32_t channel,
74 uint32_t /*processing_units*/,
75 const std::vector<double>& node_output_data)
76{
77 if (!m_unit_manager->has_audio_unit(token)) {
78 return;
79 }
80
81 auto& unit = m_unit_manager->get_audio_unit_mutable(token);
82 if (channel >= unit.channel_count) {
83 return;
84 }
85
86 auto root_buffer = unit.get_buffer(channel);
87
88 if (!node_output_data.empty()) {
89 root_buffer->set_node_output(node_output_data);
90 }
91
92 for (auto& child : root_buffer->get_child_buffers()) {
93 if (child->needs_default_processing()) {
94 child->process_default();
95 }
96
97 if (auto processing_chain = child->get_processing_chain()) {
98 if (child->has_data_for_cycle()) {
99 processing_chain->process_complete(child);
100 }
101 }
102 unit.get_chain(channel)->process_complete(child);
103 }
104
105 root_buffer->process_default();
106
107 unit.get_chain(channel)->process(root_buffer);
108
109 m_global_processing_chain->process(root_buffer);
110
111 if (auto chain = root_buffer->get_processing_chain()) {
112 chain->process_final(root_buffer);
113 }
114}
115
116std::vector<ProcessingToken> BufferManager::get_active_tokens() const
117{
118 std::vector<ProcessingToken> active_tokens;
119 for (const auto& token : m_unit_manager->get_active_audio_tokens()) {
120 active_tokens.push_back(token);
121 }
122 for (const auto& token : m_unit_manager->get_active_graphics_tokens()) {
123 active_tokens.push_back(token);
124 }
125 return active_tokens;
126}
127
129{
130 auto& unit = m_unit_manager->get_or_create_audio_unit(token);
131 unit.custom_processor = std::move(processor);
132}
133
135{
136 return m_unit_manager->get_default_audio_token();
137}
138
139// ============================================================================
140// Buffer Access (Token-Generic)
141// ============================================================================
142
143std::shared_ptr<RootAudioBuffer> BufferManager::get_root_audio_buffer(ProcessingToken token, uint32_t channel)
144{
145 return m_access_control->get_root_audio_buffer(token, channel);
146}
147
149{
150 return m_access_control->get_root_graphics_buffer(token);
151}
152
153std::vector<double>& BufferManager::get_buffer_data(ProcessingToken token, uint32_t channel)
154{
155 return m_access_control->get_audio_buffer_data(token, channel);
156}
157
158const std::vector<double>& BufferManager::get_buffer_data(ProcessingToken token, uint32_t channel) const
159{
160 return m_access_control->get_audio_buffer_data(token, channel);
161}
162
164{
165 return m_access_control->get_num_audio_out_channels(token);
166}
167
169{
170 return m_access_control->get_audio_buffer_size(token);
171}
172
174{
176 return;
177 }
178 m_access_control->resize_audio_buffers(token, buffer_size);
179}
180
182{
183 m_access_control->ensure_audio_channels(token, channel_count);
184}
185
186std::shared_ptr<BufferProcessingChain> BufferManager::get_processing_chain(ProcessingToken token, uint32_t channel)
187{
188 return m_access_control->get_audio_processing_chain(token, channel);
189}
190
191std::shared_ptr<BufferProcessingChain> BufferManager::get_global_processing_chain()
192{
194}
195
196// ============================================================================
197// Buffer Management (Token-Generic via Dynamic Dispatch)
198// ============================================================================
199
201 const std::shared_ptr<Buffer>& buffer,
203 uint32_t channel)
204{
205 m_access_control->add_buffer(buffer, token, channel);
206}
207
209 const std::shared_ptr<Buffer>& buffer,
211 uint32_t channel)
212{
213 m_access_control->remove_buffer(buffer, token, channel);
214}
215
216const std::vector<std::shared_ptr<AudioBuffer>>& BufferManager::get_buffers(ProcessingToken token, uint32_t channel) const
217{
218 return m_access_control->get_audio_buffers(token, channel);
219}
220
221const std::vector<std::shared_ptr<VKBuffer>>& BufferManager::get_graphics_buffers(ProcessingToken token) const
222{
223 return m_access_control->get_graphics_buffers(token);
224}
225
226std::vector<std::shared_ptr<VKBuffer>> BufferManager::get_buffers_by_usage(
227 VKBuffer::Usage usage,
229{
230 return m_access_control->get_graphics_buffers_by_usage(usage, token);
231}
232
233// ============================================================================
234// Processor Management (Token-Generic)
235// ============================================================================
236
238 const std::shared_ptr<BufferProcessor>& processor,
239 const std::shared_ptr<Buffer>& buffer, ProcessingToken token)
240{
241 m_processor_control->add_processor(processor, buffer, token);
242}
243
245 const std::shared_ptr<BufferProcessor>& processor,
247 uint32_t channel)
248{
249 m_processor_control->add_processor(processor, token, channel);
250}
251
253 const std::shared_ptr<BufferProcessor>& processor,
255{
256 m_processor_control->add_processor(processor, token);
257}
258
260 const std::shared_ptr<BufferProcessor>& processor,
261 const std::shared_ptr<Buffer>& buffer)
262{
263 m_processor_control->remove_processor(processor, buffer);
264}
265
267 const std::shared_ptr<BufferProcessor>& processor,
269 uint32_t channel)
270{
271 m_processor_control->remove_processor_from_token(processor, token, channel);
272}
273
275 const std::shared_ptr<BufferProcessor>& processor,
277{
278 m_processor_control->remove_processor_from_token(processor, token, 0);
279}
280
282 const std::shared_ptr<BufferProcessor>& processor,
284{
285 m_processor_control->set_final_processor(processor, token);
286}
287
288// ============================================================================
289// Quick Processing (Audio-Specific)
290// ============================================================================
291
292std::shared_ptr<BufferProcessor> BufferManager::attach_quick_process(
293 AudioProcessingFunction processor,
294 const std::shared_ptr<Buffer>& buffer, ProcessingToken token)
295{
296 return m_processor_control->attach_quick_process(std::move(processor), buffer, token);
297}
298
299std::shared_ptr<BufferProcessor> BufferManager::attach_quick_process(
301 const std::shared_ptr<Buffer>& buffer, ProcessingToken token)
302{
303 return m_processor_control->attach_quick_process(std::move(processor), buffer, token);
304}
305
306std::shared_ptr<BufferProcessor> BufferManager::attach_quick_process(
307 AudioProcessingFunction processor,
309 uint32_t channel)
310{
311 return m_processor_control->attach_quick_process(std::move(processor), token, channel);
312}
313
314std::shared_ptr<BufferProcessor> BufferManager::attach_quick_process(
315 AudioProcessingFunction processor,
317{
318 return m_processor_control->attach_quick_process(std::move(processor), token);
319}
320
321std::shared_ptr<BufferProcessor> BufferManager::attach_quick_process(
324{
325 return m_processor_control->attach_quick_process(std::move(processor), token);
326}
327
328// ============================================================================
329// Node Connection (Audio-Specific)
330// ============================================================================
331
333 const std::shared_ptr<Nodes::Node>& node,
335 uint32_t channel,
336 float mix,
337 bool clear_before)
338{
339 m_processor_control->connect_node_to_audio_channel(node, token, channel, mix, clear_before);
340}
341
343 const std::shared_ptr<Nodes::Node>& node,
344 const std::shared_ptr<AudioBuffer>& buffer,
345 float mix,
346 bool clear_before)
347{
348 m_processor_control->connect_node_to_audio_buffer(node, buffer, mix, clear_before);
349}
350
351// ============================================================================
352// Data I/O (Audio-Specific)
353// ============================================================================
354
356 const double* interleaved_data,
357 uint32_t num_frames,
359 uint32_t num_channels)
360{
361 m_supply_mixing->fill_audio_from_interleaved(interleaved_data, num_frames, token, num_channels);
362}
363
365 double* interleaved_data,
366 uint32_t num_frames,
368 uint32_t num_channels) const
369{
370 m_supply_mixing->fill_audio_interleaved(interleaved_data, num_frames, token, num_channels);
371}
372
373std::vector<std::shared_ptr<AudioBuffer>> BufferManager::clone_buffer_for_channels(
374 const std::shared_ptr<AudioBuffer>& buffer,
375 const std::vector<uint32_t>& channels,
377{
378 return m_supply_mixing->clone_audio_buffer_for_channels(buffer, channels, token);
379}
380
381// ============================================================================
382// Input Handling (Audio-Specific)
383// ============================================================================
384
385void BufferManager::process_input(double* input_data, uint32_t num_channels, uint32_t num_frames)
386{
387 m_input_control->process_audio_input(input_data, num_channels, num_frames);
388}
389
390void BufferManager::register_input_listener(const std::shared_ptr<AudioBuffer>& buffer, uint32_t channel)
391{
392 m_input_control->register_audio_input_listener(buffer, channel);
393}
394
395void BufferManager::unregister_input_listener(const std::shared_ptr<AudioBuffer>& buffer, uint32_t channel)
396{
397 m_input_control->unregister_audio_input_listener(buffer, channel);
398}
399
400// ============================================================================
401// Buffer Supply/Mixing (Audio-Specific)
402// ============================================================================
403
405 const std::shared_ptr<AudioBuffer>& buffer,
407 uint32_t channel,
408 double mix)
409{
410 return m_supply_mixing->supply_audio_buffer_to(buffer, token, channel, mix);
411}
412
414 const std::shared_ptr<AudioBuffer>& buffer,
416 uint32_t channel)
417{
418 return m_supply_mixing->remove_supplied_audio_buffer(buffer, token, channel);
419}
420
421// ============================================================================
422// Utility
423// ============================================================================
424
426{
427 m_access_control->initialize_buffer_service();
428}
429
431{
432 m_access_control->terminate_active_buffers();
433}
434
435// ============================================================================
436// Private
437// ============================================================================
438
440{
441 if (!m_unit_manager->has_audio_unit(token)) {
442 return;
443 }
444
445 auto& unit = m_unit_manager->get_audio_unit_mutable(token);
446
447 if (unit.custom_processor) {
448 unit.custom_processor(unit.root_buffers, processing_units);
449 return;
450 }
451
452 for (uint32_t channel = 0; channel < unit.channel_count; ++channel) {
453 process_channel(token, channel, processing_units);
454 }
455}
456
458{
459 if (!m_unit_manager->has_graphics_unit(token)) {
460 return;
461 }
462
463 auto& unit = m_unit_manager->get_graphics_unit_mutable(token);
464
465 if (unit.custom_processor) {
466 unit.custom_processor(unit.root_buffer, processing_units);
467 return;
468 }
469
470 auto root_buffer = m_access_control->get_root_graphics_buffer(token);
471
472 // if (!node_output_data.empty()) {
473 // root_buffer->set_node_output(node_output_data);
474 // }
475
476 root_buffer->process_default();
477
478 unit.get_chain()->process(root_buffer);
479
480 m_global_processing_chain->process(root_buffer);
481
482 if (auto chain = root_buffer->get_processing_chain()) {
483 chain->process_final(root_buffer);
484 }
485}
486
487} // namespace MayaFlux::Buffers
static MayaFlux::Nodes::ProcessingToken token
Definition Timers.cpp:8
Token-aware buffer and unit access patterns.
Audio input buffer management and listener coordination.
void ensure_channels(ProcessingToken token, uint32_t channel_count)
Ensures minimum number of channels exist for an audio token.
std::vector< double > & get_buffer_data(ProcessingToken token, uint32_t channel)
Gets data from a specific token and channel (audio-specific)
void remove_processor(const std::shared_ptr< BufferProcessor > &processor, const std::shared_ptr< Buffer > &buffer)
Removes a processor from a buffer.
std::shared_ptr< RootAudioBuffer > get_root_audio_buffer(ProcessingToken token, uint32_t channel=0)
Gets a root buffer for a specific token and channel (audio-specific due to channels)
std::vector< std::shared_ptr< VKBuffer > > get_buffers_by_usage(VKBuffer::Usage usage, ProcessingToken token) const
Gets graphics buffers filtered by usage.
std::shared_ptr< BufferProcessingChain > m_global_processing_chain
Global processing chain applied to all tokens.
const std::vector< std::shared_ptr< AudioBuffer > > & get_buffers(ProcessingToken token, uint32_t channel) const
Gets buffers for a token (audio-specific due to channels)
void set_final_processor(const std::shared_ptr< BufferProcessor > &processor, ProcessingToken token)
Sets a final processor for a token (audio-specific)
void process_audio_token_default(ProcessingToken token, uint32_t processing_units)
void terminate_active_buffers()
Terminates all active buffers, clearing their data.
void add_processor(const std::shared_ptr< BufferProcessor > &processor, const std::shared_ptr< Buffer > &buffer, ProcessingToken token=ProcessingToken::AUDIO_BACKEND)
Adds a processor to a buffer.
uint32_t get_buffer_size(ProcessingToken token) const
Gets the buffer size for a token.
void remove_processor_from_token(const std::shared_ptr< BufferProcessor > &processor, ProcessingToken token)
Removes a processor from all channels in a token (audio-specific)
void register_input_listener(const std::shared_ptr< AudioBuffer > &buffer, uint32_t channel)
void process_graphics_token_default(ProcessingToken token, uint32_t processing_units)
std::unique_ptr< TokenUnitManager > m_unit_manager
Token/unit storage and lifecycle.
void fill_interleaved(double *interleaved_data, uint32_t num_frames, ProcessingToken token, uint32_t num_channels) const
BufferManager(uint32_t default_out_channels=2, uint32_t default_in_channels=0, uint32_t default_buffer_size=512, ProcessingToken default_audio_token=ProcessingToken::AUDIO_BACKEND, ProcessingToken default_graphics_token=ProcessingToken::GRAPHICS_BACKEND)
Creates a new multimodal buffer manager.
uint32_t get_num_channels(ProcessingToken token) const
Gets the number of channels for a token (audio-specific)
bool supply_buffer_to(const std::shared_ptr< AudioBuffer > &buffer, ProcessingToken token, uint32_t channel, double mix=1.0)
std::vector< std::shared_ptr< AudioBuffer > > clone_buffer_for_channels(const std::shared_ptr< AudioBuffer > &buffer, const std::vector< uint32_t > &channels, ProcessingToken token)
std::shared_ptr< RootGraphicsBuffer > get_root_graphics_buffer(ProcessingToken token)
Gets a root graphics buffer for a specific token.
std::unique_ptr< BufferInputControl > m_input_control
Audio input management.
void connect_node_to_buffer(const std::shared_ptr< Nodes::Node > &node, const std::shared_ptr< AudioBuffer > &buffer, float mix=0.5F, bool clear_before=true)
void process_input(double *input_data, uint32_t num_channels, uint32_t num_frames)
std::shared_ptr< BufferProcessor > attach_quick_process(AudioProcessingFunction processor, const std::shared_ptr< Buffer > &buffer, ProcessingToken token=ProcessingToken::AUDIO_BACKEND)
const std::vector< std::shared_ptr< VKBuffer > > & get_graphics_buffers(ProcessingToken token) const
Gets graphics buffers for a token.
std::shared_ptr< BufferProcessingChain > get_global_processing_chain()
Gets the global processing chain (applied to all tokens)
void process_channel(ProcessingToken token, uint32_t channel, uint32_t processing_units, const std::vector< double > &node_output_data={})
Processes a specific channel within a token domain.
void resize_buffers(ProcessingToken token, uint32_t buffer_size)
Resizes buffers for a token.
std::shared_ptr< BufferProcessingChain > get_processing_chain(ProcessingToken token, uint32_t channel)
Gets the processing chain for a token and channel (audio-specific)
std::unique_ptr< BufferProcessingControl > m_processor_control
Processor attachment/removal operations.
void fill_from_interleaved(const double *interleaved_data, uint32_t num_frames, ProcessingToken token, uint32_t num_channels)
void remove_processor_from_channel(const std::shared_ptr< BufferProcessor > &processor, ProcessingToken token, uint32_t channel)
Removes a processor from a token and channel (audio-specific)
void remove_buffer(const std::shared_ptr< Buffer > &buffer, ProcessingToken token, uint32_t channel=0)
Removes a buffer from a token.
void validate_num_channels(ProcessingToken token, uint32_t num_channels, uint32_t buffer_size)
Validates the number of channels and resizes buffers if necessary (audio-specific)
ProcessingToken get_default_audio_token() const
Gets the default processing token used by the manager.
void connect_node_to_channel(const std::shared_ptr< Nodes::Node > &node, ProcessingToken token, uint32_t channel, float mix=0.5F, bool clear_before=false)
void process_token(ProcessingToken token, uint32_t processing_units)
Processes all buffers for a specific token.
void unregister_input_listener(const std::shared_ptr< AudioBuffer > &buffer, uint32_t channel)
bool remove_supplied_buffer(const std::shared_ptr< AudioBuffer > &buffer, ProcessingToken token, uint32_t channel)
void register_audio_token_processor(ProcessingToken token, RootAudioProcessingFunction processor)
Registers a custom processor for an audio token domain.
std::unique_ptr< BufferSupplyMixing > m_supply_mixing
Buffer supply and mixing operations.
std::unique_ptr< BufferAccessControl > m_access_control
Buffer and unit access operations.
void add_buffer(const std::shared_ptr< Buffer > &buffer, ProcessingToken token, uint32_t channel=0)
Adds a buffer to a token and channel.
std::vector< ProcessingToken > get_active_tokens() const
Gets all currently active processing tokens.
void process_all_tokens()
Processes all active tokens with their configured processing units.
Advanced pipeline manager for multi-stage buffer transformations with backend optimization.
Processor attachment, removal, and processing chain management.
External buffer supply, mixing, and interleaved data I/O.
Token-scoped unit storage and lifecycle management.
std::function< void(const std::shared_ptr< AudioBuffer > &)> AudioProcessingFunction
Audio processing function - receives correctly-typed AudioBuffer.
ProcessingToken
Bitfield enum defining processing characteristics and backend requirements for buffer operations.
@ AUDIO_BACKEND
Standard audio processing backend configuration.
@ GRAPHICS_BACKEND
Standard graphics processing backend configuration.
@ AUDIO_PARALLEL
High-performance audio processing with GPU acceleration.
std::function< void(std::vector< std::shared_ptr< RootAudioBuffer > > &, uint32_t)> RootAudioProcessingFunction
std::function< void(const std::shared_ptr< VKBuffer > &)> GraphicsProcessingFunction
Graphics processing function - receives correctly-typed VKBuffer.
std::vector< double > mix(const std::vector< std::vector< double > > &streams)
Mix multiple data streams with equal weighting.
Definition Yantra.cpp:1019