Documentation
Gradient Map
VFX Loom 1.0 reference for the Gradient Map node.
processing.gradientMap 
Overview
Maps an Image input through a four-stop colour ramp while preserving alpha. Use Shape or Distance as the scalar-field source.
Pointwise gradient lookup from input luminance; alpha is preserved.
- Category
- Color
- Internal ID
processing.gradientMap- Version
- VFX Loom 1.0
Inputs
| Input | Type | Required | Default | Meaning |
|---|---|---|---|---|
| in | Image | Required | — | See the overview for the node's documented behavior. |
Properties
| Property | Type | Default | Animatable | Range / options | Effect |
|---|---|---|---|---|---|
| Stop 0 | Color | (0,0,0,1) | Yes | — | Animatable control; changing it over time varies the node response. |
| Stop 1 | Color | (.25,.25,.25,1) | Yes | — | Animatable control; changing it over time varies the node response. |
| Stop 2 | Color | (.75,.75,.75,1) | Yes | — | Animatable control; changing it over time varies the node response. |
| Stop 3 | Color | (1,1,1,1) | Yes | — | Animatable control; changing it over time varies the node response. |
| Stop 1 At | Scalar | 1/3 | Yes | Hard 0..1 | Animatable control; changing it over time varies the node response. |
| Stop 2 At | Scalar | 2/3 | Yes | Hard 0..1 | Animatable control; changing it over time varies the node response. |
| Interpolation | Enum | Linear | Not declared | Linear · Smooth · Constant | Selects the interpolation behavior; each option changes the operation described in the overview. |
Outputs
| Output | Type | Meaning |
|---|---|---|
| out | Image | The production node output described by the overview. |
Usage
In practice
- Use Gradient Map when the graph needs Maps an Image input through a four-stop colour ramp while preserving alpha. Use Shape or Distance as the scalar-field source.
- Pointwise gradient lookup from input luminance; alpha is preserved.
- Use it after a source or scalar field, then send the adjusted image or colour value to a downstream composite or material stage.
Examples
These examples show Gradient Map in supplied VFX Loom graph setups. Each graph link opens the corresponding node reference; the explanation below the media is specific to this node's role in that setup.
Shape → Gradient Map → Emboss → Pixelate
A stylized ring pipeline that turns Shape coverage into a mapped colour image, adds relief-like contrast, then deliberately reduces detail with Pixelate.
How Gradient Map contributes
Gradient Map translates the Shape values into the yellow colour ramp visible in the preview. It is the point where grayscale coverage becomes a designed palette.
Notes / limitations
- No step is declared for Stop 1 At or Stop 2 At.