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

瀏覽器相容性

另見