Method copyTo

src/video_frame.ts:290–425

* Copies the frame's pixel data to a destination buffer. Returns the layout of the planes in the destination * buffer.

(destination: AllowSharedBufferSource, options: VideoFrameCopyToOptions = {})

	 * buffer.
	 */
	async copyTo(destination: AllowSharedBufferSource, options: VideoFrameCopyToOptions = {}): Promise<PlaneLayout[]> {
		// 1. If [[Detached]] is true, return a promise rejected with a InvalidStateError DOMException.
		this.ensureNotClosed();

		// 2. If [[format]] is null, return a promise rejected with a NotSupportedError DOMException.
		if (this.format === null) {
			throw new Error('NotSupportedError: VideoFrame format is null');
		}

		// 3. Let combinedLayout be the result of running the Parse VideoFrameCopyToOptions algorithm with options.
		const combinedLayout = ParseVideoFrameCopyToOptions(this, options);

		// 4. If destination.byteLength is less than combinedLayout’s allocationSize, return a promise rejected with
		// // eslint-disable-next-line @stylistic/max-len
		const destBytes = toUint8Array(destination);
		if (destBytes.byteLength < combinedLayout.allocationSize) {
			throw new TypeError(
				`Destination buffer too small. Required: ${combinedLayout.allocationSize},`
				+ ` Available: ${destBytes.byteLength}`,
			);
		}

		// 5. If options.format is equal to one of RGBA, RGBX, BGRA, BGRX then:
		if (options.format && ['RGBA', 'RGBX', 'BGRA', 'BGRX'].includes(options.format)) {
			// Let newOptions be the result of running the Clone Configuration algorithm with options.
			// Assign undefined to newOptions.format.
			const newOptions = { ...options };
			delete newOptions.format;

			// Let rgbFrame be the result of running the Convert to RGB frame algorithm with this, options.format,
			// and options.colorSpace.
			const rgbFrame = await ConvertToRGBFrame(this, options.format, options.colorSpace);

			// Return the result of calling copyTo() on rgbFrame with destination and newOptions.
			try {
				const result = await rgbFrame.copyTo(destination, newOptions);
				rgbFrame.close();
				return result;
			} catch (e) {
				rgbFrame.close();
				throw e;
			}
		}

		// 6. Let p be a new Promise. (Implicit)
		// 7. Let copyStepsQueue be the result of starting a new parallel queue. (Implicit)
		// 8. Let planeLayouts be a new list.
		const planeLayouts: PlaneLayout[] = [];

		// Enqueue the following steps to copyStepsQueue: (fuck the queuing part)

		// Let resource be the media resource referenced by [[resource reference]].
		// (this.data)

		// Let numPlanes be the number of planes as defined by [[format]].
		const info = getPixelFormatInfo(this.format);
		if (!info) throw new TypeError('Unknown format');
		const numPlanes = info.planes.length;