Struct MixerBlock

pub struct MixerBlock<S: Sample> { /* private fields */ }

A channel-wise audio mixer that sums multiple sources per output channel.

Unlike MatrixMixerBlock which requires explicit gain setup, MixerBlock automatically groups inputs by channel and sums them. This is useful for combining multiple audio sources into a single stereo (or N-channel) output.

Input Organization

Inputs are organized in groups, where each group represents one source’s contribution to all output channels. For stereo output with 3 sources:

• Inputs 0, 1: Source A (L, R)
• Inputs 2, 3: Source B (L, R)
• Inputs 4, 5: Source C (L, R)

The mixer sums: Output L = A.L + B.L + C.L, Output R = A.R + B.R + C.R

Implementations

impl<S: Sample> MixerBlock<S>

pub fn new(num_sources: usize, num_channels: usize) -> Self

Create a new mixer for the given number of sources and output channels.

Arguments

• num_sources - Number of sources to mix (each provides all channels)
• num_channels - Number of output channels (e.g., 2 for stereo)

Panics

Panics if the total input count exceeds MAX_BLOCK_INPUTS (16).

pub fn stereo(num_sources: usize) -> Self

Create a stereo mixer for the given number of sources.

pub fn with_normalization(self, normalization: NormalizationStrategy) -> Self

Set the normalization strategy.

pub fn num_sources(&self) -> usize

Returns the number of sources being mixed.

pub fn num_channels(&self) -> usize

Returns the number of output channels.

Trait Implementations

impl<S: Sample> Block<S> for MixerBlock<S>

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: Sample> From<MixerBlock<S>> for BlockType<S>

fn from(block: MixerBlock<S>) -> Self

Converts to this type from the input type.