The copyFromChannel()
method of the AudioBuffer
interface copies the audio sample data from the specified channel of the AudioBuffer
to a specified Float32Array
.
On this page
AudioBuffer: copyFromChannel() method
Syntax
js
copyFromChannel(destination, channelNumber, startInChannel)
Parameters
-
destination
-
A
Float32Array
to copy the channel's samples to. -
channelNumber
-
The channel number of the current
AudioBuffer
to copy the channel data from. startInChannel
Optional-
An optional offset into the source channel's buffer from which to begin copying samples. If not specified, a value of 0 (the beginning of the buffer) is assumed by default.
Return value
None (undefined
).
Exceptions
-
indexSizeError
-
One of the input parameters has a value that is outside the accepted range:
- The value of
channelNumber
specifies a channel number which doesn't exist (that is, it's greater than or equal to the value ofnumberOfChannels
on the channel). - The value of
startInChannel
is outside the current range of samples that already exist in the source buffer; that is, it's greater than its currentlength
.
- The value of
Examples
This example creates a new audio buffer, then copies the samples from another channel into it.
js
const myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
const anotherArray = new Float32Array(length);
myArrayBuffer.copyFromChannel(anotherArray, 1, 0);
Specifications
Specification |
---|
Web Audio API # dom-audiobuffer-copyfromchannel |
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 | |
copyFromChannel |
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/copyFromChannel