Struct AmbisonicDecoderBlock

pub struct AmbisonicDecoderBlock<S>
where
    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> AmbisonicDecoderBlock<S>

where S: Sample,

pub fn new( order: usize, output_layout: ChannelLayout, ) -> AmbisonicDecoderBlock<S>

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

where S: Sample,

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

Converts to this type from the input type.