SuperCollider CLASSES (extension)

Libraries>Ambisonic Toolkit>FOA>Transforming>UGens, UGens>Multichannel>Ambisonics, UGens>Multichannel>Panners

Extension

First Order Ambisonic (FOA) directivity transformer

Inherits from: Object

Adjust the soundfield directivity of a first order ambisonic signal (B-format) across an arbitrary plane.

in |
The B-format signal, an array: [w, x, y, z] |

angle |
The distortion angle, in radians. 0 to pi/2 |

theta |
Azimuth for the normal to the plane, in radians. |

phi |
Elevation for the normal to the plane, in radians. |

mul |
Output will be multiplied by this value. |

add |
This value will be added to the output. |

**Angle** = 0 retains the current directivity of the soundfield. Increasing **angle** towards pi/2 decreases the directivity along the normal defined by **theta** and **phi**, reducing the gain on this normal to zero, and is equivalent to a spatial low-pass filter. The resulting image becomes directionless on the normal.

NOTE: Corresponding matrix transformer: FoaXformerMatrix: *newDirect

Please see various examples here.

helpfile source: /usr/local/share/SuperCollider/Extensions/SC3plugins/ATK/HelpSource/Classes/FoaDirect.schelp

link::Classes/FoaDirect::

sc version: 3.9dev

link::Classes/FoaDirect::

sc version: 3.9dev