FoaFocusX:
Filter:
Classes (extension) | Libraries > Ambisonic Toolkit > UGens > FOA > Transformer | UGens > Multichannel > Ambisonics

FoaFocusX : FoaRotate : Foa : MultiOutUGen : UGen : AbstractFunction : Object
ExtensionExtension

First Order Ambisonic (FOA) focus transformer
Source: ATK.sc

Description

Apply focus to a First Order Ambisonic signal (B-format) along the x-axis.

NOTE: FoaFocusX is usually called via the convenience wrapper FoaTransform.

Class Methods

FoaFocusX.ar(in, angle: 0, mul: 1, add: 0)

From superclass: FoaRotate

Arguments:

in

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

angle

The distortion angle, in radians. -pi/2 to pi/2

mul

Output will be multiplied by this value.

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 angle maintain gain at [0, 0], while reducing at [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.

 


Focus imaging
NOTE: Corresponding matrix transformer: FoaXformerMatrix: *newFocusX

Inherited class methods

Instance Methods

Inherited instance methods

Examples

Transforming FOA.