SuperCollider CLASSES (extension)

FoaDominateZ
ExtensionExtension

First Order Ambisonic (FOA) dominance transformer

Description

Apply dominance to a first order ambisonic signal (B-format) along the z-axis.

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

Class Methods

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

From superclass: FoaDominateX

Arguments:

in

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

gain

Dominance gain, in dB.

mul

Output will be multiplied by this value.

add

This value will be added to the output.

Discussion:

Positive values of gain increase the gain at [0, pi/2] to +gain dB, while decreasing the gain at [0, -pi/2] to -gain. This simultaneously results in a distortion of the image towards [0, pi/2]. Negative values of gain invert this distortion, distorting towards [0, -pi/2] . The default, 0, results in no change.

NOTE: Corresponding matrix transformer: FoaXformerMatrix: *newDominateZ

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/FoaDominateZ.schelp
link::Classes/FoaDominateZ::
sc version: 3.9dev