Struct Sample 

pub struct Sample { /* private fields */ }

A loaded audio sample — mono or stereo f32 data at a known sample rate.

Implementations

impl Sample

pub fn from_mono(data: Vec<f32>, sample_rate: u32) -> Self

Create a mono sample from raw f32 data.

pub fn from_stereo(data: Vec<f32>, sample_rate: u32) -> Self

Create a stereo sample from interleaved f32 data.

pub fn with_name(self, name: impl Into<String>) -> Self

Set the sample name.

pub fn with_slices(self, slices: Vec<usize>) -> Self

Set slice points manually.

pub fn slices(&self) -> &[usize]

Get slice points.

pub fn detect_onsets(&mut self, threshold: f32, min_slice_frames: usize)

Auto-detect slice points via onset detection (energy-based transient detection).

threshold controls sensitivity (0.0–1.0, lower = more slices). min_slice_frames is the minimum distance between slices.

pub fn data(&self) -> &[f32]

Sample data.

pub fn channels(&self) -> u32

Number of channels.

pub fn sample_rate(&self) -> u32

Sample rate in Hz.

pub fn frames(&self) -> usize

Number of frames.

pub fn name(&self) -> &str

Sample name.

pub fn cubic_hermite(y0: f32, y1: f32, y2: f32, y3: f32, t: f32) -> f32

Cubic Hermite (Catmull-Rom) interpolation between four points.

y0..y3 are sample values at positions idx-1, idx, idx+1, idx+2. t is the fractional position between y1 and y2 (0.0–1.0).

pub fn read_cubic(&self, position: f64) -> f32

Read a mono value using cubic Hermite interpolation.

Uses four points around the position for smooth interpolation. For stereo, averages L+R.

pub fn read_interpolated(&self, position: f64) -> f32

Read a frame at the given position with cubic Hermite interpolation.

Returns mono sample value. For stereo, averages L+R.

pub fn read_stereo_interpolated(&self, position: f64) -> (f32, f32)

Read a stereo frame with cubic Hermite interpolation.

Returns (left, right). For mono samples, both channels are identical.

When the simd feature is enabled on x86_64, both channels are computed in a single SIMD pass using SSE.

Trait Implementations

impl Clone for Sample

fn clone(&self) -> Sample

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sample

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Sample

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Sample

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.