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

FoaNFC
ExtensionExtension

First Order Ambisonic (FOA) near-field compensation filter

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

.ar

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.

Examples

Please see this and this.

[1] - Usually called distance compensation in the classic Ambisonics literature.
helpfile source: HelpSource/Classes/FoaNFC.schelp
link::atk-sc3/Classes/FoaNFC::