Image
Updated: 22 Mar 2024
Genreate a Procedural shape from an image.
Image
Method #
This node generates a distance field by using the luminance of an input image as a mask to generate a 3D extrusion of a 2D image.
Nodes connected to this node will generally follow the parent child hierarchy. Other Procedural Generator nodes can be configured to combine with this shape using their CSG modes, and displacement nodes will only apply to this shape.
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.
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 Texture The image used to generate the effect.
Colour Texture An image from which to read and output colours values, for procedural renderers that support it. this is only visible when the alpha values of the material colour property is less than 1.
Height Scale Scales the thickness of the generated shape.
Distance Offset Offsets the distance field values, causing the generated distance field to expand of contract.
Wrap Mode U/V Mode Change how the image wraps around the the u/v axes.
- Clamp : The edges of the image are extended to fill the space left by the transform.
- Repeat : The image is repeated until if fills the space left by the transform.
Power Applies a power curve to the height value, to control steepness.
CSG Mode These options change how a this procedural node combines with the existing of the procedural system.
- Replace : Replaces the previous procedural system with a new procedural shape.
- Union : Simply combines both the new procedural shape and the existing procedural system.
- Intersection : Interesects the new shape with the shape before.
- Subtract : Subtracts the new procedural shape from the existing procedural system.
- Blend : Blends between both the new procedural shape and the existing procedural system, driven by the CSG Blend Weight.
- Union Blend : A combination of union and blend which tries to preserve both objects more, with the blending being driven by the CSG Blend Weight.
- Smooth Union : The new procedural is added to the old, and smoothing (driven by the CSG Blend Weight) is applied to the outcome.
- Smooth Subtract : The new procedural shape is subtracted from the existing procedural system, and smoothing (driven by the CSG Blend Weight) is applied to the outcome.
- Offset : Blends one procedural ontop of the other another withing the area of the original procedural system.
- Custom Code : Allows you to enter your own expression code.
CSG Blend Weight How much the new procedural blends with the old procedurals, depending on the CSG Blend Weight.
Affect Colour Affect the colour of the generated procedural system. only functions with ‘Generate Colours’ enabled in some Procedural Render nodes.
Always Enabled (No Time Bars) When enabled, this node will run regardless of time bar enable/disable. Due to how Notch handles shader generation with procedurals, with this enabled the node runs more efficiently.
Material Colour Modify the colour for the procedural material.
Custom CSG Code Type your Custom code here, using the HLSL language. Read more on Editable Code.
Inputs
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.
| 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 |
|---|---|
| Texture | The image used to generate the effect. |
| Colour Texture | An image from which to read and output colours values, for procedural renderers that support it. this is only visible when the alpha values of the material colour property is less than 1. |
| Height Scale | Scales the thickness of the generated shape. |
| Distance Offset | Offsets the distance field values, causing the generated distance field to expand of contract. |
| Wrap Mode U/V Mode | Change how the image wraps around the the u/v axes.
|
| Power | Applies a power curve to the height value, to control steepness. |
| CSG Mode | These options change how a this procedural node combines with the existing of the procedural system.
|
| CSG Blend Weight | How much the new procedural blends with the old procedurals, depending on the CSG Blend Weight. |
| Affect Colour | Affect the colour of the generated procedural system. only functions with ‘Generate Colours’ enabled in some Procedural Render nodes. |
| Always Enabled (No Time Bars) | When enabled, this node will run regardless of time bar enable/disable. Due to how Notch handles shader generation with procedurals, with this enabled the node runs more efficiently. |
| Material Colour | Modify the colour for the procedural material. |
| Custom CSG Code | Type your Custom code here, using the HLSL language. Read more on Editable Code. |
| Name | Description | Typical Input |
|---|---|---|
| Image | The image used to generate the distance field. | Video Source |
| 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 |