GPU: Methode getPreferredCanvasFormat()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die getPreferredCanvasFormat() Methode des GPU Interfaces gibt das optimale Texturformat für ein Canvas zur Darstellung von Inhalten mit 8-Bit-Tiefe und standardmäßiger dynamischer Reichweite auf dem aktuellen System zurück.

Dies wird üblicherweise verwendet, um einen Aufruf von GPUCanvasContext.configure() mit dem optimalen format-Wert für das aktuelle System zu versorgen. Dies wird empfohlen – wenn Sie das bevorzugte Format beim Konfigurieren des Canvas-Kontexts nicht verwenden, könnten Sie je nach Plattform zusätzlichen Aufwand haben, wie zusätzliche Texturkopien.

Syntax

js
getPreferredCanvasFormat()

Parameter

Keine.

Rückgabewert

Ein String, der ein Texturformat für ein Canvas angibt. Der Wert kann rgba8unorm oder bgra8unorm sein.

Ausnahmen

Keine.

Beispiele

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

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

Spezifikationen

Specification
WebGPU
# dom-gpu-getpreferredcanvasformat

Browser-Kompatibilität

Siehe auch