ConvolverNode

{{APIRef("Web Audio API")}}

The ConvolverNode interface is an {{domxref("AudioNode")}} that performs a Linear Convolution on a given {{domxref("AudioBuffer")}}, often used to achieve a reverb effect. A ConvolverNode always has exactly one input and one output.

[!NOTE] For more information on the theory behind Linear Convolution, see the Convolution article on Wikipedia.

{{InheritanceDiagram}}

Constructor

• {{domxref("ConvolverNode.ConvolverNode()", "ConvolverNode()")}}
  • : Creates a new ConvolverNode object instance.

Instance properties

Inherits properties from its parent, {{domxref("AudioNode")}}.

• {{domxref("ConvolverNode.buffer")}}
  • : A mono, stereo, or 4-channel {{domxref("AudioBuffer")}} containing the (possibly multichannel) impulse response used by the ConvolverNode to create the reverb effect.
• {{domxref("ConvolverNode.normalize")}}
  • : A boolean that controls whether the impulse response from the buffer will be scaled by an equal-power normalization when the buffer attribute is set, or not.

Instance methods

No specific method; inherits methods from its parent, {{domxref("AudioNode")}}.

Examples

The following example shows basic usage of an AudioContext to create a convolver node. You will need to find an impulse response to complete the example below. See our HolySpaceCow example for a complete, applied example.

let audioCtx = new window.AudioContext();

async function createReverb() {
  let convolver = audioCtx.createConvolver();

  // load impulse response from file
  let response = await fetch("path/to/impulse-response.wav");
  let arraybuffer = await response.arrayBuffer();
  convolver.buffer = await audioCtx.decodeAudioData(arraybuffer);

  return convolver;
}

// …

let reverb = await createReverb();

// someOtherAudioNode -> reverb -> destination
someOtherAudioNode.connect(reverb);
reverb.connect(audioCtx.destination);

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Using the Web Audio API