FoaDominateX:
Filter:
Classes (extension) | Libraries > Ambisonic Toolkit > UGens > FOA > Transformer | UGens > Multichannel > Ambisonics

FoaDominateX : Foa : MultiOutUGen : UGen : AbstractFunction : Object
ExtensionExtension

First Order Ambisonic (FOA) dominance transformer
Source: ATK.sc

Description

Apply dominance to a First Order Ambisonic signal (B-format) along the x-axis.

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

Class Methods

FoaDominateX.ar(in, gain: 0, mul: 1, add: 0)

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, 0] to +gain dB, while decreasing the gain at [pi, 0] to -gain. This simultaneously results in a distortion of the image towards [0, 0]. Negative values of gain invert this distortion, distorting towards [pi, 0] . The default, 0, results in no change.

 


Dominance imaging
NOTE: Corresponding matrix transformer: FoaXformerMatrix: *newDominateX

Inherited class methods

Instance Methods

Inherited instance methods

Examples

Transforming FOA.