GPU: getPreferredCanvasFormat() 方法

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

安全上下文：此功能仅在 安全上下文（HTTPS）中可用，并且仅在部分或全部 支持的浏览器 中可用。

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

这通常用于为 GPUCanvasContext.configure() 调用提供最佳的 format 值。建议使用此方法 - 如果在配置画布上下文时不使用首选格式，则可能会产生额外的开销，例如额外的纹理复制，具体取决于平台。

语法

js
getPreferredCanvasFormat()

参数

无。

返回值

指示画布纹理格式的字符串。该值可以是 rgba8unorm 或 bgra8unorm。

异常

无。

示例

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

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

规范

规范
WebGPU
# dom-gpu-getpreferredcanvasformat

浏览器兼容性

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

另请参阅