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

FoaProximity : Foa : MultiOutUGen : UGen : AbstractFunction : Object
ExtensionExtension

First Order Ambisonic (FOA) proximity effect filter
Source: ATK.sc

Description

Apply proximity filtering to a First Order Ambisonic signal (B-format).

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

Class Methods

FoaProximity.ar(in, distance: 1, mul: 1, add: 0)

Arguments:

in

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

distance

The distance, in meters.

WARNING: Distance = 0 is an invalid value!
mul

Output will be multiplied by this value.

add

This value will be added to the output.

Discussion:

FoaProximity facilitates the introduction of the proximity effect to encoded signals. At extremes, the proximity effect introduces a strong bass boost, as well as phase differences. The proximity effect can be an important contributor to perceptions of nearness.

The Ambisonic Toolkit's near-field compensation filter, FoaNFC, undoes FoaProximity given the same distance argument.

WARNING: As FoaProximity includes a 1st-order integration, signals must be highpass filtered before application. HPF is usually a suitable choice to control low frequency boost.

Inherited class methods

Instance Methods

Inherited instance methods

Examples

Please see this.