The copyToChannel() method of the AudioBuffer interface copies the samples to the specified channel of the AudioBuffer, from the source array.
AudioBuffer: copyToChannel() method
Syntax
js
copyToChannel(source, channelNumber)
copyToChannel(source, channelNumber, startInChannel)
Parameters
-
source -
A
Float32Arraythat the channel data will be copied from. -
channelNumber -
The channel number of the current
AudioBufferto copy the channel data to. If channelNumber is greater than or equal toAudioBuffer.numberOfChannels, anINDEX_SIZE_ERRwill be thrown. startInChannelOptional-
An optional offset to copy the data to. If startInChannel is greater than
AudioBuffer.length, anINDEX_SIZE_ERRwill be thrown.
Return value
None (undefined).
Examples
js
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
| Specification |
|---|
| Web Audio API # dom-audiobuffer-copytochannel |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
copyToChannel |
43 | 13 | 27 | No | 30 | 14.1 | 43 | 43 | 27 | 30 | 14.5 | 4.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer/copyToChannel