Method copyTo

src/audio_data.ts:190–294

* Copies the audio data to a destination buffer.

(destination: AllowSharedBufferSource, options: AudioDataCopyToOptions)

	 * Copies the audio data to a destination buffer.
	 */
	copyTo(destination: AllowSharedBufferSource, options: AudioDataCopyToOptions) {
		this.ensureNotClosed();

		if (!options || typeof options !== 'object') {
			throw new TypeError('options must be an object.');
		}

		// Spec: Compute Copy Element Count algorithm
		const destFormat = options.format ?? this.format!;

		// 1. Check Plane Index
		const destIsPlanar = formatIsPlanar(destFormat);
		if (!Number.isInteger(options.planeIndex) || options.planeIndex < 0) {
			throw new TypeError('planeIndex must be a non-negative integer.');
		}

		if (destIsPlanar) {
			if (options.planeIndex >= this.numberOfChannels) {
				throw new RangeError('planeIndex out of range');
			}
		} else {
			if (options.planeIndex !== 0) {
				throw new RangeError('planeIndex out of range');
			}
		}

		// 2. Check Frame Offset
		const frameOffset = options.frameOffset ?? 0;
		if (!Number.isInteger(frameOffset) || frameOffset < 0) {
			throw new TypeError('frameOffset must be a non-negative integer.');
		}
		if (frameOffset >= this.numberOfFrames) {
			throw new RangeError('frameOffset out of range');
		}

		// 3. Check Frame Count
		const copyFrameCount
			= options.frameCount !== undefined ? options.frameCount : (this.numberOfFrames - frameOffset);

		if (options.frameCount !== undefined && (!Number.isInteger(options.frameCount) || options.frameCount < 0)) {
			throw new TypeError('frameCount must be a non-negative integer.');
		}

		if (copyFrameCount > (this.numberOfFrames - frameOffset)) {
			throw new RangeError('frameCount out of range');
		}

		// Spec: Check destination size
		const destBytesPerSample = getBytesPerSample(destFormat);
		const destElementCount = destIsPlanar ? copyFrameCount : copyFrameCount * this.numberOfChannels;
		const requiredSize = destElementCount * destBytesPerSample;

		if (destination.byteLength < requiredSize) {
			throw new RangeError('Destination buffer is too small');
		}

		const destView = toDataView(destination);
		const writeFn = getWriteFunction(destFormat);