Struct MatrixMixerBlock

pub struct MatrixMixerBlock<S>
where
    S: Sample,
{ /* private fields */ }

An NxM mixing matrix for flexible channel routing.

Each output is a weighted sum of all inputs, allowing arbitrary channel mixing configurations. The gain matrix determines how much of each input contributes to each output.

Example

A 4x2 matrix mixer can down-mix 4 channels to stereo by setting appropriate gains for left/right output combinations.

Implementations

impl<S> MatrixMixerBlock<S>

where S: Sample,

pub fn new(inputs: usize, outputs: usize) -> MatrixMixerBlock<S>

Create a new matrix mixer with the given input and output counts.

All gains are initialized to zero.

Panics

Panics if inputs or outputs is 0 or greater than 16.

pub fn identity(channels: usize) -> MatrixMixerBlock<S>

Create a matrix mixer initialized as an identity matrix (passthrough).

Each input channel maps directly to the corresponding output channel with unity gain. Requires inputs == outputs.

Panics

Panics if channels is 0 or greater than 16.

pub fn set_gain(&mut self, input: usize, output: usize, gain: S)

Set the gain for a specific input-to-output routing.

Arguments

• input - The input channel index (0-based)
• output - The output channel index (0-based)
• gain - The gain to apply (typically 0.0 to 1.0)

Panics

Panics if input >= num_inputs or output >= num_outputs.

pub fn get_gain(&self, input: usize, output: usize) -> S

Get the gain for a specific input-to-output routing.

Panics

Panics if input >= num_inputs or output >= num_outputs.

pub fn num_inputs(&self) -> usize

Returns the number of input channels.

pub fn num_outputs(&self) -> usize

Returns the number of output channels.

Trait Implementations

impl<S> Block<S> for MatrixMixerBlock<S>

where S: Sample,

fn process( &mut self, inputs: &[&[S]], outputs: &mut [&mut [S]], _modulation_values: &[S], _context: &DspContext, )

Process audio through this block.

fn input_count(&self) -> usize

Returns the number of input ports this block accepts.

fn output_count(&self) -> usize

Returns the number of output ports this block produces.

fn modulation_outputs(&self) -> &[ModulationOutput]

Returns the modulation outputs this block provides.

fn channel_config(&self) -> ChannelConfig

Returns how this block handles multi-channel audio.

fn set_smoothing(&mut self, _sample_rate: f64, _ramp_time_ms: f64)

Configure smoothing time for parameter changes.

impl<S> From<MatrixMixerBlock<S>> for BlockType<S>

where S: Sample,

fn from(block: MatrixMixerBlock<S>) -> BlockType<S>

Converts to this type from the input type.