CLASS:: FoaBalance summary:: First Order Ambisonic (FOA) balance transformer categories:: Libraries>Ambisonic Toolkit>UGens>FOA>Transformer, UGens>Multichannel>Ambisonics related:: Classes/FoaZoomX, Classes/FoaZoomY, Classes/FoaZoomZ, Classes/FoaZoom, Classes/FoaTransform, Classes/FoaXform DESCRIPTION:: Soundfield balance. A synonym for link::Classes/FoaZoomY:: Apply zoom to a First Order Ambisonic signal (B-format) along the y-axis. NOTE:: link::Classes/FoaZoomY:: is usually called via the convenience wrapper link::Classes/FoaTransform::. :: CLASSMETHODS:: METHOD:: ar argument:: in The B-format signal, an array: [w, x, y, z] argument:: angle The distortion angle, in radians. -pi/2 to pi/2 argument:: mul Output will be multiplied by this value. argument:: 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 strong::angle:: increase gain at code:: [0, pi/2] ::, while reducing at code:: [0, -pi/2] ::. Negative values do the inverse. The default, 0, results in no change. anchor::figure:: image::balance_fig.png#Balance imaging:: note:: Corresponding matrix transformer: link::Classes/FoaXformerMatrix#*newZoomY:: :: EXAMPLES:: link::Guides/Transforming-FOA::.