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

FoaNFC : Foa : MultiOutUGen : UGen : AbstractFunction : Object
ExtensionExtension

First Order Ambisonic (FOA) near-field compensation filter
Source: ATK.sc

Description

Apply near-field compensation filtering to a First Order Ambisonic signal (B-format).

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

Class Methods

FoaNFC.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:

FoaNFC facilitates the reduction or removal of the proximity effect from encoded signals. The proximity effect can be an important contributor to perceptions of nearness.

Near-field compensation1 is usually used in conjunction with FoaDecode to compensate for the distance of loudspeakers on playback. Additionally, FoaNFC can also be used to reduce the proximity effect found in near-field recordings.

The Ambisonic Toolkit's proximity filter, FoaProximity, undoes FoaNFC given the same distance argument.

Inherited class methods

Instance Methods

Inherited instance methods

Examples

Please see this and this.

[1] - Usually called distance compensation in the classic Ambisonics literature.