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
InvalidStateErrorDOMException- : 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
- The WebGPU API