SuperCollider CLASSES (extension)

FoaProximity
ExtensionExtension

First Order Ambisonic (FOA) proximity effect filter

Description

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

NOTE: FoaProximity 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:

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

helpfile source: /usr/local/share/SuperCollider/Extensions/SC3plugins/ATK/HelpSource/Classes/FoaProximity.schelp
link::Classes/FoaProximity::
sc version: 3.9dev