Skip to main content

hoadecode

hoadecode(
@azimuth 0.78 2.35
@elevation 0 0
@binaural 1
@dimension '3D'
@blocksamps 64
@angleunit 0
) -> llll

Generates an audio process operation for decoding higher-order ambisonic buffers for a set of loudspeakers or for binaural listening. Note that the number of output (i.e., decoded) channels must be greater than the number of encoded channels.


Arguments

  • @azimuth [int/float/llll]: Azimuth or X coordinate, for each loudspeaker. (default: 0.78 2.35).
  • @elevation [int/float/llll]: Elevation or y coordinate. (default: 0 0).
  • @binaural [int/float/llll]: Binaural mode. (default: 1).
    • 0: Off
    • 1: On
  • @dimension [symbol]: Dimensionality of ambisonics (default: '3D').
    • '2D': 2-dimensional.
    • '3D': 3-dimensional.
  • @blocksamps [int]: Decoding block size in samples. (default: 64).
  • @angleunit [int]: Unit for angles. (default: 0).
    • 0: Radians
    • 1: Degrees
    • 2: Turns

Output

Higher-order ambisonics decoding operation [llll]


Usage

hoadecode is meant to be used with the process function:

$buffer = importaudio('singing.wav'); ## input buffer
$op = hoadecode(); ## processing operation
$buffer = $buffer.process($op); ## apply processing
$buffer.view('after hoadecode process')