FoaSpeakerMatrix:
Filter:
atk-sc3/Classes (extension) | Libraries > Ambisonic Toolkit > Matrix & Kernel > Internals

FoaSpeakerMatrix
ExtensionExtension

First Order Ambisonic (FOA) diametric decoder speaker matrices

Description

Generates speaker matrices required by the Ambisonic Toolkit's first order diametric decoder, FoaDecoderMatrix: *newDiametric.1

NOTE: In normal circumstances, the user will not call FoaSpeakerMatrix directly.

Class Methods

.new

Arguments:

directions

An array of directions for half of the loudspeaker feeds for the desired decoder. Specify in radians.

Rank 1 arrays return pantophonic, while rank 2 arrays return periphonic. E.g.,

k

The k factor of the decoder. May be specified as a float: 0.5 to 1.0.

.newPositions

Arguments:

positions

An array of positions for half of the loudspeaker feeds for the desired decoder. Specify in cartesian coordinates.

k

The k factor of the decoder. May be specified as a float: 0.5 to 1.0.

Instance Methods

.dim

Answers the number of decoder dimensions: 2D or 3D.

.numChannels

Answers the number of loudspeaker feeds (output channels).

.positions

Answers the position of loudspeaker feeds, in cartesian coordinates.

.matrix

Answers the speaker matrix

.k

Answer k

[1] - FoaSpeakerMatrix is Heller's speaker matrix helper used to generate matricies for diamatric decoding. See: See: E. Benjamin, R. Lee, and A. Heller, "Is My Decoder Ambisonic?," in Proceedings of the 125th Audio Engineering Society Convention, San Francisco, 2008.