3-band Equalizer
3-band Equalizer operator properties for Script Engine. Shapes audio with three fully parametric bands — each with its own centre frequency, gain, and Q (bandwidth) — plus an overall input-gain control. Unlike the fixed-frequency 10-band Equalizer, every band here can be tuned to any frequency between 20 Hz and 20 kHz, with an adjustable bandwidth, making it a flexible tool for surgical corrections (notching out resonance, taming sibilance) as well as broad tonal shaping. Includes a clip indicator that flags signal overload and a one-click reset.
| Property | Type | Access | Description |
|---|---|---|---|
InputGain |
float |
get/set |
Master input level applied before the band processing, in decibels. [min=-36, max=36, default=0]. 0 leaves the level unchanged. Negative values reduce the input level; positive values boost it (watch out for SignalOverLoad). |
Eq1Frequency |
int |
get/set |
Centre frequency of band 1, in Hz. [min=20, max=20000, default=500]. The frequency this band boosts or cuts. Pick a low value to target bass, mid for body and presence, high for sibilance and air. |
Eq1Gain |
int |
get/set |
Gain applied at band 1's centre frequency, in decibels. [min=-36, max=36, default=0]. 0 leaves the band unchanged; positive values boost it, negative values cut it. |
Eq1Q |
float |
get/set |
Bandwidth (Q) of band 1. [min=0.1, max=10, default=1]. Controls how wide the band is around its centre frequency. Low values give a broad, musical curve; high values give a narrow, surgical notch — useful for cutting a specific resonance or piece of unwanted noise without affecting nearby frequencies. |
Eq2Frequency |
int |
get/set |
Centre frequency of band 2, in Hz. [min=20, max=20000, default=3000]. |
Eq2Gain |
int |
get/set |
Gain applied at band 2's centre frequency, in decibels. [min=-36, max=36, default=0]. |
Eq2Q |
float |
get/set |
Bandwidth (Q) of band 2. [min=0.1, max=10, default=1]. |
Eq3Frequency |
int |
get/set |
Centre frequency of band 3, in Hz. [min=20, max=20000, default=8000]. |
Eq3Gain |
int |
get/set |
Gain applied at band 3's centre frequency, in decibels. [min=-36, max=36, default=0]. |
Eq3Q |
float |
get/set |
Bandwidth (Q) of band 3. [min=0.1, max=10, default=1]. |
SignalOverLoad |
bool |
get |
True when the equalizer's output signal has clipped (read-only). Lights up when the combined boost from input gain and band gains pushes the signal above full scale. Auto-resets after 2 seconds. Reduce InputGain or trim the boosted bands if this trips. |
PeakValueDbString |
string |
get |
Highest level reached during the most recent overload, in decibels (read-only). Updated whenever SignalOverLoad trips, and auto-resets after 2 seconds. |
ResetCommand |
Command |
get |
Reset all settings to their defaults. Restores InputGain to 0, and each band's frequency, gain, and Q to its starting value (500 Hz / 3 kHz / 8 kHz at 0 dB and Q=1). |
SamplesRendered |
int |
get/set |
Total number of audio samples processed by the equalizer (read-only, debug). |
Inherits from: AbstractAudioOperator, AbstractOperator, AbstractAudioMetering.
See also: 3-band Equalizer in Operators — user-facing introduction, screenshots, and section summaries.