SuperCollider CLASSES (extension)

FoaNFC
ExtensionExtension

First Order Ambisonic (FOA) nearfield compensation filter

Description

Apply nearfield compensation filtering to a first order ambisonic signal (B-format).

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

Class Methods

*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.

Nearfield 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 nearfield 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.