GPUExternalTexture：label 属性

实验性： 这是一个实验性技术
在生产环境中使用此功能之前，请仔细检查浏览器兼容性表。

安全上下文： 此功能仅在安全上下文 (HTTPS) 中可用，在一些或所有支持浏览器中可用。

label 是 GPUExternalTexture 接口的一个属性，它提供了一个标签，可以用来识别对象，例如在 GPUError 消息或控制台警告中。

可以在传入到源 GPUDevice.importExternalTexture() 调用的描述符对象中提供 label 属性来设置它，也可以直接在 GPUExternalTexture 对象上获取和设置它。

值

一个字符串。如果之前没有如上所述进行设置，它将是一个空字符串。

示例

通过 GPUExternalTexture.label 设置和获取标签

// ...

const externalTexture = device.importExternalTexture({
  source: video,
});

externalTexture.label = "myExtTexture";

console.log(externalTexture.label); // "myExtTexture"

通过源 GPUDevice.importExternalTexture() 调用设置标签，然后通过 GPUExternalTexture.label 获取它

// ...

const externalTexture = device.importExternalTexture({
  source: video,
  label: "myExtTexture",
});

console.log(externalTexture.label); //  "myExtTexture"

规范

规范
WebGPU # dom-gpuobjectbase-label

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

WebGPU API