Spatial & Motion
Spatial & Motion operators drive the movement, rotation, alignment, and hierarchical visibility of 3D objects in the scene space.
Auto Rotate Operator for Continuous 3D Spin#
1. Functional Overview
The Auto Rotate operator manages constant rotational loops. It applies continuous, frame-rate-independent angular changes to a target object. Users configure rotation speed on X, Y, or Z axes independently to drive spinning showcases or orbiting assets.
Auto Rotate
AUTO_ROTATEDATA_ROTATIONALAuto Rotate Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
speedX: float | Speed (X) | FLOATRANGE SLIDER | 0 |
speedY: float | Speed (Y) | FLOATRANGE SLIDER | 0.2 |
speedZ: float | Speed (Z) | FLOATRANGE SLIDER | 0 |
rotationDirectionControl: "Reverse X" | "Reverse Y" | "Reverse Z" | rotationDirectionControl | ENUMDROPDOWN | [] |
dynamicSpeed: boolean | Dynamic Speed | BOOLTOGGLE | false |
amplitude: float | Amplitude | FLOATRANGE SLIDER | 0.15 |
frequency: float | Frequency | FLOATRANGE SLIDER | 0.1 |
limitRotation: boolean | Limit Rotation | BOOLTOGGLE | false |
rotationRangeX: [number, number] | Range (X) | RANGERANGE SLIDER | [0, 360] |
rotationRangeY: [number, number] | Range (Y) | RANGERANGE SLIDER | [0, 360] |
rotationRangeZ: [number, number] | Range (Z) | RANGERANGE SLIDER | [0, 360] |
rotationBehavior: "Ping-Pong" | "Loop" | Rotation Behavior | ENUMDROPDOWN | "Ping-Pong" |
easingFunction: "LINEAR" | "EASE_IN" | "EASE_OUT" | "EASE_IN_OUT" | Easing Function | ENUMDROPDOWN | "EASE_IN_OUT" |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Bounds Operator for 3D Dimensions & Overlaps#
1. Functional Overview
The Bounds operator computes coordinate bounds. It processes the active dimensions of target 3D meshes, outputting their precise X/Y/Z bounding sizes, and monitors collision coordinate gates to trigger outputs when objects intersect.
Bounds
BOUNDSDATA_NUMBERBounds Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
unitIds: any | Units | STRING_ARRAYUNIT SELECTOR | [] |
padding: float | Padding | FLOATRANGE SLIDER | 0 |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
bottom: AirEvent<void> | Bottom | OPERATOR | OPERATOR |
top: AirEvent<void> | Top | OPERATOR | OPERATOR |
left: AirEvent<void> | Left | OPERATOR | OPERATOR |
right: AirEvent<void> | Right | OPERATOR | OPERATOR |
front: AirEvent<void> | Front | OPERATOR | OPERATOR |
back: AirEvent<void> | Back | OPERATOR | OPERATOR |
Child Visibility Operator for Object Hierarchies#
1. Functional Overview
The Child Visibility Manager toggles sub-components within composite assemblies. By targeting a parent node, the operator can search, show, or hide specific child nodes, or cycle through children sequentially, making it ideal for step-by-step assemblies.
Child Visibility Manager
CHILD_VISIBILITYGENERAL_ALLChild Visibility Manager Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
targetUnitIds: any | Target Parent Unit | STRING_ARRAYUNIT SELECTOR | [] |
startIndex: float | Start Index | FLOATTEXT INPUT | 0 |
loop: boolean | Loop Navigation | BOOLTOGGLE | false |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
next: (payload: float) => void | Next | DATA_FLOAT | AIR_PROPERTY |
previous: (payload: float) => void | Previous | DATA_FLOAT | AIR_PROPERTY |
setIndex: (payload: float) => void | Set Index | DATA_FLOAT | AIR_PROPERTY |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
onFirst: AirEvent<void> | On First | OPERATOR | OPERATOR |
onLast: AirEvent<void> | On Last | OPERATOR | OPERATOR |
onNotFirst: AirEvent<void> | On Not First | OPERATOR | OPERATOR |
onNotLast: AirEvent<void> | On Not Last | OPERATOR | OPERATOR |
currentIndex: AirEvent<float> | Current Index | DATA_FLOAT | AIR_PROPERTY |
Follow Operator for Pointer & Entity Tracking#
1. Functional Overview
The Follow operator animates movement tracking paths in 3D scene space. It configures a source object to follow either the pointer viewport coordinates or another specific scene entity's mesh transform. Motion dynamics are customized via the speed property, smoothing friction ranges, and configurable mathematical easing curves (easingFunction).
Follow
FOLLOWDATA_VECTOR3Follow Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
followTargetType: "Mouse" | "Object" | Follow Target | ENUMOPTION SELECTOR | "Mouse" |
targetUnitId: any | Target Object | STRING_ARRAYUNIT SELECTOR | [] |
followRotation: boolean | Follow Rotation | BOOLTOGGLE | false |
speed: float | Movement Speed | FLOATRANGE SLIDER | 1 |
delay: float | Delay (seconds) | FLOATRANGE SLIDER | 0 |
easingFunction: "LINEAR" | "EASE_IN" | "EASE_OUT" | "EASE_IN_OUT" | Easing Function | ENUMDROPDOWN | "LINEAR" |
smoothing: float | Smoothing | FLOATRANGE SLIDER | 0.25 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Look At Operator for Camera & Object Targeting#
1. Functional Overview
The Look At operator applies aim constraints on 3D objects. It computes real-time rotational coordinates required to align a mesh's forward axis toward a designated target or the viewer's camera, with options to limit rotation to specific coordinate planes (e.g. Y-axis only).
Look At
LOOK_ATDATA_ROTATIONALLook At Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
lookAtTargetType: "MOUSE" | "OBJECT" | Look at target | ENUMOPTION SELECTOR | "MOUSE" |
lookAtTargetUnitId: any | Target Object | STRING_ARRAYUNIT SELECTOR | [] |
smoothing: float | Smoothness | FLOATRANGE SLIDER | 0.5 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Orbit Operator for Circular Path Rotations#
1. Functional Overview
The Orbit operator drives turntable and orbital movement loops. By referencing a central anchor scene object, the operator rotates the target body in a circular trajectory. Radial offset distances, height offsets, and rotational speed bounds are fully customized through inspector attributes.
Orbit
ORBITDATA_VECTOR3Orbit Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
tilt: float | Tilt | FLOATRANGE SLIDER | 0 |
orbitSpeed: float | Speed | FLOATRANGE SLIDER | 0.15 |
orbitRadius: float | Radius | FLOATRANGE SLIDER | 0.2 |
limitOrbit: boolean | Limit Orbit | BOOLTOGGLE | false |
orbitRange: [number, number] | Orbit Range | RANGERANGE SLIDER | [0, 360] |
orbitBehavior: "Ping-Pong" | "Loop" | Orbit Behavior | ENUMDROPDOWN | "Ping-Pong" |
easingFunction: "LINEAR" | "EASE_IN" | "EASE_OUT" | "EASE_IN_OUT" | Easing Function | ENUMDROPDOWN | "EASE_IN_OUT" |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Pointer Rotate Operator for Drag Gestures#
1. Functional Overview
The Pointer Rotate operator enables mouse interaction. When a user clicks and drags a mesh inside the viewport, the operator translates mouse coordinates into 3D rotational offsets. Friction settings (damping) can be adjusted to enable smooth spin inertia.
Pointer Rotate
POINTER_ROTATEDATA_ROTATIONALPointer Rotate Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
mix: float | Output Mix | FLOATRANGE SLIDER | 1 |
smoothness: float | Smoothness | FLOATRANGE SLIDER | 0.25 |
deceleration: float | Deceleration | FLOATRANGE SLIDER | 0.25 |
verticalSpeed: float | Vertical Speed | FLOATRANGE SLIDER | 0.5 |
horizontalSpeed: float | Horizontal Speed | FLOATRANGE SLIDER | 0.5 |
axisLock: "Lock X" | "Lock Y" | Axis Lock | ENUMDROPDOWN | [] |
invertAxes: "Invert X" | "Invert Y" | Invert Axes | ENUMDROPDOWN | [] |
pointerInteractionMode: "PointerDown" | "PointerMove" | Pointer Interaction Mode | ENUMDROPDOWN | "PointerDown" |
resetTransitionTime: float | Reset Transition Time (sec) | FLOATRANGE SLIDER | 1 |
resetOnInactivity: boolean | Reset Rotation On Inactivity | BOOLTOGGLE | false |
inactivityTimeout: float | Inactivity Timeout (sec) | FLOATRANGE SLIDER | 5 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
reset: () => void | Reset | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Proximity Operator for Distance Thresholds#
1. Functional Overview
The Proximity operator monitors user proximity. It computes distances between the user's viewport camera and a 3D target. When this distance falls below a defined threshold (triggerDistance), it fires the Near trigger, and fires the Far trigger when the user moves away.
Proximity
PROXIMITYGENERAL_TRIGGERSProximity Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
useViewerPosition: boolean | Use Viewer Position | BOOLTOGGLE | true |
distanceFromTargetUnitIds: any | Distance From | STRING_ARRAYUNIT SELECTOR | [] |
distanceToTargetUnitIds: any | Distance To | STRING_ARRAYUNIT SELECTOR | [] |
distance: float | Distance | FLOATTEXT INPUT | 0 |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
onEnter: AirEvent<void> | On Enter | OPERATOR | OPERATOR |
onExit: AirEvent<void> | On Exit | OPERATOR | OPERATOR |
Vector 3 Rotation Operator for Euler Angles#
1. Functional Overview
The Vector 3 Rotation operator formats rotational inputs. It handles standard conversions between separate Pitch/Yaw/Roll floating degree parameters and structured rotational vectors, ensuring alignment commands are resolved correctly by 3D rendering engines.
Vector 3
ROTATION_VECTOR3DATA_ROTATIONALVector 3 Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
inputQuat: IQuaternion | Input Rotation | ROTATIONAL_SYSTEMVECTOR MULTI INPUT | {x: 0, y: 0, z: 0, w: 1} |
x: float | x | FLOATTEXT INPUT | 0 |
y: float | y | FLOATTEXT INPUT | 0 |
z: float | z | FLOATTEXT INPUT | 0 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Vector3 Operator for Coordinate Compositions#
1. Functional Overview
The Vector3 operator bridges individual float properties with multi-dimensional 3D vector variables. It exposes separate inline input controls for x, y, and z configuration fields, combining them into a unified position/scale coordinate that is dispatched from its Output Value @Output, or conversely decomposes incoming vector streams into float channels.
Vector3
VECTOR3DATA_VECTOR3Vector3 Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
inputVector: IVector3 | Input Vector3 | VECTOR3VECTOR MULTI INPUT | {x: 0, y: 0, z: 0} |
x: float | x | FLOATTEXT INPUT | 0 |
y: float | y | FLOATTEXT INPUT | 0 |
z: float | z | FLOATTEXT INPUT | 0 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<any> | Output Value | DATA_VECTOR3 | AIR_PROPERTY |