/  Decoders

DecodeN

MonoDecodeN

SADN

DBDN

Ambisonic decoders, all work from 1st to 5th order.

DecodeN

inherits : UGen : Object

Decoder based on a given matrix of spherical harmonic values.

examples

constructors

DecodeN()

Default constructor for DecodeN.

member functions

void sh(float[][] sh)

Set matrix of spherical harmonics to be used for decoding, column one is (N+1)^2 length containing ACN ordered spherical harmonics for speaker 1, column 2 is the same for speaker 2, etc.

float[][] sh()

Get current matrix of spherical harmonics.

void weights(float[] weights)

Set vector of weights to be used, the same vector is used for all speakers.

float[] weights()

Get the active weighting of the decoder matrix.


MonoDecodeN

inherits : UGen : Object

Retrieve current elevation angle.

constructors

MonoDecodeN()

Default constructor for MonoDecodeN.

member functions

float azi()

Retrieve current azimuth.

float elev()

No description available

void pos(float azimuth, float elevation)

Set the position of the MonoDecode via spherical coordinates.

float rms()

Get the RMS value of the last buffer pass.

void sh(float[] sh)

A simple sampling decoder used to find metrics of a soundfield. It's processing is similar to the inverse of encoding, where it will find sound present at a position on the sphere, rather than place it at that position.

float[] sh()

Get current vector of spherical harmonics.

void weights(float[] weights)

Set vector of weights to be used, the same vector is used for all speakers.

float[] weights()

Get the active weighting of the decoder vector.


SADN

inherits : UGen : Object

A sampling ambisonic decoder (SAD) for speaker decoding. This decoder works best if you are describing your speaker arrangement in terms of azimuth and elevation (elevation).

examples

constructors

SADN()

Default constructor for SADN.

SADN(float[][] SAD1)

Constructor for instantiating with an array of speaker angles.

member functions

void dim(int dimension)

Set the dimension of the decoder, expects 3 for three dimensional, and 2 for two dimensions. This is useful if you are not using a speaker array with height.

void placement(float[][] speakerAngles)

Function to set speaker angles for each output. Output channel 1 is assumed to be fed to speaker 1, thus the first pair of angles should be the azimuth and elevation of the first speaker.

float[][] sh()

Receive the matrix of spherical harmonics currently being used for decoding. If you have provided SAD with speaker angles, this will be the spherical harmonics calculated for those angles.

void weights(float[] weights)

Set the weighting of each spherical harmonic. This can often be thought of as a 'filter' for the harmonics, weighting certain entries more than other.

float[] weights()

Get the active weighting of the decoder matrix.


DBDN

inherits : UGen : Object

No description available

constructors

DBDN()

Default constructor for DBDN.

DBDN(float[][] DBDN)

Constructor for instantiating with an array of speaker angles.

member functions

void placement(float[][] speakerAngles)

Function to set speaker angles for each output. Output channel 1 is assumed to be fed to speaker 1, thus the first pair of angles should be the azimuth and elevation of the first speaker.

float[][] sh()

Receive the matrix of spherical harmonics currently being used for decoding. If you have provided SAD with speaker angles, this will be the spherical harmonics calculated for those angles.

void weights(float[] weights)

Set the weighting of each spherical harmonic. This can often be thought of as a 'filter' for the harmonics, weighting certain entries more than other.

float[] weights()

Get the active weighting of the decoder matrix.