MDN self-hosted library · e01.org

GPUCanvasContext: getCurrentTexture() method

WebGPU API

WebGPU API

The getCurrentTexture() method of the GPUCanvasContext interface returns the next GPUTexture to be composited to the document by the canvas context.

Syntax

getCurrentTexture()

Parameters

None.

Return value

A GPUTexture object instance.

Exceptions

  • InvalidStateError DOMException
  • : Thrown if getCurrentTexture() is called on the canvas context before it is configured (i.e., before GPUCanvasContext.configure() has been called).

Examples

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

context.configure({
  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);

Specifications

Browser compatibility

See also