Struct AmbisonicDecoderBlock

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

Decodes ambisonics B-format to a speaker layout.

Converts SN3D normalized, ACN ordered ambisonic signals to discrete speaker feeds using a mode-matching decoder.

Supported Configurations

• Input: 1st order (4 ch), 2nd order (9 ch), or 3rd order (16 ch)
• Output: Stereo, 5.1, 7.1, or custom layouts

Example

Decode first-order ambisonics to stereo using virtual speakers at ±30 degrees azimuth.

Implementations

impl<S: Sample> AmbisonicDecoderBlock<S>

pub fn new(order: usize, output_layout: ChannelLayout) -> Self

Create a new ambisonic decoder.

Arguments

• order - Ambisonic order (1, 2, or 3)
• output_layout - Target speaker layout

Panics

Panics if order is not 1, 2, or 3.

pub fn order(&self) -> usize

Returns the ambisonic order.

pub fn output_layout(&self) -> ChannelLayout

Returns the output layout.

Trait Implementations

impl<S: Sample> Block<S> for AmbisonicDecoderBlock<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<AmbisonicDecoderBlock<S>> for BlockType<S>

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

Converts to this type from the input type.