Struct SnapshotSequencer 

pub struct SnapshotSequencer { /* private fields */ }

The core sequencer state machine.

Driven by incoming CLOCK_TICK telemetry from the audio thread. Call tick or tick_ext every time a clock sample-position arrives; the sequencer checks whether the current step’s duration has elapsed and advances if so, returning the p-lock parameter commands for the new step.

Thread safety

SnapshotSequencer is Send but not Sync. It should live inside a single task (typically the tokio task that drains the telemetry receiver). External control (start/stop/pattern change) uses a command channel (see SequencerHandle).

Implementations

impl SnapshotSequencer

pub fn new() -> Self

Create a new, empty sequencer (no patterns, not running).

pub fn with_lib(snapshots: Vec<Snapshot>, patterns: Vec<Pattern>) -> Self

Create a sequencer pre-loaded with snapshots and patterns.

The first pattern in the vec becomes the active pattern.

pub fn add_snapshot(&mut self, snapshot: Snapshot)

Register or replace a named snapshot.

pub fn get_snapshot(&self, id: &str) -> Option<&Snapshot>

Get a snapshot by ID, if present.

pub fn remove_snapshot(&mut self, id: &str) -> bool

Remove a snapshot by ID. Does not affect existing patterns.

pub fn add_pattern(&mut self, pattern: Pattern)

Register or replace a named pattern.

pub fn get_pattern(&self, id: &str) -> Option<&Pattern>

Get a pattern by ID, if present.

pub fn remove_pattern(&mut self, id: &str) -> bool

Remove a pattern by ID. If it is the active pattern the sequencer stops.

pub fn set_active_pattern(&mut self, id: &str)

Switch to a different pattern (may be empty).

Resets the step counter to 0. If the pattern does not exist the call is ignored.

pub fn active_pattern(&self) -> &str

Active pattern ID.

pub fn start(&mut self)

Start or resume the sequencer from the current step.

pub fn stop(&mut self)

Pause the sequencer (keeps current step position).

pub fn reset(&mut self, sample_pos: u64)

Reset the sequencer to step 0 at the given sample position.

pub fn is_running(&self) -> bool

Whether the sequencer is running.

pub fn current_step(&self) -> usize

Index of the current step within the active pattern.

pub fn latest_beat_position(&self) -> f32

Latest beat position received via tick_ext.

Updated on every clock tick; 0.0 if no tempo data or tick is used.

pub fn is_new_beat(&self) -> bool

Whether the latest clock tick was at a beat boundary.

pub fn is_new_bar(&self) -> bool

Whether the latest clock tick was at a bar boundary.

pub fn tick( &mut self, sample_pos: u64, sample_rate: f32, tempo: f32, ) -> Vec<SetParameter>

Advance the sequencer by one clock tick (basic version).

Convenience wrapper around tick_ext that passes default beat info (beat_position=0, no beat/bar boundaries). Prefer tick_ext when beat-aware CLOCK_TICK telemetry is available.

pub fn tick_ext( &mut self, sample_pos: u64, sample_rate: f32, tempo: f32, beat_position: f32, is_new_beat: bool, is_new_bar: bool, ) -> Vec<SetParameter>

Advance the sequencer by one clock tick with beat-aware telemetry.

Call this from the telemetry listener task every time a CLOCK_TICK event arrives from the audio thread. The extended parameters (beat_position, is_new_beat, is_new_bar) are stored in the sequencer state and can be queried by algorithmic sequencer logic (see latest_beat_position, is_new_beat, is_new_bar).

Returns a batch of SetParameter values to push when a step boundary is crossed, or an empty Vec if no step change occurred.

Trait Implementations

impl Clone for SnapshotSequencer

fn clone(&self) -> SnapshotSequencer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SnapshotSequencer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SnapshotSequencer

fn default() -> Self

Returns the “default value” for a type.