SuperCollider CLASSES (extension)

FoaPsychoShelf
ExtensionExtension

First Order Ambisonic (FOA) psychoacoustic shelf filter

Description

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

NOTE: FoaPsychoShelf is usually called internally by FoaDecode.

Class Methods

*ar (in, freq: 400, k0, k1, mul: 1, add: 0)

Arguments:

in

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

freq

Shelf filter corner frequency, in Hz.

k0

High frequency scale for 0-order harmonic: W.

k1

High frequency scale for 1st-order harmonics: X, Y, Z.

mul

Output will be multiplied by this value.

add

This value will be added to the output.

Discussion:

FoaPsychoShelf is invoked by FoaDecode when a dual-band psychoacoustically optimised decoder1 is called by setting k to 'dual'. This kind of decoder is the optimum choice for small scale studio or domestic settings.

NOTE: In normal circumstances, the user will not call FoaPsychoShelf directly.

Inherited class methods

Instance Methods

Inherited instance methods

Examples

Please see this.

[1] - See: E. Benjamin, R. Lee, and A. Heller, "Is My Decoder Ambisonic?," in Proceedings of the 125th Audio Engineering Society Convention, San Francisco, 2008.
helpfile source: /usr/local/share/SuperCollider/Extensions/SC3plugins/ATK/HelpSource/Classes/FoaPsychoShelf.schelp
link::Classes/FoaPsychoShelf::
sc version: 3.9dev