GPUDevice: importExternalTexture() 方法

descriptor

包含以下属性的对象

colorSpace 可选

一个枚举值，指定用于视频帧的颜色空间。可能的值为 "srgb" 和 "display-p3"。如果省略，colorSpace 默认为 "srgb"。

label 可选

一个字符串，提供一个标签，可用于标识对象，例如在 GPUError 消息或控制台警告中。

source

视频快照的 HTMLVideoElement 或 VideoFrame 源。

一个 GPUExternalTexture 对象实例。

请注意，GPUExternalTexture 对象何时过期（被销毁）取决于其源是什么

• 具有 HTMLVideoElement 源的 GPUExternalTexture 对象在使用时（例如在绑定组中）立即过期。
• 具有 VideoFrame 源的 GPUExternalTexture 对象仅在 VideoFrame 关闭时过期，例如通过 VideoFrame.close() 调用。

调用 importExternalTexture() 时必须满足以下条件，否则将生成 GPUValidationError 并返回一个无效的 GPUExternalTexture 对象

• 视频快照可用（例如，视频源已正确加载，并且宽度或高度不为 0）。

SecurityError DOMException

如果视频源数据是跨域的，则抛出此异常。

在 WebGPU 示例 视频上传示例 中，importExternalTexture() 调用用作绑定组条目 resource 的值，在通过 GPUDevice.createBindGroup() 调用创建 GPUBindGroup 时指定。

//...

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

//...

• The WebGPU API