Table of Contents

Transform 2D Node

  • Category: General
  • Edition: All editions
  • Output type: Mask or Color, chosen with Slot Type
  • Typical place in a graph: after a mask, height or image that should be moved, turned, scaled or tiled

Transform 2D moves, rotates and scales a mask or image across the biome, around its middle, and can repeat it to fill the gaps. Use it to turn a pattern to a new angle, shrink a loaded height map into part of the biome, or tile a small pattern.

A noise turned 30 degrees and shrunk to half size, tiled to fill the biome

When to use it

  • Turn a directional pattern, such as dunes or ridges, to the wind direction you want.
  • Place a loaded height map or stamp in part of the biome.
  • Repeat a small pattern across the biome.
  • Not for: moving positions (use Transform Points); bending a shape (use Angular Warp or Directional Warp).

Inputs

Slot Type Required What to connect
Input Mask or Color Yes The mask, height or color image to transform.

Outputs

Slot Type What it holds
Output Same as the input The transformed result.

Properties

Property Default Range What it does
Slot Type Mask Slot Mask Slot, Color Texture Slot The kind of data.
Tiling Mode Tile XY None, Tile X, Tile Y, Tile XY Where the moved or shrunk image leaves gaps: repeat it along X, Z, both, or leave the gaps to Background Color.
Offset 0, 0 Percent of the biome size Moves the image along X and Z.
Rotation 0 Degrees Turns the image around the middle of the biome.
Scale 100, 100 Percent Resizes the image around the middle. 50 makes it half size.
Background Color Black A color Fills the gaps where the image is not tiled. For masks, its red value is used: black is 0.

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. Relative To Main Input (default) matches the input, times the multiplier below it. Relative To Graph follows the biome's Canvas Resolution instead. Absolute sets an exact size. 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. The input passes through unchanged.

Examples

A Noise (Scale 300) on a 1024 × 1024 m biome.

Input Rotation 30, Scale 50, Tile XY Same, Tiling Mode None
The original noise The noise at half size, turned, repeated with visible seams One turned, half size copy in the middle on black

Tiling a pattern that does not tile on its own shows hard seams between the copies. Without tiling, a single copy sits in the middle and the rest is Background Color.

Recipes

  • Dunes from the west: a stretched Noise → Transform 2D (Rotation to the wind direction) → height.
  • Height map in one corner: Load Texture R → Transform 2D (Scale 50, Offset, Tiling Mode None) → Combine with the base.
Warning

Tiling repeats the edges as they are. Unless the source tiles seamlessly, the copies meet at hard lines that show on the terrain.

Note

Scaling up enlarges texels too: a 1024 texel noise at 200% shows 512 texels across the biome and looks softer.

Performance

Very cheap: one quick GPU step.

For AI agents

  • Type name: Transform2dNode. Input = 0, Output = 100, typed by the slot type (MaskSlot or ColorTextureSlot; editor only).
  • Properties: tilingMode (None, TileX, TileY, TileXY), offset (Vector2, percent), rotation (degrees), scale (Vector2, percent), backgroundColor.
  • Measured, Noise mean 0.374: Rotation 30 + Scale 50 tiled kept mean 0.377; untiled mean 0.094 (one centered copy on black).