pattern() [1/4]

template<std::incrementable Index = uint64_t, typename Generator , typename Callback , typename Condition >
requires PatternGenerator<Generator, Index> && PatternCallback<Callback, typename PatternTraits<Generator, Index>::value_type> && PatternCondition<Condition, Index>

std::shared_ptr< Vruta::Routine > MayaFlux::Kriya::pattern	(	Generator	generator,
		Callback	callback,
		Condition	ready,
		Vruta::ProcessingToken	token = Vruta::ProcessingToken::SAMPLE_ACCURATE
	)

Creates a pattern whose next step runs when a condition holds.

Template Parameters

Index

Step index type, default uint64_t

Parameters

generator	Callable from the step index to any value
callback	Callable that takes the generated value
ready	Condition for the step index, checked each time the routine resumes
token	Selects the routine type that runs the pattern

Returns

The routine, or nullptr for an empty function or an unsupported token

The routine suspends and checks ready(index) again until it holds, then runs callback(generator(index)) and advances the index. The value type is whatever the generator returns, so no cast is involved. The condition can be anything that returns a bool: a Logic node's output, a flag, another routine's state. A condition that stays true runs one step per check.

Tokens:

• SAMPLE_ACCURATE: SoundRoutine
• FRAME_ACCURATE: GraphicsRoutine
• MULTI_RATE: CrossRoutine
• CONDITIONAL: FreeRoutine on the condition thread

A function that throws is logged and ends the pattern.

auto routine = Kriya::pattern(
    [](uint64_t step) { return glm::vec2(step, step * 2); },
    [](glm::vec2 point) { use(point); },
    [gate](uint64_t) { return gate->get_last_output() > 0.5; });
scheduler->add_task(routine);