UV Mapper

A node that draws a single input texture into multiple rectangular regions at once, specified by the Rect inputs. It is the element for building an output surface for mapping, and the basic usage is to receive the Rect outputs of UV Generator. The output is cleared to black and redrawn every frame.

Rect inputs

The + / - buttons add and remove Rect input ports (1–16; it cannot go below 1). The port names are Rect0, Rect1, … (the PortIDs are rect_0, rect_1, …), and even when unconnected you can type directly into the X/Y/W/H fields on the port. The default when unconnected is (0, 0, 1, 1), the full area.

Fit Mode

• Stretch (default) — stretches to fill the Rect

• Fill — crops the source-side UV so that it covers the Rect (aspect ratio preserved)

• Fit — shrinks the destination rectangle so that it fits inside the Rect (aspect ratio preserved, with margins)

• Crop — uses only the range specified by Crop UV. The Crop UV field is shown only in this mode (default (0, 0, 1, 1))

• Offset — added to the source UV’s X/Y. Default (0, 0)

• Output — the output resolution. Default 1920×1080. Changing it rebuilds the RT and notifies downstream of the new reference

Chase

When there are two or more Rects, Chase Offset and Chase Width let you switch which Rect is drawn in sequence. Each Rect’s position is index / Rect count, and once its distance from Offset (wrapping within 0–1) exceeds Chase Width / 2 / Rect count, its opacity becomes 0.

• Chase Offset — wrapped into 0–1 with Repeat(v, 1). Default 0 (Chase Offset input / chaseOffsetInput / chaseOffset)
• Chase Width — minimum 0.01. Default 1 (Chase Width input / chaseWidthInput / chaseWidth)

Chase has no effect when there is only one Rect (the opacity is always 1).

Rects with an opacity of 0.001 or less are skipped entirely when drawing.

When Layer Texture is not connected, the output stays black.

await synapse.modules.create({ type: "UVMapper" })