GPUDevice: importExternalTexture() метод

Метод importExternalTexture() интерфейса GPUDevice принимает объект HTMLVideoElement или VideoFrame в качестве входных данных и возвращает объект-обёртку GPUExternalTexture, содержащий моментальный снимок видео, который можно использовать в качестве кадра в операциях рендеринга в GPU.

descriptor

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

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

Перечисление, определяющее цветовое пространство для кадра видео. Возможные значения: "srgb" и "display-p3". Если опущено, значение по умолчанию colorSpace - "srgb".

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

Строка, предоставляющая метку, которая может быть использована для идентификации объекта, например, в сообщениях GPUError или предупреждениях консоли.

source

Источник видео снимка, HTMLVideoElement или VideoFrame.

Экземпляр объекта GPUExternalTexture.

Обратите внимание, что момент истечения срока действия (удаления) объекта GPUExternalTexture зависит от источника:

• Объекты GPUExternalTexture со ссылкой на HTMLVideoElement истекают, как только они используются (например, в группе связей).
• Объекты GPUExternalTexture со ссылкой на VideoFrame истекают только когда VideoFrame закрыт, например, через вызов VideoFrame.close().

При вызове importExternalTexture() должны быть соблюдены следующие условия, в противном случае генерируется GPUValidationError и возвращается недопустимый объект GPUExternalTexture:

• Моментальный снимок видео должен быть пригоден к использованию (например, источник видео загружен правильно и не имеет ширины или высоты 0).

SecurityError DOMException

Генерируется, если данные источника видео находятся в другом домене.

В примере WebGPU загрузки видео вызов importExternalTexture() используется в качестве значения для записи группы связей resource, когда создается GPUBindGroup с помощью вызова GPUDevice.createBindGroup():

//...

const uniformBindGroup = device.createBindGroup({
  layout: pipeline.getBindGroupLayout(0),
  entries: [
    {
      binding: 1,
      resource: sampler,
    },
    {
      binding: 2,
      resource: device.importExternalTexture({
        source: video,
      }),
    },
  ],
});

//...

• API WebGPU