PannerNode.PannerNode()

The PannerNode() constructor of the Web Audio API creates a new PannerNode object instance.

Syntax

var myPanner = new PannerNode(context, options);

Parameters

Inherits parameters from the AudioNodeOptions dictionary.

context

A BaseAudioContext representing the audio context you want the node to be associated with.

options Optional

A PannerOptions dictionary object defining the properties you want the PannerNode to have (It also inherits the options defined in the AudioNodeOptions dictionary.):

• panningModel: The PannerNode.panningModel you want the PannerNode to have (the default is equalpower.)
• distanceModel: The PannerNode.distanceModel you want the PannerNode to have (the default is inverse.)
• positionX: The PannerNode.positionX you want the PannerNode to have (the default is 0.)
• positionY: The PannerNode.positionY you want the PannerNode to have (the default is 0.)
• positionZ: The PannerNode.positionZ you want the PannerNode to have (the default is 0.)
• orientationX: The PannerNode.orientationX you want the PannerNode to have (the default is 1.)
• orientationY: The PannerNode.orientationY you want the PannerNode to have (the default is 0.)
• orientationZ: The PannerNode.orientationZ you want the PannerNode to have (the default is 0.)
• refDistance: The PannerNode.refDistance you want the PannerNode to have. The default is 1, and negative values are not allowed.
• maxDistance: The PannerNode.maxDistance you want the PannerNode to have. The default is 10000, and non-positive values are not allowed.
• rollOffFactor: The PannerNode.rollOffFactor you want the PannerNode to have. The default is 1, and negative values are not allowed.
• coneInnerAngle: The PannerNode.coneInnerAngle you want the PannerNode to have (the default is 360.)
• coneOuterAngle: The PannerNode.coneOuterAngle you want the PannerNode to have (the default is 360.)
• coneOuterGain: The PannerNode.coneOuterGain you want the PannerNode to have. The default is 0, and its value can be in the range 0–1.

Return value

A new PannerNode object instance.

Exceptions

RangeError

The refDistance, maxDistance, or rolloffFactor properties have been given a value that is outside the accepted range.

InvalidStateError

The coneOuterGain property has been given a value outside the accepted range (0–1).

Example

var ctx = new AudioContext();

var options = {
  positionX : 1,
  maxDistance: 5000
}

var myPanner = new PannerNode(ctx, options);

Specifications

Browser compatibility