MayaFlux 0.4.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
Graph.cpp
Go to the documentation of this file.
1#include "Graph.hpp"
2
3#include "Core.hpp"
4
5#include "Chronie.hpp"
6
14
16
17namespace MayaFlux {
18
19namespace internal {
20 std::shared_ptr<Buffers::BufferProcessor> attach_quick_process_audio(Buffers::AudioProcessingFunction processor, const std::shared_ptr<Buffers::AudioBuffer>& buffer)
21 {
22 return get_buffer_manager()->attach_quick_process(std::move(processor), buffer, Buffers::ProcessingToken::AUDIO_BACKEND);
23 }
24
25 std::shared_ptr<Buffers::BufferProcessor> attach_quick_process_graphics(Buffers::GraphicsProcessingFunction processor, const std::shared_ptr<Buffers::VKBuffer>& buffer)
26 {
27 return get_buffer_manager()->attach_quick_process(std::move(processor), buffer, Buffers::ProcessingToken::GRAPHICS_BACKEND);
28 }
29}
30
31//-------------------------------------------------------------------------
32// Node Graph Management
33//-------------------------------------------------------------------------
34
35std::shared_ptr<Nodes::NodeGraphManager> get_node_graph_manager()
36{
38}
39
40void register_audio_node(const std::shared_ptr<Nodes::Node>& node, uint32_t channel)
41{
42 auto manager = get_node_graph_manager();
43 if (!manager) {
45 "Node graph manager not initialized - cannot register audio node");
46 return;
47 }
48 if (channel >= manager->get_channel_count(Nodes::ProcessingToken::AUDIO_RATE)) {
49 std::out_of_range err("Channel index out of range for audio node registration");
50 std::cerr << err.what() << '\n';
51 }
52 manager->add_to_root(node, Nodes::ProcessingToken::AUDIO_RATE, channel);
53}
54
55void register_audio_node(const std::shared_ptr<Nodes::Node>& node, const std::vector<uint32_t>& channels)
56{
57 for (const auto& channel : channels) {
59 }
60}
61
62void unregister_audio_node(const std::shared_ptr<Nodes::Node>& node, uint32_t channel)
63{
64 auto manager = get_node_graph_manager();
65 if (!manager) {
67 "Node graph manager not initialized - cannot unregister audio node");
68 return;
69 }
70
71 if (channel >= manager->get_channel_count(Nodes::ProcessingToken::AUDIO_RATE)) {
73 "Channel index out of range for audio node registration");
74 }
75 manager->remove_from_root(node, Nodes::ProcessingToken::AUDIO_RATE, channel);
76}
77
78void unregister_audio_node(const std::shared_ptr<Nodes::Node>& node, const std::vector<uint32_t>& channels)
79{
80 for (const auto& channel : channels) {
82 }
83}
84
85void unregister_node(const std::shared_ptr<Nodes::Node>& node, const Nodes::ProcessingToken& token, uint32_t channel)
86{
87 auto manager = get_node_graph_manager();
88 if (!manager) {
90 "Node graph manager not initialized - cannot register node");
91 return;
92 }
93
94 if (channel >= manager->get_channel_count(token)) {
96 "Channel index out of range for audio node registration");
97 }
98 manager->remove_from_root(node, token, channel);
99}
100
102 const std::shared_ptr<Nodes::Node>& node,
103 const std::vector<uint32_t>& channels,
104 uint32_t num_samples,
105 const Nodes::ProcessingToken& token)
106{
107 get_node_graph_manager()->route_node_to_channels(node, channels, num_samples, token);
108}
109
111 const std::shared_ptr<Nodes::Node>& node,
112 const std::vector<uint32_t>& channels,
113 double seconds_to_fade,
114 const Nodes::ProcessingToken& token)
115{
116 get_node_graph_manager()->route_node_to_channels(node, channels, seconds_to_samples(seconds_to_fade), token);
117}
118
123
124void register_node(const std::shared_ptr<Nodes::Node>& node, const Nodes::ProcessingToken& token, uint32_t channel)
125{
126 get_context().get_node_graph_manager()->add_to_root(node, token, channel);
127}
128
129//-------------------------------------------------------------------------
130// Buffer Management
131//-------------------------------------------------------------------------
132
133std::shared_ptr<Buffers::BufferManager> get_buffer_manager()
134{
136}
137
138void add_processor(const std::shared_ptr<Buffers::BufferProcessor>& processor, const std::shared_ptr<Buffers::Buffer>& buffer, Buffers::ProcessingToken token)
139{
140 get_buffer_manager()->add_processor(processor, buffer, token);
141}
142
143void add_processor(const std::shared_ptr<Buffers::BufferProcessor>& processor, Buffers::ProcessingToken token, uint32_t channel)
144{
145 get_buffer_manager()->add_processor(processor, token, channel);
146}
147
148void add_processor(const std::shared_ptr<Buffers::BufferProcessor>& processor, Buffers::ProcessingToken token)
149{
150 get_buffer_manager()->add_processor(processor, token);
151}
152
153void remove_processor(const std::shared_ptr<Buffers::BufferProcessor>& processor, const std::shared_ptr<Buffers::Buffer>& buffer)
154{
155 get_buffer_manager()->remove_processor(processor, buffer);
156}
157
158void remove_processor(const std::shared_ptr<Buffers::BufferProcessor>& processor, uint32_t channel, Buffers::ProcessingToken token)
159{
160 get_buffer_manager()->remove_processor_from_channel(processor, token, channel);
161}
162
163void remove_processor(const std::shared_ptr<Buffers::BufferProcessor>& processor, Buffers::ProcessingToken token)
164{
165 get_buffer_manager()->remove_processor_from_token(processor, token);
166}
167
168std::shared_ptr<Buffers::BufferProcessingChain> create_processing_chain()
169{
170 return std::make_shared<Buffers::BufferProcessingChain>();
171}
172
177
178void connect_node_to_channel(const std::shared_ptr<Nodes::Node>& node, uint32_t channel_index, float mix, bool clear_before)
179{
180 auto token = get_buffer_manager()->get_default_audio_token();
181 get_buffer_manager()->connect_node_to_channel(node, token, channel_index, mix, clear_before);
182}
183
184void connect_node_to_buffer(const std::shared_ptr<Nodes::Node>& node, const std::shared_ptr<Buffers::AudioBuffer>& buffer, float mix, bool clear_before)
185{
186 get_buffer_manager()->connect_node_to_buffer(node, buffer, mix, clear_before);
187}
188
189//-------------------------------------------------------------------------
190// Node Network Management
191//-------------------------------------------------------------------------
192
193void register_node_network(const std::shared_ptr<Nodes::Network::NodeNetwork>& network, const Nodes::ProcessingToken& token)
194{
195 get_context().get_node_graph_manager()->add_network(network, token);
196}
197
198void unregister_node_network(const std::shared_ptr<Nodes::Network::NodeNetwork>& network, const Nodes::ProcessingToken& token)
199{
200 get_context().get_node_graph_manager()->remove_network(network, token);
201}
202
204 const std::shared_ptr<Nodes::Network::NodeNetwork>& network,
205 const std::vector<uint32_t>& channels,
206 uint32_t num_samples,
207 const Nodes::ProcessingToken& token)
208{
209 get_node_graph_manager()->route_network_to_channels(network, channels, num_samples, token);
210}
211
213 const std::shared_ptr<Nodes::Network::NodeNetwork>& network,
214 const std::vector<uint32_t>& channels,
215 double seconds_to_fade,
216 const Nodes::ProcessingToken& token)
217{
218 get_node_graph_manager()->route_network_to_channels(network, channels, seconds_to_samples(seconds_to_fade), token);
219}
220
221//-------------------------------------------------------------------------
222// Audio Processing
223//-------------------------------------------------------------------------
224
225std::shared_ptr<Buffers::BufferProcessor> attach_quick_process(Buffers::AudioProcessingFunction processor, unsigned int channel_id)
226{
227 return get_buffer_manager()->attach_quick_process(std::move(processor), Buffers::ProcessingToken::AUDIO_BACKEND, channel_id);
228}
229
230void register_audio_buffer(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
231{
233}
234
235void unregister_audio_buffer(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
236{
238}
239
240void register_graphics_buffer(const std::shared_ptr<Buffers::VKBuffer>& buffer, Buffers::ProcessingToken token)
241{
242 get_buffer_manager()->add_buffer(buffer, token);
243}
244
245void unregister_graphics_buffer(const std::shared_ptr<Buffers::VKBuffer>& buffer)
246{
248}
249
250void read_from_audio_input(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
251{
252 get_buffer_manager()->register_input_listener(buffer, channel);
253}
254
255void detach_from_audio_input(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
256{
257 get_buffer_manager()->unregister_input_listener(buffer, channel);
258}
259
260std::shared_ptr<Buffers::AudioBuffer> create_input_listener_buffer(uint32_t channel, bool add_to_output)
261{
262 std::shared_ptr<Buffers::AudioBuffer> buffer = std::make_shared<Buffers::AudioBuffer>(channel);
263
264 if (add_to_output) {
266 }
268
269 return buffer;
270}
271
272std::vector<std::shared_ptr<Buffers::AudioBuffer>> clone_buffer_to_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
273 const std::vector<uint32_t>& channels)
274{
275 return get_buffer_manager()->clone_buffer_for_channels(buffer, channels, Buffers::ProcessingToken::AUDIO_BACKEND);
276}
277
278std::vector<std::shared_ptr<Buffers::AudioBuffer>> clone_buffer_to_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer, const std::vector<uint32_t>& channels, const Buffers::ProcessingToken& token)
279{
280 return get_buffer_manager()->clone_buffer_for_channels(buffer, channels, token);
281}
282
283void supply_buffer_to_channel(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
284 uint32_t channel, double mix)
285{
286 auto manager = get_buffer_manager();
287 if (!manager) {
289 "Buffer manager not initialized - cannot perform supply_buffer_to_channel");
290 return;
291 }
292 if (channel < manager->get_num_channels(Buffers::ProcessingToken::AUDIO_BACKEND)) {
293 manager->supply_buffer_to(buffer, Buffers::ProcessingToken::AUDIO_BACKEND, channel, mix);
294 }
295}
296
297void supply_buffer_to_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
298 const std::vector<uint32_t>& channels,
299 double mix)
300{
301 for (const auto& channel : channels) {
303 }
304}
305
306void remove_supplied_buffer_from_channel(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
307 const uint32_t channel)
308{
309 auto manager = get_buffer_manager();
310
311 if (channel < manager->get_num_channels(Buffers::ProcessingToken::AUDIO_BACKEND)) {
312 manager->remove_supplied_buffer(buffer, Buffers::ProcessingToken::AUDIO_BACKEND, channel);
313 }
314}
315
316void remove_supplied_buffer_from_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
317 const std::vector<uint32_t>& channels)
318{
319 for (const auto& channel : channels) {
321 }
322}
323
325 const std::shared_ptr<Buffers::AudioBuffer>& buffer,
326 uint32_t target_channel,
327 double seconds_to_fade,
328 const Buffers::ProcessingToken& token)
329{
330 get_buffer_manager()->route_buffer_to_channel(
331 buffer, target_channel, seconds_to_blocks(seconds_to_fade), token);
332}
333
335 const std::shared_ptr<Buffers::AudioBuffer>& buffer,
336 uint32_t target_channel,
337 uint32_t num_blocks,
338 const Buffers::ProcessingToken& token)
339{
340 get_buffer_manager()->route_buffer_to_channel(buffer, target_channel, num_blocks, token);
341}
342
343std::shared_ptr<Nodes::Node> operator>>(const std::shared_ptr<Nodes::Node>& lhs, const std::shared_ptr<Nodes::Node>& rhs)
344{
345 auto manager = get_node_graph_manager();
346
347 auto lhs_chain = std::dynamic_pointer_cast<Nodes::ChainNode>(lhs);
348 auto rhs_chain = std::dynamic_pointer_cast<Nodes::ChainNode>(rhs);
349
350 if (lhs_chain) {
351 if (rhs_chain) {
352 lhs_chain->append_chain(rhs_chain);
353 } else {
354 lhs_chain->append(rhs);
355 }
356 lhs_chain->initialize();
357 return lhs_chain;
358 }
359
360 std::shared_ptr<Nodes::ChainNode> chain;
361 if (rhs_chain) {
362 std::vector<std::shared_ptr<Nodes::Node>> nodes;
363 nodes.reserve(1 + rhs_chain->size());
364 nodes.push_back(lhs);
365 for (auto& node : rhs_chain->nodes()) {
366 nodes.push_back(node);
367 }
368 chain = std::make_shared<Nodes::ChainNode>(std::move(nodes), *manager);
369 } else {
370 chain = std::make_shared<Nodes::ChainNode>(lhs, rhs, *manager);
371 }
372
373 chain->initialize();
374 return chain;
375}
376
377std::shared_ptr<Nodes::Node> operator+(const std::shared_ptr<Nodes::Node>& lhs, const std::shared_ptr<Nodes::Node>& rhs)
378{
379 auto manager = get_node_graph_manager();
380 auto result = std::make_shared<Nodes::BinaryOpNode>(
381 lhs, rhs, [](double a, double b) { return a + b; }, *manager);
382 result->initialize();
383 return result;
384}
385
386std::shared_ptr<Nodes::Node> operator*(const std::shared_ptr<Nodes::Node>& lhs, const std::shared_ptr<Nodes::Node>& rhs)
387{
388 auto manager = get_node_graph_manager();
389 auto result = std::make_shared<Nodes::BinaryOpNode>(
390 lhs, rhs, [](double a, double b) { return a * b; }, *manager);
391 result->initialize();
392 return result;
393}
394
395}
#define MF_ERROR(comp, ctx,...)
Core engine lifecycle and configuration API.
size_t a
size_t b
uint32_t channel
Top-level aggregation buffer for computational data streams.
std::shared_ptr< Nodes::NodeGraphManager > get_node_graph_manager()
Gets the node graph manager.
Definition Engine.hpp:267
std::shared_ptr< Buffers::BufferManager > get_buffer_manager()
Gets the buffer manager.
Definition Engine.hpp:285
Container for top-level nodes in a processing channel with multi-modal support.
Definition RootNode.hpp:29
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.
std::function< void(const std::shared_ptr< VKBuffer > &)> GraphicsProcessingFunction
Graphics processing function - receives correctly-typed VKBuffer.
@ NodeProcessing
Node graph processing (Nodes::NodeGraphManager)
@ API
MayaFlux/API Wrapper and convenience functions.
ProcessingToken
Enumerates the different processing domains for nodes.
@ AUDIO_RATE
Nodes that process at the audio sample rate.
std::shared_ptr< Buffers::BufferProcessor > attach_quick_process_audio(Buffers::AudioProcessingFunction processor, const std::shared_ptr< Buffers::AudioBuffer > &buffer)
Definition Graph.cpp:20
std::shared_ptr< Buffers::BufferProcessor > attach_quick_process_graphics(Buffers::GraphicsProcessingFunction processor, const std::shared_ptr< Buffers::VKBuffer > &buffer)
Definition Graph.cpp:25
void connect_node_to_buffer(const std::shared_ptr< Nodes::Node > &node, const std::shared_ptr< Buffers::AudioBuffer > &buffer, float mix, bool clear_before)
Connects a node to a specific buffer.
Definition Graph.cpp:184
std::shared_ptr< Nodes::Node > operator*(const std::shared_ptr< Nodes::Node > &lhs, const std::shared_ptr< Nodes::Node > &rhs)
Combines two nodes in parallel (multiplication)
Definition Graph.cpp:386
std::shared_ptr< Buffers::AudioBuffer > create_input_listener_buffer(uint32_t channel, bool add_to_output)
Creates a new AudioBuffer for input listening.
Definition Graph.cpp:260
void register_node(const std::shared_ptr< Nodes::Node > &node, const Nodes::ProcessingToken &token, uint32_t channel)
Definition Graph.cpp:124
std::shared_ptr< Buffers::BufferProcessingChain > create_processing_chain()
Creates a new processing chain for the default engine.
Definition Graph.cpp:168
void unregister_node(const std::shared_ptr< Nodes::Node > &node, const Nodes::ProcessingToken &token, uint32_t channel)
Removes a node from the root node of specified channels.
Definition Graph.cpp:85
void remove_processor(const std::shared_ptr< Buffers::BufferProcessor > &processor, const std::shared_ptr< Buffers::Buffer > &buffer)
Removes a processor from a specific buffer.
Definition Graph.cpp:153
void unregister_graphics_buffer(const std::shared_ptr< Buffers::VKBuffer > &buffer)
Unregisters a VKBuffer from the default engine's buffer manager.
Definition Graph.cpp:245
void add_processor(const std::shared_ptr< Buffers::BufferProcessor > &processor, const std::shared_ptr< Buffers::Buffer > &buffer, Buffers::ProcessingToken token)
Adds a processor to a specific buffer.
Definition Graph.cpp:138
void route_network(const std::shared_ptr< Nodes::Network::NodeNetwork > &network, const std::vector< uint32_t > &channels, uint32_t num_samples, const Nodes::ProcessingToken &token)
@breif Moves the node from its current channel(s) to the specified channel(s) with an optional fade t...
Definition Graph.cpp:203
std::shared_ptr< Nodes::NodeGraphManager > get_node_graph_manager()
Gets the node graph manager from the default engine.
Definition Graph.cpp:35
std::shared_ptr< Buffers::BufferProcessor > attach_quick_process(Buffers::AudioProcessingFunction processor, unsigned int channel_id)
Attaches a processing function to a specific channel.
Definition Graph.cpp:225
uint64_t seconds_to_samples(double seconds)
Converts a time duration in seconds to the equivalent number of audio samples.
Definition Chronie.cpp:246
std::shared_ptr< Nodes::Node > operator>>(const std::shared_ptr< Nodes::Node > &lhs, const std::shared_ptr< Nodes::Node > &rhs)
Connects two nodes in series (pipeline operator)
Definition Graph.cpp:343
Buffers::RootAudioBuffer & get_root_audio_buffer(uint32_t channel)
Gets the audio buffer for a specific channel.
Definition Graph.cpp:173
void route_node(const std::shared_ptr< Nodes::Node > &node, const std::vector< uint32_t > &channels, uint32_t num_samples, const Nodes::ProcessingToken &token)
@breif Moves the node from its current channel(s) to the specified channel(s) with an optional fade t...
Definition Graph.cpp:101
void register_node_network(const std::shared_ptr< Nodes::Network::NodeNetwork > &network, const Nodes::ProcessingToken &token)
Registers a node network with the default engine's node graph manager.
Definition Graph.cpp:193
std::shared_ptr< Nodes::Node > operator+(const std::shared_ptr< Nodes::Node > &lhs, const std::shared_ptr< Nodes::Node > &rhs)
Combines two nodes in parallel (addition)
Definition Graph.cpp:377
void remove_supplied_buffer_from_channels(const std::shared_ptr< Buffers::AudioBuffer > &buffer, const std::vector< uint32_t > &channels)
Removes a supplied buffer from multiple channels.
Definition Graph.cpp:316
std::vector< std::shared_ptr< Buffers::AudioBuffer > > clone_buffer_to_channels(const std::shared_ptr< Buffers::AudioBuffer > &buffer, const std::vector< uint32_t > &channels)
Clones a buffer to multiple channels.
Definition Graph.cpp:272
void unregister_audio_buffer(const std::shared_ptr< Buffers::AudioBuffer > &buffer, uint32_t channel)
Unregisters an AudioBuffer from the default engine's buffer manager.
Definition Graph.cpp:235
void supply_buffer_to_channels(const std::shared_ptr< Buffers::AudioBuffer > &buffer, const std::vector< uint32_t > &channels, double mix)
Supplies a buffer to multiple channels with mixing.
Definition Graph.cpp:297
void supply_buffer_to_channel(const std::shared_ptr< Buffers::AudioBuffer > &buffer, uint32_t channel, double mix)
Supplies a buffer to a single channel with mixing.
Definition Graph.cpp:283
void route_buffer(const std::shared_ptr< Buffers::AudioBuffer > &buffer, uint32_t target_channel, double seconds_to_fade, const Buffers::ProcessingToken &token)
Routes a buffer from its current channel to a target channel with fade.
Definition Graph.cpp:324
void register_audio_buffer(const std::shared_ptr< Buffers::AudioBuffer > &buffer, uint32_t channel)
Registers an AudioBuffer with the default engine's buffer manager.
Definition Graph.cpp:230
uint64_t seconds_to_blocks(double seconds)
Converts a time duration in seconds to the equivalent number of processing blocks.
Definition Chronie.cpp:255
void detach_from_audio_input(const std::shared_ptr< Buffers::AudioBuffer > &buffer, uint32_t channel)
Stops reading audio data from the default input source.
Definition Graph.cpp:255
void register_audio_node(const std::shared_ptr< Nodes::Node > &node, uint32_t channel)
Adds a node to the root node of a specific channel.
Definition Graph.cpp:40
void unregister_node_network(const std::shared_ptr< Nodes::Network::NodeNetwork > &network, const Nodes::ProcessingToken &token)
Unregisters a node network from the default engine's node graph manager.
Definition Graph.cpp:198
void unregister_audio_node(const std::shared_ptr< Nodes::Node > &node, uint32_t channel)
Removes a node from the root node of a specific channel.
Definition Graph.cpp:62
std::shared_ptr< Buffers::BufferManager > get_buffer_manager()
Gets the buffer manager from the default engine.
Definition Graph.cpp:133
void register_graphics_buffer(const std::shared_ptr< Buffers::VKBuffer > &buffer, Buffers::ProcessingToken token)
Registers a VKBuffer with the default engine's buffer manager.
Definition Graph.cpp:240
Core::Engine & get_context()
Gets the default engine instance.
Definition Core.cpp:68
Nodes::RootNode & get_audio_channel_root(uint32_t channel)
Gets the root node for a specific channel.
Definition Graph.cpp:119
std::vector< double > mix(const std::vector< std::vector< double > > &streams)
Mix multiple data streams with equal weighting.
Definition Yantra.cpp:945
void read_from_audio_input(const std::shared_ptr< Buffers::AudioBuffer > &buffer, uint32_t channel)
Reads audio data from the default input source into a buffer.
Definition Graph.cpp:250
void connect_node_to_channel(const std::shared_ptr< Nodes::Node > &node, uint32_t channel_index, float mix, bool clear_before)
Connects a node to a specific output channel.
Definition Graph.cpp:178
void remove_supplied_buffer_from_channel(const std::shared_ptr< Buffers::AudioBuffer > &buffer, const uint32_t channel)
Removes a supplied buffer from multiple channels.
Definition Graph.cpp:306
Main namespace for the Maya Flux audio engine.
Definition Runtime.cpp:12