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

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

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.

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.