CLASS:: FoaDominateZ summary:: First Order Ambisonic (FOA) dominance transformer categories:: Libraries>Ambisonic Toolkit>UGens>FOA>Transformer, UGens>Multichannel>Ambisonics related:: Classes/FoaDominateX, Classes/FoaDominateY, Classes/FoaDominate, Classes/FoaTransform, Classes/FoaXform DESCRIPTION:: Apply dominance to a First Order Ambisonic signal (B-format) along the z-axis. NOTE:: link::Classes/FoaDominateZ:: 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:: gain Dominance gain, in dB. argument:: mul Output will be multiplied by this value. argument:: add This value will be added to the output. discussion:: Positive values of strong::gain:: increase the gain at code:: [0, pi/2] :: to strong::+gain:: dB, while decreasing the gain at code:: [0, -pi/2] :: to strong::-gain::. This simultaneously results in a distortion of the image towards code:: [0, pi/2] ::. Negative values of gain invert this distortion, distorting towards code:: [0, -pi/2] :: . The default, 0, results in no change. note:: Corresponding matrix transformer: link::Classes/FoaXformerMatrix#*newDominateZ:: :: EXAMPLES:: link::Guides/Transforming-FOA::.