Distance
Updated: 4 Dec 2023
This shading node generates a pattern using the distance from the given pixel to the node's position.
Distance
Method #
This shading node generates a pattern using the distance from the given pixel to the node’s position. Shading nodes are applied to material texture channels to generate textures procedurally while rendering.
Parameters
Parameter Details Position X The objects position along the local x-axis.
Position Y The objects position along the local y-axis.
Position Z The objects position along the local z-axis.
Rotation Heading The objects rotation around the local y-axis.
Rotation Pitch The objects rotation around the local x-axis.
Rotation Bank The objects rotation around the local z-axis.
Scale X The objects scale along the local x-axis.
Scale Y The objects scale along the local y-axis.
Scale Z The objects scale along the local z-axis.
Control the inheritance of the transforms from the parent.
Parameter Details Position Toggle inheritance of the Position from the parent.
Rotation Toggle inheritance of the Rotation from the parent.
Scale Toggle inheritance of the Scale from the parent.
World Position Only Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details Mapping Type The input position channel.
- World Position : The position of each vertex relative to the scene world space.
- Object Local Position : The position of each vertex relative to the objects local space.
- Texture Coordinate : The position of each vertex relative to the objects texture coordinates.
Mode Determines how the distance value should be processed.
- Linear : Return the distance value directly.
- Sine : Returns a sine pattern using the distance value as input.
- Cos : Returns a cosine pattern using the distance value as input.
- Mod : Returns a repeating modulus pattern using the distance value as input.
Invert Inverts the distance result.
Distance Scale Scales the distance value.
Distance Offset Offsets the distance value.
Range Min Controls the lower value of the output range.
Range Max Controls the upper value of the output range.
Power Controls the power curve between the high and low values.
Axes Choose which axes are used for calculating the axes. All 3 enables represents the distance from a point, 2 axes would be the distance from a line, and one axis the distance from a plane.
Preview In Viewport Passes this node’s output to the destination material as a colour channel, so it can be previewed more easily.
Inputs
| Parameter | Details |
|---|---|
| Position X | The objects position along the local x-axis. |
| Position Y | The objects position along the local y-axis. |
| Position Z | The objects position along the local z-axis. |
| Rotation Heading | The objects rotation around the local y-axis. |
| Rotation Pitch | The objects rotation around the local x-axis. |
| Rotation Bank | The objects rotation around the local z-axis. |
| Scale X | The objects scale along the local x-axis. |
| Scale Y | The objects scale along the local y-axis. |
| Scale Z | The objects scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| Mapping Type | The input position channel.
|
| Mode | Determines how the distance value should be processed.
|
| Invert | Inverts the distance result. |
| Distance Scale | Scales the distance value. |
| Distance Offset | Offsets the distance value. |
| Range Min | Controls the lower value of the output range. |
| Range Max | Controls the upper value of the output range. |
| Power | Controls the power curve between the high and low values. |
| Axes | Choose which axes are used for calculating the axes. All 3 enables represents the distance from a point, 2 axes would be the distance from a line, and one axis the distance from a plane. |
| Preview In Viewport | Passes this node’s output to the destination material as a colour channel, so it can be previewed more easily. |
| Name | Description | Typical Input |
|---|---|---|
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |