atk-sc3/Classes (extension)
| Libraries > Ambisonic Toolkit > UGens > FOA > Transformer | UGens > Multichannel > Ambisonics
FoaDominateX
Extension
ExtensionFirst Order Ambisonic (FOA) dominance transformer
Description
Apply dominance to a First Order Ambisonic signal (B-format) along the x-axis.
Class Methods
.ar
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