Develop

Interaction Types

Updated: Sep 4, 2026

IWSDK exposes three grab components. Each component produces a different handle configuration and pointer-event policy.

One-hand grabbing

OneHandGrabbable uses one direct input. It supports translation and rotation but not scale.

entity.addComponent(OneHandGrabbable, {
  rotate: true,
  translate: true,
  rotateMin: [-Math.PI / 4, -Math.PI, -Math.PI / 4],
  rotateMax: [Math.PI / 4, Math.PI, Math.PI / 4],
});

The generated handle uses multitouch: false and denies ray pointer events for the handle’s lifetime, from component initialization until the grab component is removed.

Use it for tools, controls, and objects whose scale must remain unchanged.

Two-hand grabbing

TwoHandsGrabbable supports translation, rotation, and scale from two direct inputs.

entity.addComponent(TwoHandsGrabbable, {
  rotate: true,
  translate: true,
  scale: true,
  scaleMin: [0.5, 0.5, 0.5],
  scaleMax: [2, 2, 2],
});

The generated handle uses multitouch: true and denies ray pointer events. Use it when an object needs two-input positioning or resizing.

Distance grabbing

DistanceGrabbable accepts ray input and denies grab-pointer events. Its four movement modes are:

MovementMode.MoveFromTarget;
MovementMode.MoveTowardsTarget;
MovementMode.MoveAtSource;
MovementMode.RotateAtSource;

MoveFromTarget uses projected-ray handle movement.

MoveTowardsTarget interpolates toward the pointer origin plus configured position and quaternion offsets.

MoveAtSource applies the pointer origin’s frame-to-frame delta.

RotateAtSource rotates the object without translation or scale.

The current MoveTowardsTarget implementation uses time-scaled interpolation and snaps within 0.005 world units. Configure its speed with moveSpeedFactor.

entity.addComponent(DistanceGrabbable, {
  movementMode: MovementMode.MoveTowardsTarget,
  moveSpeedFactor: 0.15,
  targetPositionOffset: [0, 0, -0.25],
});

See Distance grabbing for offsets, constraints, and return-to-origin behavior.