GPU: Methode getPreferredCanvasFormat()

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die getPreferredCanvasFormat()-Methode der GPU-Schnittstelle gibt das optimale Texturformat für Canvas zur Anzeige von Inhalten mit 8-Bit-Tiefe im Standard-Dynamikumfang auf dem aktuellen System zurück.

Dies wird häufig verwendet, um einem Aufruf von GPUCanvasContext.configure() den optimalen format-Wert für das aktuelle System bereitzustellen. Dies wird empfohlen – wenn Sie das bevorzugte Format beim Konfigurieren des Canvas-Kontexts nicht verwenden, kann je nach Plattform zusätzlicher Overhead entstehen, wie z. B. zusätzliche Texturkopien.

Syntax

js
getPreferredCanvasFormat()

Parameter

Keine.

Rückgabewert

Ein String, der ein Texturformat für das 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: device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});

Spezifikationen

Specification
WebGPU
# dom-gpu-getpreferredcanvasformat

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch