--- generated_by: gdlink-build generated_at: 2026-06-23T12:34:28Z do_not_edit: true title: Transform2D brick_type: executor tier: Basic generated: true --- # Transform2D **Category:** Executor **Tier:** Basic ## Purpose A unified executor for manipulating a 2D object's position, rotation, and scale. ## Visual Reference ```{raw} html
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`. ... ```{raw} html
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 |