AudioBuffer: copyToChannel() method

The copyToChannel() method of the AudioBuffer interface copies the samples to the specified channel of the AudioBuffer, from the source array.

Syntax

copyToChannel(source, channelNumber)
copyToChannel(source, channelNumber, startInChannel)

Parameters

• source
  • : A Float32Array that the channel data will be copied from.
• channelNumber
  • : The channel number of the current AudioBuffer to copy the channel data to. If channelNumber is greater than or equal to numberOfChannels, an INDEX_SIZE_ERR will be thrown.
• startInChannel Optional
  • : An optional offset to copy the data to. If startInChannel is greater than length, an INDEX_SIZE_ERR will be thrown.

Return value

None (undefined).

Examples

const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
const anotherArray = new Float32Array();
// Copy channel data from second channel of myArrayBuffer.
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
// Copy data from anotherArray to first channel of myArrayBuffer. Both channels have the same data now.
myArrayBuffer.copyToChannel(anotherArray, 0, 0);

Specifications

Browser compatibility

See also

• Using the Web Audio API