GPU:getPreferredCanvasFormat() 方法

可用性有限

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

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

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

getPreferredCanvasFormat() 方法是 GPU 接口的一部分,用于返回当前系统上显示 8 位深度、标准动态范围内容的最佳画布纹理格式。

这通常用于为 GPUCanvasContext.configure() 调用提供当前系统的最佳 format 值。这是推荐的做法 — 如果在配置画布上下文时未使用首选格式,可能会产生额外的开销,例如额外的纹理复制,具体取决于平台。

语法

js
getPreferredCanvasFormat()

参数

无。

返回值

一个表示画布纹理格式的字符串。该值可以是 rgba8unormbgra8unorm

异常

无。

示例

js
const canvas = document.querySelector("#gpuCanvas");
const context = canvas.getContext("webgpu");

context.configure({
  device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});

规范

规范
WebGPU
# dom-gpu-getpreferredcanvasformat

浏览器兼容性

另见