GPUCanvasContext: getConfiguration()-Methode

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 getConfiguration()-Methode des GPUCanvasContext-Interfaces gibt die aktuelle Konfiguration zurück, die für den Kontext festgelegt ist.

Syntax

js
getConfiguration()

Parameter

Keine.

Rückgabewert

Ein Objekt, das die auf dem Kontext festgelegten Konfigurationsoptionen enthält (d.h. über die GPUCanvasContext.configure()-Methode festgelegt), oder null, wenn keine Konfiguration festgelegt ist (entweder wurde keine Konfiguration zuvor festgelegt, oder eine Konfiguration wurde festgelegt und dann wurde GPUCanvasContext.unconfigure() auf dem Kontext aufgerufen).

Beispiele

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

if (!navigator.gpu) {
  throw Error("WebGPU not supported.");
}

const adapter = await navigator.gpu.requestAdapter();
if (!adapter) {
  throw Error("Couldn't request WebGPU adapter.");
}

const device = await adapter.requestDevice();

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

console.log(context.getConfiguration());
/* Logs something like:

{
  "alphaMode": "premultiplied",
  "colorSpace": "srgb",
  "device": { ... },
  "format": "bgra8unorm",
  "toneMapping": {
      "mode": "standard"
  },
  "usage": 16,
  "viewFormats": []
}
*/

Spezifikationen

Specification
WebGPU
# dom-gpucanvascontext-getconfiguration

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch