Skip to main content
Something a render pass can draw into. It promises neither sampling nor contents kept between frames; GPUCanvas adds both.

​
Fields

​
width

Width in pixels.

​
height

Height in pixels.

​
format

Pixel format of the target. MSAA resolve requires source and target to have identical formats — always derive GPUTexture and pipeline formats from this value:

​
sampleCount

Samples per pixel. Always 1 for a canvas; can be above 1 for context:gpuTarget() on some hosts.

​
view

View of the target, for a color attachment or an MSAA resolve target. Nil on a frame with nothing to draw into. Read it each frame; a view kept across a resize errors when a pass uses it.

​
Methods

​
beginRenderPass

Open a GPU render pass targeting this target. The descriptor must include at least one color attachment or a depthStencil attachment. Color attachment views default to this target’s view when omitted; provide them explicitly when rendering to a different target (e.g. MSAA). The pass’s sampleCount is derived from the attachments (WebGPU rule: all attachments share one sampleCount). Must be called during draw. Issue draw calls on the returned pass, then call :finish(). A pass may begin while another is open, as when a drawn artboard’s own scripts render: it runs ahead of the pass it was begun inside, so that pass can sample its output. With nothing to draw into, the pass drops its commands.