Transform2D

Category: Executor Tier: Basic

Purpose

A unified executor for manipulating a 2D object’s position, rotation, and scale.

Visual Reference

As added to your scene
Transform2D brick as it appears in the GDLink editor

Runtime Behavior

Inputs

  • Activate (Boolean): Triggers the transform operation.

Properties

Core Configuration

  • operation (Enum, Animate)

    • Set: Instantly snaps to target values.

    • Animate: Smoothly tweens to target values over duration.

    • Ping-Pong: Tweens to target, then returns to start.

  • space (Enum, Local)

    • Local: Relative to parent.

    • Global: Relative to world space for Node2D targets.

  • duration (Float, 0.5): Time in seconds for Animate / Ping-Pong.

  • tween_trans (Enum, Linear): Transition type.

  • tween_ease (Enum, InOut): Easing direction.

Transform Channels

  • Location

    • enable_loc (Bool, false): Modify location.

    • loc_mode (Enum, Relative): Relative or Absolute.

    • loc_axes (Enum, All): All, X, or Y.

    • target_loc (Vector2): Target position.

    • Teleport mapping:

      • Teleport / Snap = operation = Set, enable_loc = true, loc_mode = Absolute

      • space = Local teleports relative to the parent transform

      • space = Global teleports in world space for Node2D targets

  • Rotation

    • enable_rot (Bool, false): Modify rotation.

    • rot_mode (Enum, Relative): Relative or Absolute.

    • target_rot (Float): Target rotation in degrees.

    • rot_continuous (Bool, false): Continuous degrees-per-second rotation in Relative mode.

  • Scale

    • enable_scale (Bool, false): Modify scale.

    • scale_mode (Enum, Absolute): Relative or Absolute.

    • scale_axes (Enum, All): All, X, or Y.

Generated UI Mockup — showing expanded properties
Transform2D
-
x
Name:
Label this brick...
Mode:
Animate
Space:
Local
Target:X
0
v
Y
0
v
Scale:X
1
v
Y
1
v
Dur
0.5
v
Trans
Linear
Ease
InOut
Location
Mode
Relative
Axis
All
Rotation
Mode
Relative
Angle
0.0
v
Continuous
Scale
Mode
Relative
Axis
All

Properties

Property

Type

Default

Notes

Mode

option

Animate

How to apply transform changes (Animate/Ping-Pong require single-tick triggers)

Space

option

Local

Coordinate space

Dur

float

0.5

Animation duration in seconds (0.0 = instant)

Trans

option

Linear

Tween transition type

Ease

option

InOut

Easing direction

Location

bool

False

Enable Position control

Mode

option

Relative

Axis

option

All

Target

vector2

[0, 0]

Target position

Rotation

bool

False

Enable Rotation control

Mode

option

Relative

Angle

float

0.0

Target rotation (Degrees)

Continuous

bool

False

Spin continuously (Relative mode only)

Scale

bool

False

Enable Scale control

Mode

option

Relative

Axis

option

All

Scale

vector2

[1, 1]

Target scale