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

瀏覽器相容性

另見