FX Class: Three Band EQ

Interactive example

Overview

Classic three-band equalizer with unique characteristics and total kills. EQ or equalization affects the volume in dB of a specific frequency or a range of frequencies.

The low, mid, and high properties have their respective frequency range, that is dynamically changing depending on their setting to provide the most natural frequency response for mixing.

The effect doesn’t allocate any internal buffers and needs just a few bytes of memory.

Implementation example

The three band is is an FX class, it expects both an input and output buffer. The process() function should be called on every loop of the audio processing block.

class SuperpoweredThreeBandEqProcessor extends SuperpoweredWebAudio.AudioWorkletProcessor {

        // Called when the AudioWorklet is ready to start processing audio
        onReady() {
            this.eq = new this.Superpowered.ThreeBandEQ(
                44100 // The initial sample rate in Hz. -
            );
            this.eq.enabled = true;
        }

        // Runs before the node is destroyed.
        // Clean up memory and objects here (such as free allocated linear memory or destruct Superpowered objects).
        onDestruct() {
            this.eq.destruct();
        }

        // The shape of the message we pass from our main thread is up to you
        onMessageFromMainScope(message) {
            // Here is an example of how to apply changes to the Three Band EQ instance
            if (typeof message.low !== 'undefined') this.eq.dry = message.dry;
            if (typeof message.mid !== 'undefined') this.eq.wet = message.wet;
            if (typeof message.high !== 'undefined') this.eq.mix = message.mix;
        }

        // This is the process loop which is passed pointers to buffers
        // from the WebAudio API (inputBuffer and outputBuffer), with the buffersize (128 samples when running as a native AudioWorklet)
        processAudio(inputBuffer, outputBuffer, buffersize) {
            // Ensure the samplerate is in sync on every audio processing callback
            this.eq.samplerate = this.samplerate;

            // Render the output buffers
            if (!this.eq.process(inputBuffer.pointer, outputBuffer.pointer, buffersize)) {
                for (let n = 0; n < buffersize * 2 ; n++) outputBuffer.array[n] = inputBuffer.array[n];
            }
        }
    }

#include "SuperpoweredThreeBandEq.h"

void initEQEffect() {
    const unsigned int sampleRate = 44100;
    eq = new Superpowered::ThreeBandEQ(sampleRate);
    eq->enabled = true;
}

void configureEQ() {
    eq->low = 0;
    eq->mid = 0.587;
    eq->high = 0.4;
}

void processAudio(float *interleavedInput, float *interleavedOutput, unsigned int numberOfFrames, unsigned int samplerate) {
    // Ensure the samplerate is in sync on every audio processing callback
    eq->samplerate = samplerate;

    // Render the output buffers
    bool outputChanged = eq->process(interleavedInput, interleavedOutput, numberOfFrames);
    ...
}

Properties

Number

float

Number

float

Number

float

Boolean

bool

Number

unsigned int

Methods

• constructor

  METHOD

  Creates a ThreeBandEQ instance.

  Parameters

  Name	Type	Description
  samplerate	Number	The initial sample rate in Hz.

  Returns

  Type	Description
  Superpowered.ThreeBandEQ	The constructed instance.

• constructor

  METHOD

  Creates a ThreeBandEQ instance.

  Parameters

  Name	Type	Default	Description
  samplerate	unsigned int		The initial sample rate in Hz.

  Returns

  Type	Description
  Superpowered::ThreeBandEQ	The constructed instance.

• destruct

  METHOD

  Destructor to free Linear Memory.

  Parameters

  None

  Returns

  None

• process

  METHOD

  Processes/renders the audio. Always call it in the audio processing callback, regardless if the effect is enabled or not for smooth, audio-artifact free operation. It's never blocking for real-time usage.

  Parameters

  Name	Type	Description
  input	Number (pointer in Linear Memory)	32-bit interleaved stereo input.
  output	Number (pointer in Linear Memory)	32-bit interleaved stereo output.
  numberOfFrames	Number	Number of frames to process. Recommendations for best performance: multiply of 4, minimum 64.

  Returns

  Type	Description
  Boolean	If process() returns with true, the contents of output are replaced with the audio output. If process() returns with false, it indicates silence. The contents of output are not changed in this case (not overwritten with zeros).

• process

  METHOD

  Processes/renders the audio. Always call it in the audio processing callback, regardless if the effect is enabled or not for smooth, audio-artifact free operation. It's never blocking for real-time usage. You can change all effect properties on any thread, concurrently with process().

  Parameters

  Name	Type	Default	Description
  input	float *		32-bit interleaved stereo input.
  output	float *		32-bit interleaved stereo output.
  numberOfFrames	unsigned int		Number of frames to process. Recommendations for best performance: multiply of 4, minimum 64.

  Returns

  Type	Description
  bool	If process() returns with true, the contents of output are replaced with the audio output. If process() returns with false, it indicates silence. The contents of output are not changed in this case (not overwritten with zeros).