69 lines
1.2 KiB
Text
69 lines
1.2 KiB
Text
class:: DecodeB2
|
|
summary:: 2D Ambisonic B-format decoder.
|
|
related:: Classes/BiPanB2, Classes/PanB, Classes/PanB2, Classes/Rotate2
|
|
categories:: UGens>Multichannel>Ambisonics
|
|
|
|
|
|
Description::
|
|
|
|
Decode a two dimensional ambisonic B-format signal to a set of speakers
|
|
in a regular polygon. The outputs will be in clockwise order. The
|
|
position of the first speaker is either center or left of center.
|
|
|
|
|
|
classmethods::
|
|
|
|
method::ar, kr
|
|
|
|
argument::numChans
|
|
|
|
Number of output speakers. Typically 4 to 8.
|
|
|
|
|
|
argument::w
|
|
|
|
The B-format signal.
|
|
|
|
|
|
argument::x
|
|
|
|
The B-format signal.
|
|
|
|
|
|
argument::y
|
|
|
|
The B-format signal.
|
|
|
|
|
|
argument::orientation
|
|
|
|
Should be zero if the front is a vertex of the polygon. The first
|
|
speaker will be directly in front. Should be 0.5 if the front
|
|
bisects a side of the polygon. Then the first speaker will be the
|
|
one left of center.
|
|
|
|
returns::
|
|
An array of channels, one for each speaker.
|
|
|
|
Examples::
|
|
|
|
code::
|
|
|
|
(
|
|
{
|
|
var w, x, y, p, a, b, c, d;
|
|
|
|
p = PinkNoise.ar; // source
|
|
|
|
// B-format encode
|
|
#w, x, y = PanB2.ar(p, MouseX.kr(-1,1), 0.1);
|
|
|
|
// B-format decode to quad
|
|
#a, b, c, d = DecodeB2.ar(4, w, x, y);
|
|
|
|
[a, b, d, c] // reorder to my speaker arrangement: Lf Rf Lr Rr
|
|
}.play;
|
|
)
|
|
|
|
::
|
|
|