sequence()

MAYAFLUX_API std::shared_ptr< Vruta::Routine > MayaFlux::Kriya::sequence	(	std::vector< std::pair< double, std::function< void()> > >	sequence,
		Vruta::ProcessingToken	token = Vruta::ProcessingToken::SAMPLE_ACCURATE
	)

Creates a temporal sequence that executes callbacks at specified time offsets.

Parameters

scheduler	The task scheduler that will manage this sequence
sequence	Vector of (time_offset, callback) pairs to execute in order
token	Processing token to determine which scheduler rate to use (default: SAMPLE_ACCURATE)

Returns

A Routine shared_ptr of type determined by the processing token of the scheduler (SoundRoutine, GraphicsRoutine, etc.)

The sequence task enables the creation of precisely timed event chains with specific temporal relationships. Each event consists of a time offset (in seconds) and a callback function to execute at that precise moment.

This mechanism is valuable for creating structured temporal progressions, algorithmic sequences, or any series of time-based events that require specific timing relationships. The sequence can coordinate events across multiple domains (audio, visual, data) with sample-accurate precision.

Example usage:

// Create a temporal sequence of events
auto event_sequence = Kriya::sequence({
    {0.0, []() { trigger_event_a(); }},  // Immediate
    {0.5, []() { trigger_event_b(); }},  // 0.5 seconds later
    {1.0, []() { trigger_event_c(); }},  // 1.0 seconds later
    {1.5, []() { trigger_event_d(); }}   // 1.5 seconds later
});
scheduler->add_task(event_sequence);

The sequence task completes after executing all events in the defined timeline.

Definition at line 36 of file Tasks.cpp.

{
    if (token == Vruta::ProcessingToken::FRAME_ACCURATE) {
        auto coro = [](std::vector<std::pair<double, std::function<void()>>> seq) -> Vruta::GraphicsRoutine {
            for (const auto& [time, cb] : seq) {
                co_await FrameDelay { .frames_to_wait = Vruta::seconds_to_frames(time) };
                cb();
            }
        };
        return std::make_shared<Vruta::GraphicsRoutine>(coro(std::move(sequence)));
    }
    auto coro = [](std::vector<std::pair<double, std::function<void()>>> seq) -> Vruta::SoundRoutine {
        for (const auto& [time, cb] : seq) {
            co_await SampleDelay { Vruta::seconds_to_samples(time) };
            cb();
        }
    };
    return std::make_shared<Vruta::SoundRoutine>(coro(std::move(sequence)));
}

References MayaFlux::Vruta::FRAME_ACCURATE, MayaFlux::Kriya::FrameDelay::frames_to_wait, MayaFlux::Vruta::seconds_to_frames(), MayaFlux::Vruta::seconds_to_samples(), and sequence().

Referenced by MayaFlux::schedule_sequence(), and sequence().

Here is the call graph for this function:

Here is the caller graph for this function: