Struct AudioClip 

pub struct AudioClip { /* private fields */ }

Decoded PCM held in memory, ready to play with no further work.

Samples are interleaved f32 in -1.0..=1.0, one or two channels. The buffer sits behind an Arc so handing a clip to the audio thread is a refcount bump rather than a copy.

Implementations

impl AudioClip

pub const MAX_FRAMES: usize

The largest clip the framework accepts, guarding a malformed header from turning into a multi-gigabyte allocation.

pub fn from_samples( samples: Vec<f32>, channels: u16, sample_rate: u32, ) -> Result<AudioClip, AudioError>

Wraps already-decoded interleaved samples.

pub fn decode(bytes: &[u8]) -> Result<AudioClip, AudioError>

Decodes an encoded clip. RIFF/WAVE is understood everywhere; anything else reports AudioError::UnsupportedFormat.

Run this wherever the bytes arrive — including a worker thread — and hand the result to AudioPlayer::load_clip when it is ready.

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

The interleaved samples.

pub fn shared_samples(&self) -> Arc<[f32]>

The shared sample buffer, for a backend that keeps its own reference.

pub fn channels(&self) -> u16

Channel count: 1 or 2.

pub fn sample_rate(&self) -> u32

The clip’s recorded sample rate in Hz.

pub fn frames(&self) -> usize

Frame count (samples divided by channels).

pub fn duration_secs(&self) -> f32

Playing length in seconds at unity rate.

Trait Implementations

impl Clone for AudioClip

fn clone(&self) -> AudioClip

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AudioClip

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

Formats the value using the given formatter.