Transform3D

Category: Executor Tier: Plus

Purpose

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

Visual Reference

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.

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