Enum AudioFormat 

#[non_exhaustive]
pub enum AudioFormat {
    U8,
    S16,
    S32,
    F32,
    U8Planar,
    S16Planar,
    S32Planar,
    F32Planar,
}

Raw PCM sample format.

Mirrors the WebCodecs AudioData.format enum so callers can pass microphone or speaker buffers across the FFI boundary unchanged.

Interleaved variants pack samples as [c0_s0, c1_s0, c0_s1, c1_s1, ...]. Planar variants pack as [c0_s0, c0_s1, ..., c1_s0, c1_s1, ...].

See https://developer.mozilla.org/en-US/docs/Web/API/AudioData/format.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

U8

S16

S32

F32

Default: matches libopus’s native interleaved layout.

U8Planar

S16Planar

S32Planar

F32Planar

Implementations

impl AudioFormat

pub fn bytes_per_sample(self) -> usize

Bytes used per single-channel sample.

pub fn is_planar(self) -> bool

Whether channels are stored planar (each channel contiguous) rather than interleaved.

pub fn is_float(self) -> bool

Whether the underlying sample type is floating-point.

pub fn as_interleaved_f32<'a>( self, data: &'a [u8], channels: u32, ) -> Result<Cow<'a, [f32]>, AudioError>

Convert a raw PCM buffer in this format to interleaved f32 in [-1.0, 1.0].

Returns a Cow::Borrowed when the input is already interleaved f32 (and the byte buffer is aligned), avoiding an allocation. Otherwise returns a Cow::Owned holding the converted samples.

pub fn from_interleaved_f32( self, samples: &[f32], channels: u32, ) -> Result<Vec<u8>, AudioError>

Convert interleaved f32 PCM to this format’s raw byte representation. Returns owned bytes; integer formats clamp out-of-range samples rather than wrapping.

Trait Implementations

impl Clone for AudioFormat

fn clone(&self) -> AudioFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AudioFormat

impl Debug for AudioFormat

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

Formats the value using the given formatter.

impl Default for AudioFormat

fn default() -> AudioFormat

Returns the “default value” for a type.

impl Eq for AudioFormat

impl PartialEq for AudioFormat

fn eq(&self, other: &AudioFormat) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AudioFormat