VFX Loom VFX Loom Discord (opens in a new tab) Buy $20 VFX Loom
Documentation

Documentation

Mapping

VFX Loom 1.0 reference for the Mapping node.

Transform transform.mapping
The Mapping node on the VFX Loom graph canvas.
Fig. 1 The Mapping node in its resting, collapsed state on the VFX Loom graph canvas.

Overview

Transforms procedural coordinates before a generator samples them.

Lazy coordinate transform; no image allocation. Connected transform inputs override their corresponding local parameters.

Category
Transform
Internal ID
transform.mapping
Version
VFX Loom 1.0

Inputs

InputTypeRequiredDefaultMeaning
in Field Optional — defaults to UV
translation Vector2 Optional (0,0) connected value overrides local Translation
rotation Scalar Optional 0 degrees around UV center
scale Vector2 Optional (1,1) scale around UV center

Properties

PropertyTypeDefaultAnimatableRange / optionsEffect
Translation Vector2 (0,0) Yes — Animatable control; changing it over time varies the node response.
Rotation Scalar 0 degrees Yes Hard -360..360 · UI range: soft Animatable control; changing it over time varies the node response.
Scale Vector2 (1,1) Yes — Animatable control; changing it over time varies the node response.

Outputs

OutputTypeMeaning
out Field The production node output described by the overview.

Usage

In practice

  • Use Mapping when the graph needs Transforms procedural coordinates before a generator samples them.
  • Lazy coordinate transform; no image allocation. Connected transform inputs override their corresponding local parameters.
  • Use it where the graph needs coordinate or image-space movement; keep sampling and edge policy aligned with the source artwork.

Examples

These examples show Mapping 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 / Warp / Glow with a moving wave branch

Two branches meet at Mask: a Shape branch is warped, outlined, and bloomed, while Time drives Motion → Mapping → Wave Texture → Transform to create a moving secondary field.

ShapeWarpOutlineGlow / BloomMask
TimeMotionMappingWave TextureTransformMask
VFX Loom graph showing Shape, Warp, Outline, Glow / Bloom, Time, Motion, Mapping, Wave Texture, Transform, and Mask connected around a white striped preview.
Fig. 2The two-branch mask setup in the graph canvas, shown at a single flipbook frame.
Fig. 3The same setup running: the Time-driven branch advances through the flipbook while the graph remains unchanged.

How Mapping contributes

Mapping applies the Motion displacement to the procedural coordinates before Wave Texture samples them.

Notes / limitations

  • No component bounds or step is declared for Translation or Scale.
  • Coordinate Provides procedural coordinate spaces.
  • Motion Builds a Vector2 displacement from time, direction and speed.
  • Noise Tileable fractal noise. Seamless across the tile edges.