Struct SamplePlayer 

pub struct SamplePlayer { /* private fields */ }

Mono sample player with V/Oct pitch, start position, and looping.

Parameter reads via ModulatedParam (Q147)

Pitch and start position are read through ModulatedParam, making that type a live part of a real DSP path rather than an unused export:

• pitch uses a ParamRange::VoltPerOctave mapping. Its base field carries the coarse V/Oct pitch from the voct input, and its value is 2^voct, so 0 V plays at unity rate and +1 V doubles the playback speed.
• start uses a ParamRange::Linear 0..1 mapping. Its base is the panel start-position knob and its CV comes from the start input (normalized on the ModulatedParam ±5 V scale), combined into a normalized 0..1 position.

Implementations

impl SamplePlayer

pub fn new( buffer: Vec<f64>, buffer_sample_rate: f64, engine_sample_rate: f64, ) -> Self

Create a player over buffer recorded at buffer_sample_rate, running in a graph at engine_sample_rate.

pub fn empty(engine_sample_rate: f64) -> Self

Create an empty player (silent until a buffer is assigned).

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

Replace the sample buffer (non-real-time; allocates/moves the Vec).

Resets playback state so a stale read position cannot index past a shorter new buffer.

pub fn len(&self) -> usize

Number of samples in the loaded buffer.

pub fn is_empty(&self) -> bool

Whether the loaded buffer is empty.

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

Set the panel start-position knob (0..1), the base of the start ModulatedParam.

pub fn start_position(&self) -> f64

Current start-position knob (0..1).

Trait Implementations

impl Default for SamplePlayer

fn default() -> Self

Returns the “default value” for a type.

impl GraphModule for SamplePlayer

fn port_spec(&self) -> &PortSpec

Returns the module’s port specification

fn tick(&mut self, inputs: &PortValues, outputs: &mut PortValues)

Process one sample given port values

fn reset(&mut self)

Reset internal state

fn set_sample_rate(&mut self, sample_rate: f64)

Set sample rate

fn type_id(&self) -> &'static str

Get module type identifier for serialization

fn process_block( &mut self, inputs: &BlockPortValues, outputs: &mut BlockPortValues, frames: usize, )

Process a block of samples (optional optimization).

fn breaks_feedback_cycle(&self) -> bool

Whether this module breaks a feedback cycle in the patch graph.

fn params(&self) -> &[ParamDef]

Get parameter definitions for UI binding.

fn get_param(&self, _id: ParamId) -> Option<f64>

Get a parameter value.

fn set_param(&mut self, _id: ParamId, _value: f64)

Set a parameter value.

fn serialize_state(&self) -> Option<Value>

Available on crate feature alloc only.

Serialize module state (alloc feature only)

fn deserialize_state(&mut self, _state: &Value) -> Result<(), String>

Available on crate feature alloc only.

Deserialize module state (alloc feature only)

fn introspect(&self) -> Option<&dyn ModuleIntrospection>

Available on crate feature alloc only.

Downcast this module to its ModuleIntrospection view, if it exposes one.

fn introspect_mut(&mut self) -> Option<&mut dyn ModuleIntrospection>

Available on crate feature alloc only.

Mutable companion to introspect, used to set internal parameters.

impl ModuleIntrospection for SamplePlayer

Available on crate feature alloc only.

fn param_infos(&self) -> Vec<ParamInfo>

Get all parameter descriptors for this module

fn set_param_by_id(&mut self, id: &str, value: f64) -> bool

Set a parameter value by its ID

fn get_param_info(&self, id: &str) -> Option<ParamInfo>

Get a specific parameter by its ID