Struct Transport 

pub struct Transport { /* private fields */ }

A sample-accurate musical clock. All arithmetic before the single frame-boundary crossings is the exact rational/f64 segment walk shared with the compiler (ADR 0002), so the transport and the offline render can never disagree about where a beat lands.

Implementations

impl Transport

pub fn for_program(meta: &ProgramMeta) -> Self

A transport for a compiled program, stopped at frame 0.

pub fn sample_rate(&self) -> u32

The clock’s sample rate.

pub fn state(&self) -> TransportState

The current state.

pub fn is_playing(&self) -> bool

Whether the transport is advancing.

pub fn play(&mut self)

Start or resume advancing.

pub fn pause(&mut self)

Hold position.

pub fn stop(&mut self)

Stop and rewind to frame 0.

pub fn frame_at_beat(&self, beat: f64) -> u64

The frame a beat lands on (rounds halves away from zero, ADR 0002).

pub fn beat_at_frame(&self, frame: u64) -> f64

The beat at a frame (the inverse conversion).

pub fn frame_at_bar(&self, bar: u32) -> u64

The frame a bar starts on (through the meter map and pickup).

pub fn position_frames(&self) -> u64

The position in frames.

pub fn position_beats(&self) -> f64

The position in beats.

pub fn position_bars(&self) -> f64

The position in bars (bar index plus intra-bar fraction).

pub fn length_frames(&self) -> u64

The program length in frames.

pub fn seek_frame(&mut self, frame: u64)

Seek to a frame (clamped to the program length).

pub fn seek_beat(&mut self, beat: f64)

Seek to a beat position.

pub fn seek_bar(&mut self, bar: u32)

Seek to a bar (through the meter map and pickup).

pub fn set_loop_frames(&mut self, start: u64, end: u64) -> bool

Loop a frame range [start, end). At end the playhead wraps to start; seeking outside the range is allowed (the loop engages when the playhead reaches end). Invalid ranges (empty, past the end) are rejected with false and leave the old range.

pub fn set_loop_bars(&mut self, start_bar: u32, end_bar: u32) -> bool

Loop a bar range (through the meter map), or report an invalid range.

pub fn clear_loop(&mut self)

Clear the loop range.

pub fn loop_range(&self) -> Option<(u64, u64)>

The loop range in frames, if set.

pub fn advance(&mut self, frames: u64) -> Advance

Advance the playhead by frames (no-op unless Playing). At the loop end the playhead wraps; at the program end with no loop it stops.

Trait Implementations

impl Clone for Transport

fn clone(&self) -> Transport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transport

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

Formats the value using the given formatter.