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.

setTargetAtTime

Summary

Start exponentially approaching the target value at the given time with a rate having the given time constant. Among other uses, this is useful for implementing the decay and release portions of an ADSR envelope. Please note that the parameter value does not immediately change to the target value at the given time, but instead gradually changes to the target value.

Method of apis/webaudio/AudioParamapis/webaudio/AudioParam

Syntax

var  = AudioParam.setTargetAtTime(target, startTime, timeConstant);

Parameters

target

Data-type
Number

The value the parameter will start changing to at the given time.

startTime

Data-type
Number

The time in the same time coordinate system as AudioContext.currentTime.

timeConstant

Data-type
Number

The time-constant value of first-order filter (exponential) approach to the target value. The larger this value is, the slower the transition will be.

Return Value

Returns an object of type

Examples

var gainNode = audioCtx.createGain();
gainNode.gain.setTargetAtTime(1.0, audioCtx.currentTime + 1, 0.5); //'gain' is the AudioParam

Related specifications

W3C Web Audio API
W3C Editor’s Draft