Skip to main content

​
Overview

The Transform Object action changes an object’s position, rotation, or scale. Use Snap to apply a transformation instantly or Linear Interpolation to animate it over a specified duration. Use it to slide drawers, rotate valves, resize objects, or position components during training.

​
Parameters

Expand Transform to edit Position, Rotation, and Scale. Clearing one of these numeric fields restores its previous value when you leave the field. Use Edit in Scene to position the target and shape its path. When path data is available, Animation Path displays the Spline Path Control Points for review.

​
Key Behavior

  • Destination coordinates: Position specifies where the object should end up in the selected coordinate system. The distance it moves depends on its starting position.
  • Final rotation and scale: The amount of rotation or resizing depends on the starting values. For example, changing scale from (1, 1, 1) to (3, 3, 3) triples the size in the same coordinate system.
  • Snap mode: The transform completes instantly. The object jumps to the new position/rotation/scale.
  • Linear Interpolation mode: The transform animates from the current state to the target state over the specified duration.
  • Simultaneous changes: You can move, rotate, and scale an object in a single action.
  • Wait Until Complete: Enable this setting when the next action depends on the transformation finishing. Leave it unchecked when subsequent actions should run while the object animates.
  • Spline paths: Select Linear Interpolation and enable Use Spline Path to use the authored path. The scene editor’s middle control points shape the preview curve. Snap applies the destination transform immediately.
  • Reparenting: With Reparent to Reference enabled, the transformed object becomes a child of the selected reference and follows its later movement. With it disabled, the object keeps its current parent.
Use Delay when you want an additional timed pause. For example, enable Wait Until Complete on the transformation, then add Delay before the next action to pause after the motion finishes.

​
Practical Examples

​
Sliding Drawer Animation

Scenario: A maintenance training shows a technician opening a panel drawer. In this example, the drawer starts at world position (1, 0, 0) and opens by moving 0.5 meters along the positive world X axis over 2 seconds.
1
State InspectPanel onEntry:
  1. Load Scene: maintenance_room
  2. Play Audio: “Slide the access panel drawer open”
2
Learner clicks “Open Drawer” button, triggering transition:
  1. Transform Object:
    • Target Object: panel_drawer
    • Reference Object: World (no reference)
    • Position: (1.5, 0, 0) — the destination in world coordinates
    • Transform Mode: Linear Interpolation
    • Duration (ms): 2000 (2 seconds)
    • Wait Until Complete: checked
  2. Play Audio: “The panel is now open. Inspect the components.”
3
The drawer moves from (1, 0, 0) to (1.5, 0, 0), sliding 0.5 meters along the world X axis. Once the movement finishes, narration guides the learner to inspect.

​
Instant Scale Change

Scenario: A tool starts with world scale (1, 1, 1). Selecting it changes its world scale to (3, 3, 3), making it three times its starting size.
1
Transition triggered by clicking a tool:
  • Transform Object:
    • Target Object: magnifying_glass
    • Reference Object: World (no reference)
    • Scale: (3, 3, 3)
    • Transform Mode: Snap
2
The tool instantly becomes larger, making details visible.

​
Rotating Valve Animation

Scenario: A valve starts with world rotation (0, 0, 0) and opens at (0, 90, 0). Animate the change over 1 second.
1
Learner clicks the valve, triggering transition:
  1. Transform Object:
    • Target Object: control_valve
    • Reference Object: World (no reference)
    • Rotation: (0, 90, 0) — the final world orientation in degrees
    • Transform Mode: Linear Interpolation
    • Duration (ms): 1000
    • Wait Until Complete: checked
  2. Play Audio: “The valve is now open.”
2
The valve rotates smoothly, then the audio confirms that it is open.

​
Curved Path Movement

Scenario: An assembly part needs an authored path from its starting position to an installation point.
1
Configure the action:
  • Transform Object:
    • Target Object: assembly_part
    • Transform Mode: Linear Interpolation
    • Duration (ms): 4000 (4 seconds)
    • Use Spline Path: checked
2
Open Edit in Scene. Select the part and destination reference object as prompted, then use the gizmo to adjust the destination position, rotation, and scale.
3
Drag the middle path handles to shape the preview curve. Click Finish to save the path. Review the saved control points under Animation Path and set Reparent to Reference according to whether the installed part should become a child of the reference object.
4
Preview the action and test playback in the Trainee App on the target device. Check the path, final placement, and duration before using it in the training.

​
Complex Multi-Transform

Scenario: A component starts at world position (0, 0, 0), rotation (0, 0, 0), and scale (1, 1, 1). Move it into place, change its orientation, and reduce its scale to 80% of its starting size in one action.
1
Transition triggered by learner action:
  • Transform Object:
    • Target Object: gasket_component
    • Reference Object: World (no reference)
    • Position: (1, 0.5, 0)
    • Rotation: (45, 0, 0)
    • Scale: (0.8, 0.8, 0.8)
    • Transform Mode: Linear Interpolation
    • Duration (ms): 2500 (2.5 seconds)
2
The position, rotation, and scale animate together toward the specified final values.

​
Undo/Reset Motion

Scenario: An object animates to a position. If the learner chooses “undo,” animate it back to the original position.
1
The original world position of lever is (0, 0, 0).
2
Action: Learner pulls lever → animate to (1, 0, 0) over 1 second.
3
If learner clicks “undo”:
  • Transform Object:
    • Target Object: lever
    • Reference Object: World (no reference)
    • Position: (0, 0, 0) — back to start
    • Transform Mode: Linear Interpolation
    • Duration (ms): 1000
4
The lever animates back to its original position.
Use Linear Interpolation and adjust Duration (ms) to suit the task. Preview the movement and test it on the device used by trainees.
If you transform a parent object while it has child objects, the children move and rotate with it. Be careful with parent-child hierarchies during complex animations.