MayaFlux 0.3.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) {
58 register_audio_node(node, channel);
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) {
81 unregister_audio_node(node, channel);
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
120{
121 return *get_context().get_node_graph_manager()->get_all_root_nodes(Nodes::ProcessingToken::AUDIO_RATE)[channel];
122}
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
153std::shared_ptr<Buffers::BufferProcessingChain> create_processing_chain()
154{
155 return std::make_shared<Buffers::BufferProcessingChain>();
156}
157
159{
160 return *get_buffer_manager()->get_root_audio_buffer(Buffers::ProcessingToken::AUDIO_BACKEND, channel);
161}
162
163void connect_node_to_channel(const std::shared_ptr<Nodes::Node>& node, uint32_t channel_index, float mix, bool clear_before)
164{
165 auto token = get_buffer_manager()->get_default_audio_token();
166 get_buffer_manager()->connect_node_to_channel(node, token, channel_index, mix, clear_before);
167}
168
169void connect_node_to_buffer(const std::shared_ptr<Nodes::Node>& node, const std::shared_ptr<Buffers::AudioBuffer>& buffer, float mix, bool clear_before)
170{
171 get_buffer_manager()->connect_node_to_buffer(node, buffer, mix, clear_before);
172}
173
174//-------------------------------------------------------------------------
175// Node Network Management
176//-------------------------------------------------------------------------
177
178void register_node_network(const std::shared_ptr<Nodes::Network::NodeNetwork>& network, const Nodes::ProcessingToken& token)
179{
180 get_context().get_node_graph_manager()->add_network(network, token);
181}
182
183void unregister_node_network(const std::shared_ptr<Nodes::Network::NodeNetwork>& network, const Nodes::ProcessingToken& token)
184{
185 get_context().get_node_graph_manager()->remove_network(network, token);
186}
187
189 const std::shared_ptr<Nodes::Network::NodeNetwork>& network,
190 const std::vector<uint32_t>& channels,
191 uint32_t num_samples,
192 const Nodes::ProcessingToken& token)
193{
194 get_node_graph_manager()->route_network_to_channels(network, channels, num_samples, token);
195}
196
198 const std::shared_ptr<Nodes::Network::NodeNetwork>& network,
199 const std::vector<uint32_t>& channels,
200 double seconds_to_fade,
201 const Nodes::ProcessingToken& token)
202{
203 get_node_graph_manager()->route_network_to_channels(network, channels, seconds_to_samples(seconds_to_fade), token);
204}
205
206//-------------------------------------------------------------------------
207// Audio Processing
208//-------------------------------------------------------------------------
209
210std::shared_ptr<Buffers::BufferProcessor> attach_quick_process(Buffers::AudioProcessingFunction processor, unsigned int channel_id)
211{
212 return get_buffer_manager()->attach_quick_process(std::move(processor), Buffers::ProcessingToken::AUDIO_BACKEND, channel_id);
213}
214
215void register_audio_buffer(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
216{
217 get_buffer_manager()->add_buffer(buffer, Buffers::ProcessingToken::AUDIO_BACKEND, channel);
218}
219
220void unregister_audio_buffer(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
221{
222 get_buffer_manager()->remove_buffer(buffer, Buffers::ProcessingToken::AUDIO_BACKEND, channel);
223}
224
225void register_graphics_buffer(const std::shared_ptr<Buffers::VKBuffer>& buffer, Buffers::ProcessingToken token)
226{
227 get_buffer_manager()->add_buffer(buffer, token);
228}
229
230void unregister_graphics_buffer(const std::shared_ptr<Buffers::VKBuffer>& buffer)
231{
233}
234
235void read_from_audio_input(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
236{
237 get_buffer_manager()->register_input_listener(buffer, channel);
238}
239
240void detach_from_audio_input(const std::shared_ptr<Buffers::AudioBuffer>& buffer, uint32_t channel)
241{
242 get_buffer_manager()->unregister_input_listener(buffer, channel);
243}
244
245std::shared_ptr<Buffers::AudioBuffer> create_input_listener_buffer(uint32_t channel, bool add_to_output)
246{
247 std::shared_ptr<Buffers::AudioBuffer> buffer = std::make_shared<Buffers::AudioBuffer>(channel);
248
249 if (add_to_output) {
250 register_audio_buffer(buffer, channel);
251 }
252 read_from_audio_input(buffer, channel);
253
254 return buffer;
255}
256
257std::vector<std::shared_ptr<Buffers::AudioBuffer>> clone_buffer_to_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
258 const std::vector<uint32_t>& channels)
259{
260 return get_buffer_manager()->clone_buffer_for_channels(buffer, channels, Buffers::ProcessingToken::AUDIO_BACKEND);
261}
262
263std::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)
264{
265 return get_buffer_manager()->clone_buffer_for_channels(buffer, channels, token);
266}
267
268void supply_buffer_to_channel(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
269 uint32_t channel, double mix)
270{
271 auto manager = get_buffer_manager();
272 if (!manager) {
274 "Buffer manager not initialized - cannot perform supply_buffer_to_channel");
275 return;
276 }
277 if (channel < manager->get_num_channels(Buffers::ProcessingToken::AUDIO_BACKEND)) {
278 manager->supply_buffer_to(buffer, Buffers::ProcessingToken::AUDIO_BACKEND, channel, mix);
279 }
280}
281
282void supply_buffer_to_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
283 const std::vector<uint32_t>& channels,
284 double mix)
285{
286 for (const auto& channel : channels) {
287 supply_buffer_to_channel(buffer, channel, mix);
288 }
289}
290
291void remove_supplied_buffer_from_channel(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
292 const uint32_t channel)
293{
294 auto manager = get_buffer_manager();
295
296 if (channel < manager->get_num_channels(Buffers::ProcessingToken::AUDIO_BACKEND)) {
297 manager->remove_supplied_buffer(buffer, Buffers::ProcessingToken::AUDIO_BACKEND, channel);
298 }
299}
300
301void remove_supplied_buffer_from_channels(const std::shared_ptr<Buffers::AudioBuffer>& buffer,
302 const std::vector<uint32_t>& channels)
303{
304 for (const auto& channel : channels) {
306 }
307}
308
310 const std::shared_ptr<Buffers::AudioBuffer>& buffer,
311 uint32_t target_channel,
312 double seconds_to_fade,
313 const Buffers::ProcessingToken& token)
314{
315 get_buffer_manager()->route_buffer_to_channel(
316 buffer, target_channel, seconds_to_blocks(seconds_to_fade), token);
317}
318
320 const std::shared_ptr<Buffers::AudioBuffer>& buffer,
321 uint32_t target_channel,
322 uint32_t num_blocks,
323 const Buffers::ProcessingToken& token)
324{
325 get_buffer_manager()->route_buffer_to_channel(buffer, target_channel, num_blocks, token);
326}
327
328std::shared_ptr<Nodes::Node> operator>>(const std::shared_ptr<Nodes::Node>& lhs, const std::shared_ptr<Nodes::Node>& rhs)
329{
330 auto manager = get_node_graph_manager();
331
332 auto lhs_chain = std::dynamic_pointer_cast<Nodes::ChainNode>(lhs);
333 auto rhs_chain = std::dynamic_pointer_cast<Nodes::ChainNode>(rhs);
334
335 if (lhs_chain) {
336 if (rhs_chain) {
337 lhs_chain->append_chain(rhs_chain);
338 } else {
339 lhs_chain->append(rhs);
340 }
341 lhs_chain->initialize();
342 return lhs_chain;
343 }
344
345 std::shared_ptr<Nodes::ChainNode> chain;
346 if (rhs_chain) {
347 std::vector<std::shared_ptr<Nodes::Node>> nodes;
348 nodes.reserve(1 + rhs_chain->size());
349 nodes.push_back(lhs);
350 for (auto& node : rhs_chain->nodes()) {
351 nodes.push_back(node);
352 }
353 chain = std::make_shared<Nodes::ChainNode>(std::move(nodes), *manager);
354 } else {
355 chain = std::make_shared<Nodes::ChainNode>(lhs, rhs, *manager);
356 }
357
358 chain->initialize();
359 return chain;
360}
361
362std::shared_ptr<Nodes::Node> operator+(const std::shared_ptr<Nodes::Node>& lhs, const std::shared_ptr<Nodes::Node>& rhs)
363{
364 auto manager = get_node_graph_manager();
365 auto result = std::make_shared<Nodes::BinaryOpNode>(
366 lhs, rhs, [](double a, double b) { return a + b; }, *manager);
367 result->initialize();
368 return result;
369}
370
371std::shared_ptr<Nodes::Node> operator*(const std::shared_ptr<Nodes::Node>& lhs, const std::shared_ptr<Nodes::Node>& rhs)
372{
373 auto manager = get_node_graph_manager();
374 auto result = std::make_shared<Nodes::BinaryOpNode>(
375 lhs, rhs, [](double a, double b) { return a * b; }, *manager);
376 result->initialize();
377 return result;
378}
379
380}
#define MF_ERROR(comp, ctx,...)
Core engine lifecycle and configuration API.
size_t a
size_t b
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:249
std::shared_ptr< Buffers::BufferManager > get_buffer_manager()
Gets the buffer manager.
Definition Engine.hpp:267
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:169
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:371
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:245
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:153
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 unregister_graphics_buffer(const std::shared_ptr< Buffers::VKBuffer > &buffer)
Unregisters a VKBuffer from the default engine's buffer manager.
Definition Graph.cpp:230
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_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
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:210
uint64_t seconds_to_samples(double seconds)
Converts a time duration in seconds to the equivalent number of audio samples.
Definition Chronie.cpp:244
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:328
Buffers::RootAudioBuffer & get_root_audio_buffer(uint32_t channel)
Gets the audio buffer for a specific channel.
Definition Graph.cpp:158
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:178
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:362
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:301
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:257
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:220
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:282
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:268
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:309
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:215
uint64_t seconds_to_blocks(double seconds)
Converts a time duration in seconds to the equivalent number of processing blocks.
Definition Chronie.cpp:253
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:240
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:188
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:183
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:225
Core::Engine & get_context()
Gets the default engine instance.
Definition Core.cpp:58
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:1021
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:235
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:163
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:291
Main namespace for the Maya Flux audio engine.
Definition LiveAid.hpp:6