Skip to main content

Class: ThreeTransformPort

Defined in: threejs-interactions/src/transform-port.ts:20

The transform/effect surface of ONE interactable's scene object. Behaviours write through this; the adapter owns how writes land (Object3D fields, ECS components, …).

Offsets/rotations are FROM REST: the adapter captures the rest pose at registration and applies these relative to it, so behaviours compose with anything else animating the same object (the pale-signal non-destructive-offset rule).

Implements​

Constructors​

Constructor​

new ThreeTransformPort(object: Object3D): ThreeTransformPort;

Defined in: threejs-interactions/src/transform-port.ts:33

Parameters​

ParameterType
objectObject3D

Returns​

ThreeTransformPort

Methods​

getLocalOffset()​

getLocalOffset(): Vec3Tuple;

Defined in: threejs-interactions/src/transform-port.ts:61

Local-space pose relative to the captured rest (dragged observation).

Returns​

Vec3Tuple

Implementation of​

TransformPort.getLocalOffset


getWorldPose()​

getWorldPose(): PoseTuple;

Defined in: threejs-interactions/src/transform-port.ts:44

Current world pose.

Returns​

PoseTuple

Implementation of​

TransformPort.getWorldPose


recaptureRest()​

recaptureRest(): void;

Defined in: threejs-interactions/src/transform-port.ts:38

Returns​

void


setEffect()​

setEffect(effect: {
emissive?: number;
scale?: number;
}): void;

Defined in: threejs-interactions/src/transform-port.ts:93

Additive presentation effect (pulse): scale multiplier & emissive boost.

Parameters​

ParameterType
effect{ emissive?: number; scale?: number; }
effect.emissive?number
effect.scale?number

Returns​

void

Implementation of​

TransformPort.setEffect


setLocalOffset()​

setLocalOffset(offset: Vec3Tuple): void;

Defined in: threejs-interactions/src/transform-port.ts:68

Additive local-space offset from rest (driven press / slide).

Parameters​

ParameterType
offsetVec3Tuple

Returns​

void

Implementation of​

TransformPort.setLocalOffset


setLocalRotation()​

setLocalRotation(quaternion: QuatTuple): void;

Defined in: threejs-interactions/src/transform-port.ts:73

Local rotation about the rest orientation (hinge / dial output).

Parameters​

ParameterType
quaternionQuatTuple

Returns​

void

Implementation of​

TransformPort.setLocalRotation


setWorldPose()​

setWorldPose(pose: PoseTuple): void;

Defined in: threejs-interactions/src/transform-port.ts:78

Follow a world pose while grabbed (poseOnly grab fulfilment).

Parameters​

ParameterType
posePoseTuple

Returns​

void

Implementation of​

TransformPort.setWorldPose