SuperCollider CLASSES (extension)

FoaDirectZ
ExtensionExtension

First Order Ambisonic (FOA) directivity transformer

Description

Adjust the soundfield directivity of a first order ambisonic signal (B-format) along the z-axis.

NOTE: FoaDirectZ is usually called via the convenience wrapper FoaTransform.

Class Methods

*ar (in, angle, mul: 1, add: 0)

From superclass: FoaDirectX

Arguments:

in

The B-format signal, an array: [w, x, y, z]

angle

The distortion angle, in radians. 0 to pi/2

mul

Output will be multiplied by this value.

add

This value will be added to the output.

Discussion:

Angle = 0 retains the current directivity of the soundfield. Increasing angle towards pi/2 decreases the directivity along the z-axis, reducing the gain on this axis to zero, and is equivalent to a spatial low-pass filter. The resulting image becomes directionless on the z-axis.

NOTE: Corresponding matrix transformer: FoaXformerMatrix: *newDirectZ

Inherited class methods

Instance Methods

Inherited instance methods

Examples

Please see various examples here.

helpfile source: /usr/local/share/SuperCollider/Extensions/SC3plugins/ATK/HelpSource/Classes/FoaDirectZ.schelp
link::Classes/FoaDirectZ::
sc version: 3.9dev