Expand description
Parameter-lock step sequencer
§Parameter-lock step sequencer
A sample-accurate, telemetry-driven sequencer for scheduling parameter changes over time. Supports parameter-lock (p-lock) style programming: each step specifies exactly which parameters change and to what value; unlisted parameters are untouched.
§Concepts
ParameterTarget— a single (node, param, value) lockSequenceStep— a set of p-locks + durationPattern— a sequence of steps with a playback modeSnapshot— a named collection of p-locks (convenience presets)SnapshotSequencer— tick-driven state machine
§Clock source
The sequencer is designed to be driven by the audio thread’s CLOCK_TICK
telemetry events. Each tick carries (sample_pos, sample_rate, tempo),
which the sequencer uses to determine step boundaries with sample accuracy.
§Integration
Use PatchbayControl::attach_sequencer
or PatchbayEngine::attach_sequencer
to spawn the sequencer task and start listening for clock ticks.
A SequencerHandle is returned for external control (start/stop/pattern
select).
Structs§
- Parameter
Target - A single parameter target within a snapshot or step.
- Pattern
- A sequence of steps forming a pattern.
- Sequence
Step - A single step in a sequencer pattern.
- Sequencer
Handle - Handle for controlling a
SnapshotSequencerthat lives inside a tokio task. - Snapshot
- A named collection of parameter values — a complete preset “scene”.
- Snapshot
Sequencer - The core sequencer state machine.
Enums§
- Sequencer
Command - Commands sent to a running sequencer from another thread.
- Step
Play Mode - Playback mode for a pattern.