Canvas
Set the project canvas resolution, background, and colour space.
What it does
Canvas sets a graph's output size, its colour space, and what shows behind everything else. Every graph and every subgraph can carry one Canvas node. Width, Height and Background feed the render pipeline directly, and the colour-space and tone-curve settings decide how the final image looks on screen and in an export.
An image wired into Background Image sits behind the scene instead of the flat colour. Parent Mode decides whether a subgraph's Canvas inherits the parent's settings or sets its own.
When to use it
Setting the output resolution for a graph or subgraph.
A background colour or a background image behind everything else.
Banding in a gradient or a feedback loop: raise Precision.
Wide-gamut or HDR work needing ACEScg, a specific tone curve, or a wider display gamut.
Nested subgraphs, where the inner one either follows the outer canvas or sets its own resolution and background.
| Parameter | Type | Default |
|---|---|---|
bg_image | FieldOf(Raster) | — |
width | Number | 1920 |
height | Number | 1080 |
background | Color | rgba(0.00, 0.00, 0.00, 0.00) |
precision | String | "8-bit" |
color_space | String | "Linear sRGB" |
view_transform | String | "ACES Filmic" |
display_gamut | String | "sRGB" |
parent_mode | String | "Match Parent" |
Gotchas
Background shows only when nothing is wired into Background Image. The image takes priority over the flat colour.
A graph with no Canvas node still renders, at 1920×1080, transparent, 8-bit, without the visible canvas boundary in the viewport.
Only the first Canvas node in a graph is used. A second one shows an error state and is ignored.
Rec.2100 PQ and Rec.2100 HLG describe an HDR display target, but the viewport previews in SDR until HDR display output is supported. They tag export intent rather than previewing true HDR brightness on screen.
Worked example
Add a Canvas node to your graph. Set Width and Height to your target resolution.
Set Background to a colour, or wire an Image/Video into Background Image to use it as a backdrop instead.
For banding, raise Precision to 16-bit HDR, or 32-bit Float for maximum headroom.
For a subgraph, set Parent Mode to Independent so it takes its own resolution and background instead of following the parent graph.