rsc3/doc-schelp/HelpSource/Classes/BiPanB2.schelp

58 lines
1 KiB
Text

class:: BiPanB2
summary:: 2D Ambisonic B-format panner.
related:: Classes/DecodeB2, Classes/PanB, Classes/PanB2, Classes/Rotate2
categories:: UGens>Multichannel>Ambisonics
Description::
Encode a two channel signal to two dimensional ambisonic B-format. This
puts two channels at opposite poles of a 2D ambisonic field. This is one
way to map a stereo sound onto a soundfield. It is equivalent to:
code::
PanB2(inA, azimuth, gain) + PanB2(inB, azimuth + 1, gain)
::
classmethods::
method::ar, kr
argument::inA
Input signal A
argument::inB
Input signal B.
argument::azimuth
Position around the circle from -1 to +1.
-1 is behind, -0.5 is left, 0 is forward, +0.5 is right, +1 is behind.
argument::gain
Amplitude control.
Examples::
code::
(
{
var w, x, y, p, q, a, b, c, d;
p = LFSaw.ar(200);
q = LFSaw.ar(301);
// B-format encode
#w, x, y = BiPanB2.ar(p, q, 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;
)
::