MayaFlux 0.4.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches

◆ finalise()

void MayaFlux::Nexus::Wiring::finalise ( )

Apply the configured wiring.

Resolves the builder state into a coroutine (if any scheduling modifier was set) or an immediate call (if bind was used), and registers the result with Fabric.

Definition at line 233 of file Wiring.cpp.

234{
235 auto& scheduler = m_fabric.m_scheduler;
236 auto& ev_manager = m_fabric.m_event_manager;
237 const uint32_t id = m_entity_id;
238 auto& reg = m_fabric.m_registrations[id];
239
240 bool has_any_path = !std::holds_alternative<std::monostate>(m_factory)
241 || m_event_factory.has_value()
242 || m_bind_attach.has_value()
243 || !m_move_steps.empty()
244 || !std::holds_alternative<std::monostate>(m_trigger)
245 || m_interval.has_value();
246
247 reg.commit_driven = !has_any_path;
248
249 // ------------------------------------------------------------------
250 // Register named callables before any early return.
251 // ------------------------------------------------------------------
252 std::visit([&](const auto& ptr) {
253 using T = std::decay_t<decltype(*ptr)>;
254 if constexpr (std::is_same_v<T, Emitter>) {
255 if (!ptr->fn_name().empty()) {
256 m_fabric.m_influence_fns.try_emplace(
257 ptr->fn_name(), std::make_shared<Emitter::InfluenceFn>(ptr->fn()));
258 }
259 } else if constexpr (std::is_same_v<T, Sensor>) {
260 if (!ptr->fn_name().empty()) {
261 m_fabric.m_perception_fns.try_emplace(
262 ptr->fn_name(), std::make_shared<Sensor::PerceptionFn>(ptr->fn()));
263 }
264 } else if constexpr (std::is_same_v<T, Agent>) {
265 if (!ptr->influence_fn_name().empty()) {
266 m_fabric.m_influence_fns.try_emplace(
267 ptr->influence_fn_name(), std::make_shared<Emitter::InfluenceFn>(ptr->influence_fn()));
268 }
269 if (!ptr->perception_fn_name().empty()) {
270 m_fabric.m_perception_fns.try_emplace(
271 ptr->perception_fn_name(), std::make_shared<Sensor::PerceptionFn>(ptr->perception_fn()));
272 }
273 }
274 },
275 reg.member);
276
277 // ------------------------------------------------------------------
278 // Routine factory path
279 // ------------------------------------------------------------------
280 if (!std::holds_alternative<std::monostate>(m_factory)) {
281 auto name = make_name("nexus_task");
282 reg.task_name = name;
283 std::visit([&](auto& factory) {
284 using F = std::decay_t<decltype(factory)>;
285 if constexpr (!std::is_same_v<F, std::monostate>) {
286 scheduler.add_task(
287 std::make_shared<std::invoke_result_t<F, Vruta::TaskScheduler&>>(factory(scheduler)),
288 name, false);
289 }
290 },
291 m_factory);
292 m_fabric.m_registrations[m_entity_id].wiring.emplace(std::move(*this));
293 return;
294 }
295
296 // ------------------------------------------------------------------
297 // Event factory path
298 // ------------------------------------------------------------------
299 if (m_event_factory.has_value()) {
300 auto name = make_name("nexus_event");
301 reg.event_name = name;
302 ev_manager.add_event(
303 std::make_shared<Vruta::Event>((*m_event_factory)(scheduler)),
304 name);
305 m_fabric.m_registrations[m_entity_id].wiring.emplace(std::move(*this));
306 return;
307 }
308
309 // ------------------------------------------------------------------
310 // Immediate bind path
311 // ------------------------------------------------------------------
312 if (m_bind_attach.has_value()) {
313 (*m_bind_attach)();
314
315 if (m_duration.has_value() && m_bind_detach.has_value()) {
316 auto timer = std::make_shared<Kriya::Timer>(scheduler);
317 auto detach = *m_bind_detach;
318 timer->schedule(*m_duration, [timer, detach]() {
319 detach();
320 });
321 }
322 m_fabric.m_registrations[m_entity_id].wiring.emplace(std::move(*this));
323 return;
324 }
325
326 // ------------------------------------------------------------------
327 // Choreographed position path
328 // ------------------------------------------------------------------
329 if (!m_move_steps.empty()) {
330 auto name = make_name("nexus_chain");
331 reg.chain_name = name;
332
333 Kriya::EventChain chain(scheduler, name);
334 auto& fab = m_fabric;
335 for (auto& step : m_move_steps) {
336 glm::vec3 pos = step.position;
337 chain.then([&fab, pos, id]() {
338 std::visit([&pos](const auto& ptr) {
339 ptr->set_position(pos);
340 },
341 fab.m_registrations[id].member);
342 fab.fire(id);
343 },
344 step.delay_seconds);
345 }
346 if (m_times > 1) {
347 chain.times(m_times);
348 }
349 chain.start();
350 m_fabric.m_registrations[m_entity_id].wiring.emplace(std::move(*this));
351 return;
352 }
353
354 // ------------------------------------------------------------------
355 // Trigger path
356 // ------------------------------------------------------------------
357 if (!std::holds_alternative<std::monostate>(m_trigger)) {
358 std::visit([&](auto& trig) {
359 using T = std::decay_t<decltype(trig)>;
360
361 if constexpr (std::is_same_v<T, KeyTrigger>) {
362 auto name = make_name("nexus_event");
363 reg.event_name = name;
364 auto& fab = m_fabric;
365 ev_manager.add_event(
366 std::make_shared<Vruta::Event>(
367 Kriya::key_pressed(trig.window, trig.key,
368 [&fab, id]() { fab.fire(id); })),
369 name);
370
371 } else if constexpr (std::is_same_v<T, MouseTrigger>) {
372 auto name = make_name("nexus_event");
373 reg.event_name = name;
374 ev_manager.add_event(
375 std::make_shared<Vruta::Event>(
376 Kriya::mouse_pressed(trig.window, trig.button,
377 [this, id](double, double) { m_fabric.fire(id); })),
378 name);
379
380 } else if constexpr (std::is_same_v<T, NetworkTrigger>) {
381 auto name = make_name("nexus_task");
382 reg.task_name = name;
383 scheduler.add_task(
384 std::make_shared<Vruta::SoundRoutine>(
385 network_loop(*trig.source, m_fabric, id)),
386 name, false);
387
388 } else if constexpr (std::is_same_v<T, EventTrigger>) {
389 auto name = make_name("nexus_event");
390 reg.event_name = name;
391 ev_manager.add_event(
392 std::make_shared<Vruta::Event>(
393 event_source_loop(*trig.source, m_fabric, id)),
394 name);
395 }
396 },
397 m_trigger);
398 m_fabric.m_registrations[m_entity_id].wiring.emplace(std::move(*this));
399 return;
400 }
401
402 // ------------------------------------------------------------------
403 // Metro path
404 // ------------------------------------------------------------------
405 if (m_interval.has_value()) {
406 auto pos_fn = m_position_fn;
407 auto name = make_name("nexus_metro");
408 reg.task_name = name;
409 auto& fab = m_fabric;
410
411 scheduler.add_task(
412 std::make_shared<Vruta::SoundRoutine>(
413 Kriya::metro(scheduler, *m_interval, [&fab, id, pos_fn]() mutable {
414 if (pos_fn.has_value()) {
415 glm::vec3 p = (*pos_fn)();
416 std::visit([&p](const auto& ptr) {
417 ptr->set_position(p);
418 },
419 fab.m_registrations[id].member);
420 }
421 fab.fire(id);
422 })),
423 name, false);
424
425 if (m_duration.has_value()) {
426 auto cancel_name = make_name("nexus_metro_cancel");
427 auto timer = std::make_shared<Kriya::Timer>(scheduler);
428 timer->schedule(*m_duration, [name, timer, &scheduler]() {
429 scheduler.cancel_task(name);
430 });
431 }
432 }
433
434 m_fabric.m_registrations[m_entity_id].wiring.emplace(std::move(*this));
435}
uint32_t id
std::unordered_map< std::string, std::shared_ptr< Sensor::PerceptionFn > > m_perception_fns
Definition Fabric.hpp:229
Vruta::TaskScheduler & m_scheduler
Definition Fabric.hpp:221
std::unordered_map< uint32_t, Registration > m_registrations
Definition Fabric.hpp:225
std::unordered_map< std::string, std::shared_ptr< Emitter::InfluenceFn > > m_influence_fns
Definition Fabric.hpp:228
Vruta::EventManager & m_event_manager
Definition Fabric.hpp:222
std::optional< std::function< void()> > m_bind_detach
Definition Wiring.hpp:244
std::string make_name(const char *prefix) const
Definition Wiring.cpp:182
std::optional< std::function< void()> > m_bind_attach
Definition Wiring.hpp:243
std::optional< double > m_duration
Definition Wiring.hpp:232
std::optional< double > m_interval
Definition Wiring.hpp:231
const Factory & factory() const
Active factory variant set by use for non-Event factories.
Definition Wiring.hpp:281
std::vector< MoveStep > m_move_steps
Definition Wiring.hpp:235
std::optional< PositionFn > m_position_fn
Definition Wiring.hpp:233
Tendency< A, C > chain(const Tendency< A, B > &first, const Tendency< B, C > &second)
Sequential composition: evaluate first, feed result into second.
Definition Tendency.hpp:82
Vruta::Event key_pressed(std::shared_ptr< Core::Window > window, IO::Keys key, std::function< void()> callback)
Creates an Event coroutine that triggers on specific key press.
Vruta::Event mouse_pressed(std::shared_ptr< Core::Window > window, IO::MouseButtons button, std::function< void(double, double)> callback)
Creates an Event coroutine that triggers on specific mouse button press.
Vruta::SoundRoutine metro(Vruta::TaskScheduler &scheduler, double interval_seconds, std::function< void()> callback)
Creates a periodic event generator that executes a callback at regular intervals.
Definition Tasks.cpp:10

References factory(), id, MayaFlux::Kriya::key_pressed(), m_bind_attach, m_bind_detach, m_duration, m_entity_id, m_event_factory, MayaFlux::Nexus::Fabric::m_event_manager, m_fabric, m_factory, MayaFlux::Nexus::Fabric::m_influence_fns, m_interval, m_move_steps, MayaFlux::Nexus::Fabric::m_perception_fns, m_position_fn, MayaFlux::Nexus::Fabric::m_registrations, MayaFlux::Nexus::Fabric::m_scheduler, m_times, m_trigger, make_name(), MayaFlux::Kriya::metro(), and MayaFlux::Kriya::mouse_pressed().

+ Here is the call graph for this function: