atk-sc3/Classes (extension)
| Libraries > Ambisonic Toolkit > UGens > HOA > Transformer | UGens > Multichannel > Ambisonics
HoaDominate
Extension
ExtensionHigher Order Ambisonic (HOA) dominance transformer
Description
Apply dominance to a Higher Order Ambisonic signal (HOA) along an arbitrary axis & radius.
Class Methods
.ar
Arguments:
| in |
The input signal. |
| gain |
Dominance gain, in dB. |
| theta |
Azimuth, in radians. |
| phi |
Elevation, in radians. |
| radius |
Radius, in meters. |
| order |
Ambisonic order. |
Discussion:
Applies dominance along the axis defined by theta and phi at radius.
Positive values of gain increase the gain at [theta, phi] to +gain dB, while decreasing the gain at [theta.neg, phi.neg] to -gain. This simultaneously results in a distortion of the image towards [theta, phi]. Negative values of gain invert this distortion, distorting towards [theta.neg, phi.neg] . The default, 0, results in no change.
Imaging is illustrated here.
NOTE: Corresponding matrix transformer: HoaMatrixXformer: *newDominate
Examples
TBD