This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

normalize

Summary

Controls whether the impulse response from the buffer will be scaled by an equal-power normalization when the buffer atttribute is set. Its default value is true in order to achieve a more uniform output level from the convolver when loaded with diverse impulse responses. If normalize is set to false, then the convolution will be rendered with no pre-processing/scaling of the impulse response. Changes to this value do not take effect until the next time the buffer attribute is set. If the normalize attribute is false when the buffer attribute is set then the ConvolverNode will perform a linear convolution given the exact impulse response contained within the buffer.

Property of apis/webaudio/ConvolverNodeapis/webaudio/ConvolverNode

Syntax

var result = ConvolverNode.normalize;
ConvolverNode.normalize = value;

Return Value

Returns an object of type BooleanBoolean

Examples

var audioCtx = new AudioContext();
var convolver = audioCtx.createConvolver();
convolver.normalize = false;

Related specifications

W3C Web Audio API
W3C Editor’s Draft