Struct AudioClip 

pub struct AudioClip {
    sample_rate: u32,
    channels: u16,
    pcm: Arc<[f32]>,
}

Decoded audio: interleaved f32 PCM samples.

Clips are immutable and cheap to clone (sample data is shared). Decoding a file normalizes to MASTER_SAMPLE_RATE and MASTER_CHANNELS; clips built with AudioClip::from_pcm may carry any rate/channels and the mixer adapts them on the fly.

Fields

sample_rate: u32

channels: u16

pcm: Arc<[f32]>

Implementations

impl AudioClip

pub fn from_pcm( pcm: impl Into<Arc<[f32]>>, sample_rate: u32, channels: u16, ) -> Self

Build a clip from interleaved PCM samples.

pub fn sine(freq: f64, secs: f64, amplitude: f64) -> Self

A mono sine tone, mainly for tests and self-contained examples.

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

Available on crate feature audio-decode only.

Decode audio bytes in memory (requires the audio-decode feature).

Any format symphonia supports decodes: WAV, MP3, FLAC, AAC/M4A, Ogg Vorbis. Output is normalized to MASTER_SAMPLE_RATE and MASTER_CHANNELS — other sample rates are resampled with rubato’s FFT resampler, mono is duplicated to stereo, and beyond-stereo channel layouts keep their front left/right pair.

This is the whole-file entry point that works everywhere std::io does, including wasm; AudioClip::from_file is a thin wrapper.

pub fn from_file(path: impl AsRef<Path>) -> Result<Self, AudioError>

Available on crate feature audio-decode only.

Decode an audio file (requires the audio-decode feature).

Pure-Rust decoding via symphonia — no ffmpeg binary on PATH. See AudioClip::from_bytes for the supported formats and the normalization applied to the output.

pub fn sample_rate(&self) -> u32

Sample rate of the PCM data.

pub fn channels(&self) -> u16

Channel count of the interleaved PCM data.

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

The interleaved PCM samples.

pub fn duration_secs(&self) -> f64

Duration in seconds.

fn frames(&self) -> usize

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.