Table of Contents

Transform Points Node

  • Category: General
  • Edition: All editions
  • Output type: Positions
  • Typical place in a graph: after a set of positions, to move, turn or resize the whole set

Transform Points moves, rotates and scales a whole set of positions at once, around the middle of the biome. Use it to turn a grid of rows to a new angle, shift a pattern, or shrink a layout toward the center.

A grid rotated by 30 degrees around the middle of the biome

When to use it

  • Turn rows of an orchard, a vineyard or a planted forest to a chosen angle.
  • Move or resize a set of hand placed points.
  • Not for: moving each point by a different amount (use Offset).

Inputs

Slot Type Required What to connect
Input Positions Yes The points to transform.

Outputs

Slot Type What it holds
Output Positions The transformed points. Points moved outside the biome are kept in the list but skipped by output nodes.

Properties

Property Default Range What it does
Offset 0, 0 Percent of the biome size Moves the set along X and Z. 25 moves it a quarter of the biome.
Rotation 0 Degrees Turns the set around the middle of the biome.
Scale 100, 100 Percent Resizes the set around the middle of the biome along X and Z. 50 halves the distances.

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.
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. The positions pass through unchanged.

Examples

A Points grid (100 m) on a 1024 × 1024 m biome, shown through Dots and Expand.

Rotation 30 Scale 50, 50 Offset 25, 0
The grid turned 30 degrees, with empty corners A smaller, denser grid filling the upper right three quarters The grid shifted right, an empty strip on the left

Rotating a grid that only covers the biome leaves empty corners. Scaling to 50 pulls points from outside the biome into view: Points makes extra points past the biome's far edges, so the shrunk grid fills from a quarter of the way in to the far edges, not just the middle. Moving by 25 leaves an empty strip where the set used to start.

Recipes

  • Diagonal orchard: Points (Spacing 8, 12) → Transform Points (Rotation 35) → Thin Out with the orchard area → Tree Output.
Warning

Rotating or shrinking leaves gaps at the biome's edges, and shrinking a Points grid brings in its extra points from past the far edges. Start from a smaller Spacing or a larger area, and cut the result to where you want it with Thin Out.

Performance

Very cheap: one quick GPU step.

For AI agents

  • Type name: TransformPointsNode. Input = 0, Output = 100 (Buffers).
  • Properties: offset (Vector2, percent), rotation (degrees), scale (Vector2, percent, 100 = unchanged).
  • Matrix: translate(-0.5) then TRS(offset / 100, rotation about Y, scale / 100) then translate(+0.5), in biome UV space.
  • Points pads its grid past the far edges (multiple of 8 per axis), so scaling below 100 brings padding points inside the biome (measured: Scale 50 filled 0.25 to 1 on both axes).