CLASS:: FoaFocusX summary:: First Order Ambisonic (FOA) focus transformer categories:: Libraries>Ambisonic Toolkit>UGens>FOA>Transformer, UGens>Multichannel>Ambisonics related:: Classes/FoaFocusY, Classes/FoaFocusZ, Classes/FoaFocus, Classes/FoaTransform, Classes/FoaXform DESCRIPTION:: Apply focus to a First Order Ambisonic signal (B-format) along the x-axis. NOTE:: link::Classes/FoaFocusX:: 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:: Focus is a normalised dominance variant, specified in terms of a distortion angle. Positive values of strong::angle:: maintain gain at code:: [0, 0] ::, while reducing at code:: [pi, 0] ::. Negative values do the inverse. The default, 0, results in no change. In contrast with zoom, gain is maintained at 0dB in the direction of distortion. anchor::figure:: image::focus_fig.png#Focus imaging:: note:: Corresponding matrix transformer: link::Classes/FoaXformerMatrix#*newFocusX:: :: EXAMPLES:: link::Guides/Transforming-FOA::.