Table of Contents

Angular Gradient Node

  • Category: Base Shape
  • Edition: All editions
  • Output type: Mask
  • Typical place in a graph: a helper mask, multiplied with other shapes or used as a direction input

Angular Gradient makes a value that sweeps once around a center point: it starts at 1 just past the direction you choose, falls evenly as it goes around, and reaches 0 a full turn later, where it jumps back to 1. Use it when something should change depending on which side of a point you are on: one side of an island steeper than the other, a forest only on the eastern half of a valley, or a varying direction for warps. Used directly as height it makes a spiral ramp with a cliff along the seam.

Angular gradient in 2D and as a spiral ramp in 3D

When to use it

  • Make a feature differ around a point: a crater rim higher on one side, an island with cliffs on one coast and beaches on the other.
  • Give a warp a direction that turns around a center, for swirling patterns, with Angular Warp.
  • Build a spiral ramp, such as a path around a mountain, together with Radial Gradient.
  • Not for: a straight change across the map (use Axial Gradient); a falloff by distance from a point (use Radial Gradient).

Inputs

None.

Outputs

Slot Type What it holds
Output Mask From 1 to 0 around Start Point, with a hard seam along the direction toward End Point, where 0 meets 1.

Properties

Property Default Range What it does
Start Point 0.5, 0.5 0 to 1 across the biome, or meters The center the gradient turns around. (0, 0) is the biome's lower left corner in the 2D viewport. You can drag the point in the 2D viewport.
End Point 1, 0.5 Same as Start Point Sets the direction of the seam. Only its direction from Start Point matters, not how far away it is.
World Position Off On, Off On: both points are world positions in meters, so the gradient stays in place when the biome moves or resizes. Off: they are 0 to 1 across this biome.

Common properties

Property What it does
Id The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node.
Resolution How detailed this node's result is, in texels across the biome. Angular Gradient has no input, so Relative To Main Input (default) and Relative To Graph both follow the biome's Canvas Resolution, times the multiplier below. Absolute sets an exact size. Higher resolution keeps the seam crisp. Absolute is limited to 32 to 512 in Vista Personal and 32 to 4096 in Vista Indie and Pro.
Split Execution Lets this node run over several frames so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off.
Bypass Skips the node. It has no input to pass through, so nothing comes out, and the nodes after it receive empty, flat ground.

Examples

Each example shows the gradient in 2D (black is 0, red is 1) and used directly as the terrain height in 3D, on a 1024 × 1024 m biome with a terrain height of 400 m.

Default

Property Value
Start Point 0.5, 0.5
End Point 1, 0.5

2D: brightness sweeping around the middle, with a sharp edge running to the right 3D: a spiral ramp around the middle, with a cliff where it starts again

The value turns around the middle of the biome. Along the line from the center toward the right edge, it jumps from 0 to 1, which shows as a cliff in 3D.

Moved and turned

Property Value
Start Point 0.3, 0.3
End Point 0.3, 1

2D: the sweep centered lower left, with the seam pointing up 3D: the spiral ramp moved off center, cliff facing a different way

The center moves to (0.3, 0.3) and the seam now points straight up the biome.

Recipes

  • One coast steeper than the other: island mask × Angular Gradient through a Curve that is 1 on the steep side and lower elsewhere. Put the seam on the side where the curve is the same at both ends, so it does not show.
  • Spiral path: Angular Gradient × Radial Gradient gives a ramp that winds down around a peak; use it as a mask to carve or flatten a path.
Warning

The seam is a hard jump from 0 to 1. If the gradient shapes the terrain directly, it makes a cliff. Hide it by pointing it where the effect does not matter, or by reshaping the gradient with a Curve that starts and ends at the same value.

Performance

Very cheap: one quick step on the GPU.

For AI agents

  • Type name: AngularGradientNode. Output slot 100 (Mask). No inputs.
  • Properties: startPoint, endPoint ([x, z], 0 to 1 biome space, or world meters when useWorldPosition is true), useWorldPosition (bool).
  • Value = 1 - angle / 2π, the angle measured from the start→end direction; exactly 0 at the start point itself.