RenderTarget

The depth of the render target.

Default is 1.

Whether to allocate a depth buffer or not.

Default is true.

Instead of saving the depth in a renderbuffer, a texture can be used instead which is useful for further processing e.g. in context of post-processing.

Default is null.

The height of the render target.

Default is 1.

This flag can be used for type testing.

Default is true.

Whether to this target is used in multiview rendering.

Default is false.

Whether to resolve the color buffer or not. When set to false, the color attachments do not receive the resolved (single-sampled) output of a render pass and the render target's textures are left untouched. The rendered content is then only accessible within the render pass itself.

Only relevant for multisampled render targets.

Default is true.

Whether to resolve the depth buffer or not. When set to false, the depth texture does not receive the resolved depth output of a render pass which saves memory bandwidth. Use this setting when the depth data of a render pass are not required afterwards.

Only relevant for multisampled render targets in WebGL. WebGPU does not support depth resolves; sampling the depth texture of a multisampled render target accesses the multisampled data directly, see RenderTarget#storeMultisampledDepthBuffer.

Default is true.

Whether to resolve the stencil buffer or not. Analogous to RenderTarget#resolveDepthBuffer but for the stencil aspect.

Default is true.

The number of MSAA samples.

A value of 0 disables MSAA.

Default is 0.

A rectangular area inside the render target's viewport. Fragments that are outside the area will be discarded.

Default is (0,0,width,height).

Indicates whether the scissor test should be enabled when rendering into this render target or not.

Default is false.

Whether to allocate a stencil buffer or not.

Default is false.

Whether to store the multisampled color buffer or not. When set to false, the multisampled data are discarded at the end of a render pass, right after they have been resolved. This saves memory bandwidth, especially on tile-based GPUs, and is the recommended setting for render targets that are fully redrawn each frame and whose output is only accessed via the resolved textures (e.g. scene passes in post-processing chains).

Must be kept true when the multisampled data are needed after the render pass ends, e.g. when rendering into the target without clearing or when the scene contains transmissive objects which require a mid-pass framebuffer copy.

Default is true.

Whether to store the multisampled depth buffer or not. When set to false, the multisampled depth data are discarded at the end of a render pass which saves memory bandwidth.

Must be kept true in WebGPU when the depth texture of a multisampled render target is sampled (e.g. by depth-based post-processing effects) since depth is read directly from the multisampled data.

Default is true.

Whether to store the multisampled stencil buffer or not. Analogous to RenderTarget#storeMultisampledDepthBuffer but for the stencil aspect.

Default is true.

The texture representing the default color attachment.

An array of textures. Each color attachment is represented as a separate texture. Has at least a single entry for the default color attachment.

Whether to create the depth texture as an array texture for per-layer depth testing. This is separate from multiview so layered render targets can use array depth without the multiview extension.

Default is false.

A rectangular area representing the render target's viewport.

Default is (0,0,width,height).

The width of the render target.

Default is 1.

Render target options.