Видеокадр: метод copyTo()

Метод copyTo() интерфейса VideoFrame копирует содержимое VideoFrame в ArrayBuffer.

destination

ArrayBuffer, массив TypedArray или объект DataView для копирования.

options Необязательно

Объект, содержащий следующее:

rect Необязательно

Прямоугольник пикселей для копирования из VideoFrame. Если не указано, используется visibleRect. Формат – объект-словарь, содержащий:

• x: Координата x.
• y: Координата y.
• width: Ширина кадра.
• height: Высота кадра.

layout Необязательно

Список, содержащий следующие значения для каждого плоскости в VideoFrame:

offset

Целое число, представляющее смещение в байтах, где начинается заданная плоскость.

stride

Целое число, представляющее количество байтов, включая отступы, используемых каждой строкой плоскости. Плоскости не могут перекрываться. Если layout не указано, плоскости будут плотно упакованы.

format Необязательно

Формат пикселей для данных пикселей в destination. Может быть установлен на "RGBA", "RGBX", "BGRA", "BGRX". Если не указано, используется format.

colorSpace Необязательно

Указывает цветовое пространство данных пикселей в destination. Может быть установлено на "srgb" для пространства sRGB или "display-p3" для пространства DCI-P3. Применимо только к форматам пикселей RGB. Если не указано, используется "srgb.

Promise , который разрешает макет копии по завершении копирования.

В следующем примере копируются все содержимое videoFrame.

let buffer = new Uint8Array(videoFrame.allocationSize());
let layout = await videoFrame.copyTo(buffer);

В следующем примере преобразуется часть videoFrame в формат RGB.

const videoRect = {
  x: 100,
  y: 100,
  width: 80,
  height: 60,
};
const options = {
  rect: videoRect,
  format: "RGBX",
  colorSpace: "display-p3",
};
const size = videoFrame.allocationSize(options);
const buffer = new ArrayBuffer(size);
const layout = await videoFrame.copyTo(buffer, options);