GPUExternalTexture

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

GPUExternalTexture 接口是 WebGPU API 的一部分,它代表一个包装对象,其中包含一个 HTMLVideoElement 的快照,该快照可用作 GPU 渲染操作中的纹理。

GPUExternalTexture 对象实例是使用 GPUDevice.importExternalTexture() 创建的。

实例属性

label

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

示例

在 WebGPU 示例 视频上传示例 中,一个 GPUExternalTexture 对象(通过 GPUDevice.importExternalTexture() 调用创建)被用作绑定组条目 resource 的值,该值在通过 GPUDevice.createBindGroup() 调用创建 GPUBindGroup 时指定。

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

规范

规范
WebGPU
# gpuexternaltexture

浏览器兼容性

另见