Notch Notch Manual 0.9.23
 Light | Dark
Image Plane

Image Plane

Render an image or video on a plane in 3D space.

image

image

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.

This node outputs the normal transformation and translation values, but it also outputs A mapped texture which can be used on mask node inputs for Particle Emitters and Particle Affectors.

Parameters

These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.

ParameterDetails
Position XMove along the local x-axis.
Position YMove along the local y-axis.
Position ZMove along the local z-axis.
Rotation HeadingRotate around the local y-axis.
Rotation PitchRotate around the local x-axis.
Rotation BankRotate around the local z-axis.
Scale XScale along the local x-axis.
Scale YScale along the local y-axis.
Scale ZScale along the local z-axis.

Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.

ParameterDetails
Position XToggle inheritance of the X Position from the parent.
Position YToggle inheritance of the Y Position from the parent.
Position ZToggle inheritance of the Z Position from the parent.
Rotation HeadingToggle inheritance of the Rotation Heading from the parent.
Rotation PitchToggle inheritance of the Rotation Pitch from the parent.
Rotation BankToggle inheritance of the Rotation Bank from the parent.
Scale XToggle inheritance of the X Scale from the parent.
Scale YToggle inheritance of the Y Scale from the parent.
Scale ZToggle inheritance of the Z Scale from the parent.
World Position OnlyInherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit TimeToggle inheritance of time from the parent.

These properties control the core behaviours of the node.

ParameterDetails
ImageSelect an image to be displayed on the image plane.
Normal MapSelect a normal map to change how light affects the image plane.
ColourAdd a colour filter over the image.
Aspect-Based Scaling ModeScale 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 ModeChoose 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 FunctionChoose how the blend mode functions. See Blend Modes for more.
Normal Map ModeIf 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 ShadowsToggle whether the object can cast shadows.
LitToggle whether the object can be lit by scene lights.
FrameIf the image is animated, choose which frame is displayed.
AlphaControl the alpha value of the image.
MetallicnessChange how metallic the object looks.
LuminosityChange the brightness of the image.
SpecularityHow much specular light is reflected from the object.
RoughnessHow rough the surface of the material is.
DisplacementThe strength of the displacement from the normal map.
UV Offset XMove the mesh UV along the x axis.
UV Offset YMove the mesh UV along the y axis.
UV Scale XScale the mesh UV along the x axis.
UV Scale YScale the mesh UV along the y axis.
Alpha Sort BiasBiases the alpha sort in order to make it render in front or behind other transparent objects.

These properties control video playback if a video is added to the image attribute. Videos connected via the video input have their own properties which overrise these settings.

ParameterDetails
Frame OffsetOffset the start frame.
Frame RateControl the frame rate of the video.
Loop End FrameChoose when the video stops looping.

These properties control sprite sheet animation.

ParameterDetails
Is Texture Animation PageToggle whether the input image should be treated as an animation page containing multiple frames of an animation.
Num Frames XThe number of animation frames in the X axis contained in the image.
Num Frames YThe number of animation frames in the Y axis contained in the image.

These properties crop the selected image.

ParameterDetails
Crop EnabledEnable the image to be cropped.
Crop LeftHow much of the image is cropped from the left.
Crop RightHow much of the image is cropped from the right.
Crop TopHow much of the image is cropped from the bottom.
Crop BottomHow much of the image is cropped from the top.

Inputs

NameDescriptionTypical Input
Video NodeAdd a video to be shown on the image plane.Video Loader
Alpha ImageUse an image to control the alpha values of the image plane.Video Loader
UV Remap ImageUse an image to remap the UV of the image plane.Image Plane
Transform ModifierApply the transforms of another node to this node.Null
Target NodeModifiy the rotations of the node to always direct the z axis towards the input.Null
Local Transform OverrideApply the transforms of another node to this node, relative to its parent.Null