FoaBalance:
Filter:
atk-sc3/Classes (extension) | Libraries > Ambisonic Toolkit > UGens > FOA > Transformer | UGens > Multichannel > Ambisonics

FoaBalance
ExtensionExtension

First 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.

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

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

Examples

Transforming-FOA.