GPUCanvasContext: Methode getCurrentTexture()

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 vor der Verwendung auf produktiven Webseiten.

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 getCurrentTexture()-Methode der GPUCanvasContext-Schnittstelle gibt die nächste GPUTexture zurück, die vom Canvas-Kontext für das Dokument zusammengesetzt werden soll.

Syntax

js
getCurrentTexture()

Parameter

Keine.

Rückgabewert

Eine Instanz des GPUTexture-Objekts.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn getCurrentTexture() auf dem Canvas-Kontext aufgerufen wird, bevor er konfiguriert ist (d. h. bevor GPUCanvasContext.configure() aufgerufen wurde).

Beispiele

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

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

//...
// Later on
const commandEncoder = device.createCommandEncoder();

const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: [0, 0, 0, 1], // Opaque black
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

Spezifikationen

Specification
WebGPU
# dom-gpucanvascontext-getcurrenttexture

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch