--- generated_by: gdlink-build generated_at: 2026-06-23T12:34:28Z do_not_edit: true title: Transform3D brick_type: executor tier: Plus generated: true --- # Transform3D **Category:** Executor **Tier:** Plus ## Purpose A unified executor for manipulating a 3D object's position, rotation, and scale. ## Visual Reference ```{raw} html
As added to your scene
Transform3D 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. - **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`, `Y`, `Z`, `X,Y`, `X,Z`, `Y,Z`. - `target_loc` (Vector3): 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 - **Rotation** - `enable_rot` (Bool, `false`): Modify rotation. - `rot_mode` (Enum, `Relative`): `Relative` or `Absolute`. - `rot_axes` (Enum, `All`): `All`, `X`, `Y`, `Z`, `X,Y`, `X,Z`, `Y,Z`. - `target_rot` (Vector3): 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`. ... ```{raw} html
Generated UI Mockup — showing expanded properties
Transform3D
-
x
Name:
Label this brick...
Mode:
Animate
Space:
Local
Target:X
0
v
Y
0
v
Z
0
v
Angles:X
0
v
Y
0
v
Z
0
v
Target:X
1
v
Y
1
v
Z
1
v
Dur
0.5
v
Trans
Linear
Ease
InOut
Location
Mode
Relative
Axis
All
Rotation
Mode
Relative
Axis
All
Scale
Mode
Relative
Axis
All
Continuous
``` ## Properties | Property | Type | Default | Notes | |---|---|---|---| | Mode | option | Animate | How to apply transform changes | | 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 | vector3 | [0, 0, 0] | Target position | | Rotation | bool | False | Enable Rotation control | | Mode | option | Relative | | | Axis | option | All | | | Angles | vector3 | [0, 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 | | | Target | vector3 | [1, 1, 1] | Target scale |