atk-sc3/Classes (extension)
| Libraries > Ambisonic Toolkit > UGens > FOA > Transformer | UGens > Multichannel > Ambisonics
FoaBalance
Extension
ExtensionFirst Order Ambisonic (FOA) balance transformer
Description
Soundfield balance. A synonym for FoaZoomY
Apply zoom to a First Order Ambisonic signal (B-format) along the y-axis.
Class Methods
.ar
Arguments:
| in |
The B-format signal, an array: [w, x, y, z] |
| angle |
The distortion angle, in radians. -pi/2 to pi/2 |
| mul |
Output will be multiplied by this value. |
| add |
This value will be added to the output. |
Discussion:
Zoom is a normailised dominance variant, specified in terms of a distortion angle. Positive values of angle increase gain at [0, pi/2], while reducing at [0, -pi/2]. Negative values do the inverse. The default, 0, results in no change.
Balance imaging
NOTE: Corresponding matrix transformer: FoaXformerMatrix: *newZoomY