HoaRotate | SuperCollider 3.13.0 Help

Description

Rotate a Higher Order Ambisonic signal (HOA) around the z-axis.

Class Methods

.ar

Arguments:

in	The input signal.
angle	Rotation angle, in radians.
order	Ambisonic order.

Discussion:

A rotation of pi/2 will rotate a source at [0, 0] to [pi/2, 0].

Examples

Rotate around the z-axis

// Inspect the ATK's speed of sound reference
"Speed of sound: % m/s".format(AtkHoa.speedOfSound);

// Inspect the ATK's reference radius
"Reference radius: % m".format(AtkHoa.refRadius);

// Inspect the ATK's channel/coefficient ordering
"Coefficient ordering: %".format(AtkHoa.ordering);

// Inspect the ATK's channel/coefficient ordering
"Coefficient normalisation: %".format(AtkHoa.normalisation);

// simple test...

// boot rt server
s.boot;

// choose Ambisonic order
~order = 1
~order = 2
~order = 3

// choose an outbus, if need be
~outbus = 0

// open scope
s.scope(~order.asHoaOrder.size, ~outbus);

// audition
(
{
    // saw params
    var freq = 110.0;
    var gain = -12;

// azimuth & elevation
    var theta = 0.0;
    var phi = 0.0;
    var rotateRate = 0.25;

// radius
    // var radius = 1.0;  // inside reference radius
    var radius = 1.5;  // at reference radius
    // var radius = 2.0;  // beyond reference radius

// signals
    var sig;
    var sigHoa;
    var sigHoaRot;

sig = Saw.ar(freq, gain.dbamp);

// encode
    sigHoa = HoaEncodeDirection.ar(sig, theta, phi, radius, ~order);

// rotate
    sigHoaRot = HoaRotate.ar(
        sigHoa,
        LFSaw.kr(rotateRate, mul: pi),
        ~order
    );

// out
    sigHoaRot
}.play(outbus: ~outbus)
)

// quit rt server
s.quit

helpfile source: HelpSource/Classes/HoaRotate.schelp
link::atk-sc3/Classes/HoaRotate::

HoaRotateExtension