Struct AudioChannelMap 

pub struct AudioChannelMap { /* private fields */ }

Maps individual input channels to output channels and applies per-channel gain.

Implementations

impl AudioChannelMap

pub fn identity(layout: AudioLayout) -> Self

Create an identity map (each input channel routes to the same output channel).

pub fn stereo_to_mono() -> Self

Create a downmix map from stereo to mono (equal-power mix of L+R).

pub fn compute_gain_db(&self, output_channel: usize) -> Option<f64>

Compute the gain in dB for a given output channel index.

Returns None if the output channel index is out of range.

pub fn validate_params(&self) -> Result<(), String>

Validate that the map is consistent with the declared layouts.

For downmix maps (e.g. stereo→mono), the number of routes equals the number of input channels being mixed, which may exceed the output channel count. We therefore only require that the route count is at least the output channel count.

pub fn output_channel_count(&self) -> usize

Number of output channels.

pub fn apply(&self, input: &[f32], output: &mut [f32], frame_size: usize)

Apply the channel map to an input sample buffer.

input is interleaved samples (f32), output must be pre-allocated with frame_size * output_channels entries.

Trait Implementations

impl Clone for AudioChannelMap

fn clone(&self) -> AudioChannelMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AudioChannelMap

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AudioChannelMap

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AudioChannelMap

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

where __S: Serializer,

Serialize this value into the given Serde serializer.