1. 面向开发者的 Web 技术
  2. Web API
  3. GPU
  4. GPU：getPreferredCanvasFormat() 方法

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

GPU：getPreferredCanvasFormat() 方法

有限可用

此特性不属于基线，因为它尚未在主流浏览器中得到支持。

Want more browser support for this feature? Tell us why.

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

GPU 接口的 getPreferredCanvasFormat() 方法返回用于当前系统上显示 8 位色深、标准动态范围（SDR）内容的最佳 canvas 纹理格式。

这通常用于为当前系统提供 GPUCanvasContext.configure() 调用的最佳 format 值。这是推荐的——如果你没有在配置 canvas 上下文时使用最佳的格式，可能会产生开销，例如根据平台而异的额外纹理的复制。

语法

js
getPreferredCanvasFormat()

参数

无。

返回值

一个字符串，表示 canvas 的纹理格式。该值可以是 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

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题