Struct Performance 

pub struct Performance { /* private fields */ }

A running program — see the module docs.

Implementations

impl Performance

pub fn new(program: Arc<Program>) -> Self

Load a compiled program, stopped at frame 0. The engine’s sample rate is the program’s.

pub fn program(&self) -> &Arc<Program>

The running program.

pub fn transport(&self) -> &Transport

The transport (position, loops — seek helpers are also commands).

pub fn master_gain(&self) -> f32

The current master gain.

pub fn metrics(&self) -> PerformanceMetrics

A health snapshot (queue depth is sampled at call time).

pub fn queue_depth(&self) -> usize

The current queue depth.

pub fn clock(&self) -> u64

The command clock (frames rendered).

pub fn schedule( &mut self, command: Command, at: At, ) -> Result<u64, PerformanceError>

Schedule a command at at. Musical positions resolve to exact frames now; identical frames execute in submission order. A full queue rejects the command (counted in the metrics).

pub fn stinger( &mut self, doc: &SoundDoc, gain: f32, at: At, ) -> Result<u64, PerformanceError>

Schedule a stinger: render the doc NOW — the fire inside fill then only mixes a pre-rendered buffer, so the render path never renders or allocates at fire time — and fire it at at with gain.

pub fn swap_to( &mut self, program: Arc<Program>, at: At, ) -> Result<u64, PerformanceError>

Schedule a program swap (crossfaded at at). The target must load clean — a rejected target changes nothing (the last valid program keeps running).

pub fn transition_to_section( &mut self, name: &str, at: At, ) -> Result<u64, PerformanceError>

A quantized section transition: seek to the section’s first bar at the next bar line (or immediately with At::Immediate). The latest transition wins: scheduling one while another is pending drops the older pending seek (defined interruption behavior). An unknown section is rejected now — never a silent no-op later.

pub fn start_capture(&mut self)

Start recording scheduled commands for deterministic replay.

pub fn stop_capture(&mut self) -> Vec<TimestampedCommand>

Stop recording and take the captured commands.

pub fn replay(&mut self, commands: &[TimestampedCommand])

Replay captured commands at their recorded frames, in order.

pub fn snapshot(&self) -> PerformanceSnapshot

A state snapshot: transport position/state, master gain, loop range. Applying it returns the performance to this exact control state.

pub fn apply_snapshot(&mut self, snapshot: &PerformanceSnapshot)

Restore a snapshot (deterministic: the song source re-seeks).

Trait Implementations

impl AudioSource for Performance

fn fill(&mut self, out: &mut [f32]) -> usize

Render interleaved stereo, executing due commands at their exact frames (submission order on ties) — the block is split at command boundaries so a command never lands early or late.

fn reset(&mut self)

Rewind the source to its start (playback position / phase to zero). Defaults to a no-op; a looping source overrides it so a transport can restart it from the top. AdaptiveMusic::reset calls this on each layer.