Image
Load a PNG, JPEG, EXR, HDR, TIFF, TGA, BMP, or WebP file from disk as an image.
What it does
Image loads a picture file from disk, PNG, JPEG, EXR, HDR, TIFF, TGA, BMP or WebP, and brings it into the graph as a texture to composite, sample or feed into effects. The output is always a full image, positioned and scaled by the node's own transform: Position, Rotation, Scale, Anchor.
Interpolation sets how the image reads when scaled or rotated off its native pixel grid. Wrap Mode sets what happens at its edges when something samples past them.
When to use it
Bringing an image file into the graph as a starting layer.
Compositing a picture over other layers, with its own Opacity.
Driving colour, height or masking from a photo or texture file: wire Image into an effect or a Sample node.
Needing the image's pixel dimensions elsewhere in the graph: Width and Height are exposed as outputs.
| Parameter | Type | Default |
|---|---|---|
file_path | String | "String::new()" |
interpolation | String | "Bilinear" |
wrap_mode | String | "Clamp" |
opacity | Number | 1 |
position | Vec3 | (0, 0, 0) |
rotation | Vec3 | (0, 0, 0) |
scale | Vec3 | (1, 1, 1) |
anchor | Vec3 | (0, 0, 0) |
Gotchas
Interpolation matters once the image is scaled, rotated or sampled off its native grid. Nearest keeps hard pixel edges, which suits pixel art. Bilinear smooths the transition, which suits photos.
Wrap Mode comes into play when something reads past the image's edges, such as a distorted Sample or a tiled effect. Clamp holds the edge pixel, Repeat tiles the image, Mirror flips it at each repeat.
Width and Height are metadata outputs carrying the image's pixel dimensions, not part of the visible texture. Wire them into an Expression or a downstream numeric input to react to an image's size.
Worked example
Add an Image node and set File Path to the picture to load.
Adjust Position, Rotation, Scale and Anchor to place it in the frame.
Lower Opacity to blend it with layers underneath.
If the image will be scaled or rotated a lot, choose the Interpolation and Wrap Mode that suit it. Bilinear and Clamp are good defaults for photos.