Notch Notch Manual 0.9.23
 Light | Dark
Directional Light

Directional Light

Emit light from an infinite direction.

image

image

Method #

Add a directional light node to a scene to produce ambient directional lighting throughout. Light is emitted in a parallel direction at the normal to an infinite plane.

Directional lights only cast shadows with raytracing enabled.

All nodes connected to this node are treated as if flowing to the parent node, and inherits any transformation changes along the chain.

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
ColourThe colour of the light.
BrightnessHow bright the light is.
Apply SpecularControl whether this light applies specular light onto objects.
Apply DiffuseControl whether this light applies diffuse light onto objects.
Show Light ConeShow a cone in the scene to represent the lights current position and rotation.

These properties control shadow properties from the light.

ParameterDetails
RaytracedThis will enable raytracing in the skylight. Only works with raytracing enabled in the Root node
Raytraced Shadow SamplesHow many samples will be taken per frame for raytracing. Best used with continuous refinement enabled and the Denoiser Node
Shadow SoftnessChange how much softness is applied to the shadow edges.
Z BiasIncreasing Z bias will improve the accuracy of grounding objects to their shadows.
Post FilterApply a filter to the light map which blurs the output result, smoothing it out.

Inputs

NameDescriptionTypical Input
Projection ImageControls the direction the image is projected from, independant of the light. Only functions if an image is being projected from the light.Video Loader
Point CacheUse a point cache node to calculate the surrounding lighting calculations.Point Cache
Affected NodesChoose which nodes are affected by the light node. by default, all are affected.3D Object
Texture Projection NodeControls the direction the image is projected from, independant of the light. Only functions if an image is being projected from the light.Null
Multi-Source ControllerDeprecated feature.
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