Method

This node is used to render an image or video on a plane in 3D space. The image may be set directly via the Image parameter or linked via the Video Node input.

Image Plane nodes have similar rendering options to other geometry nodes such as 3D Objects or Shape 3D nodes.

Example
Nodegraph Example

Transform

Name Description
Position X Move its position along the x-axis in local space.
Position Y Move its position along the y-axis in local space.
Position Z Move its position along the z-axis in local space.
Rotation Heading Rotate the object about the x-axis.
Rotation Pitch Rotate the object about the y-axis.
Rotation Bank Rotate the object about the z-axis.
Scale X Scale along the x-axis.
Scale Y Scale along the y-axis.
Scale Z Scale along the z-axis.

Inherit Transform Channels

Toggle which transform channels should be inherited. By default, all are on.

Attributes

Name Description
Image Select an image to be displayed on the image plane.
Normal Map Select a normal map to change how light affects the image plane.
Colour Add a colour filter over the image.
Aspect-Based Scaling Mode Scale the plane by the aspect ratio of the selected image.
  • Disabled, The plane won’t scale to fit the image.
  • Scale X, The image is scaled along the X axis to fit the image.
  • Scale Y, The Image is scaled along the Y axis to fit the image.
  • Larger, Whichever is larger of scale X or Y is chosen.
  • Smaller, Whichever is smaller of scale X or Y is chosen.
Blend Mode Choose how the image blends into the scene.
  • Opaque, the image is solid with alpha values set to black.
  • Alpha To Coverage, the alpha values are used to mask out the image.
  • Alpha Blend, the image alpha values are blended at the edges.
Blend Function Choose how the blend mode functions. See Blend Modes for more.
Normal Map Mode If a normal map is input, control how it is used in the scene.
  • Disabled, Even if a normal map is selected in the node, it won’t be used on the image plane.
  • Normal Mapping, the normal map is used to change how light affects the surface of the plane.
  • Parallax Mapping, the pixels of the image are given height values, which when viewed at an angle gives a 3D effect; cannot occlude itself.
  • Parallax Occlusion Mapping, the pixels of the image are given height values, which when viewed at an angle gives a 3D effect; can occlude itself.
Casts Shadows Toggle whether the object can cast shadows.
Lit Toggle whether the object can be lit by scene lights.
Frame If the image is animated, choose which frame is displayed.
Alpha Control the alpha value of the image.
Metallicness Change how metallic the object looks.
Luminosity Change the brightness of the image.
Specularity How much specular light is reflected from the object.
Roughness How rough the surface of the material is.
Displacement The strength of the displacement from the normal map.
UV Offset X Move the object UV along the x axis.
UV Offset Y Move the object UV along the y axis.
UV Scale X Scale the object UV along the x axis.
UV Scale Y Scale the object UV along the y axis.
Alpha Sort Bias Biases the alpha sort in order to make it render in front or behind other transparent objects.

Video

Name Description
Frame Offset Offset the start frame.
Frame Rate Control the frame rate of the video.
Loop End Frame Choose when the video stops looping.

Texture Animation

Name Description
Is Texture Animation Page Toggle whether the input image should be treated as an animation page containing multiple frames of an animation.
Num Frames X The number of animation frames in the X axis contained in the image.
Num Frames Y The number of animation frames in the Y axis contained in the image.

Crop

Name Description
Crop Enabled Enable the image to be cropped.
Crop Left How much of the image is cropped from the left.
Crop Right How much of the image is cropped from the right.
Crop Top How much of the image is cropped from the bottom.
Crop Bottom How much of the image is cropped from the top.

Inputs

Name Description Typical Node Input
Video Node Add a video to be shown on the image plane. Video Loader
Alpha Image Use an image to control the alpha values of the image plane. Video Loader
UV Remap Image Use an image to remap the UV of the image plane. Image Plane
Transform Modifier Links all transform properties to the input node. Null
Target Node Always faces the x-axis towards the inputs anchor point. Null
Local Transform Override Override the transformation values of the node, relative to its parent. Null

Outputs

The outputs section for this node is currently being worked on.