Struct SamplePlayer 

pub struct SamplePlayer<T: Transcendental> { /* private fields */ }

Sample-playback algorithm built on InterpolatedReader.

Plays back a fixed buffer with variable rate, interpolation, and configurable looping. Implements Algorithm for use in signal graphs, and Generator for compatibility with the oscillator trait hierarchy.

Generator parameter mapping

Generator	Meaning for SamplePlayer
frequency	Pitch: rate = freq * len / sample_rate
phase	Normalised position (0 = start, 1 = end of buffer)
amplitude	Output gain

Implementations

impl<T: Transcendental> SamplePlayer<T>

pub fn new(buffer: Vec<T>) -> Self

Create a new SamplePlayer from a sample buffer.

pub fn from_boxed(buffer: Box<[T]>) -> Self

Create a new SamplePlayer from a pre-allocated boxed slice.

pub fn len(&self) -> usize

Number of samples in the buffer.

pub fn is_empty(&self) -> bool

Returns true if the buffer is empty.

pub fn loop_mode(&self) -> LoopMode

Current loop mode.

pub fn set_loop_mode(&mut self, mode: LoopMode)

Set the loop behaviour.

pub fn loop_start(&self) -> f64

Loop start position in samples.

pub fn set_loop_start(&mut self, start: f64)

Set the loop start position.

pub fn loop_end(&self) -> f64

Loop end position in samples.

pub fn set_loop_end(&mut self, end: f64)

Set the loop end position.

pub fn gate(&self) -> bool

Whether the player is gated (playing).

pub fn set_gate(&mut self, gate: bool)

Start / stop playback.

Setting gate = true restarts from the beginning.

pub fn play_state(&self) -> PlayState

Current playback state (stopped or playing).

pub fn set_buffer(&mut self, buffer: Vec<T>)

Replace the sample buffer and reset to loop-start.

pub fn set_cubic(&mut self, cubic: bool)

Enable (true) or disable (false) cubic Hermite interpolation.

pub fn is_cubic(&self) -> bool

Returns true if cubic interpolation is enabled.

pub fn set_playback_rate(&mut self, rate: f64)

Set the playback rate in samples per output sample.

pub fn playback_rate(&self) -> f64

Current playback rate.

Trait Implementations

impl<T: Transcendental> Algorithm<T> for SamplePlayer<T>

fn init(&mut self, sample_rate: f32)

Initialise the algorithm with a sample rate.

fn reset(&mut self)

Reset the algorithm to its initial state.

fn process( &mut self, _input: Option<&[T]>, output: &mut [T], ) -> ProcessResult<()>

Process one block of signal.

fn metadata(&self) -> AlgorithmMetadata

Descriptive metadata (defaults to empty).

fn apply_command(&mut self, _value: T)

Receive a real-time command value from the control path.

impl<T: Transcendental + Copy> Generator<T> for SamplePlayer<T>

fn phase(&self) -> T

Get current phase (0.0 - 1.0)

fn set_phase(&mut self, phase: T)

Set phase

fn reset_phase(&mut self)

Reset phase to 0

fn frequency(&self) -> f32

Get frequency in Hz

fn set_frequency(&mut self, freq: f32)

Set frequency

fn amplitude(&self) -> T

Get amplitude

fn set_amplitude(&mut self, amp: T)

Set amplitude