Meta Developers

ITrackingToWorldTransformer Interface

Indicates that a type provides a mechanism for transforming transforms (i.e., position and orientation data) from tracking space to world space.

"Tracking space" is the coordinate space in which the underlying system tracks user movements, the environment, etc. "World space" is a simple characterization of the coordinate space in which game logic transpires. In order to translate real-world tracking data to virtual-world interactions, game logic needs to transform system observations in tracking space into game movements in world space; for example, if the user moves their hand by half a meter in the real world, but the game considers the user to currently be ten times their real size, the Hand in game needs to move by 5 meters instead of half a meter. Types such as Hand and Controller, which are responsible for this translation step, use ITrackingToWorldTransformers to make the required space conversions.

Properties

Transform Transform[Get]

The underlying transform of the tracking space; this can be used directly as an alternative to ToWorldPose(Pose) and ToTrackingPose(in Pose).

Quaternion WorldToTrackingWristJointFixup[Get]

This is an internal and legacy capability which should not be needed in new usage.

It is used specifically to address problems with wrist data from certain tracking solutions; if this field is not identity, its value can be applied to wrist data to rectify orientation problems.

Member Functions

Pose ToWorldPose

( Pose poseRh )

Converts a tracking space pose to a pose in in Unity's world coordinate space (i.e.

teleportation applied). This is a convenience method for manipulating Pose types directly; for vector and quaternion types, equivalent behavior can be achieved by directly invoking the various Transform methods on the Transform.

Pose ToTrackingPose

( in Pose worldPose )

Converts a world space pose in Unity's coordinate space to a pose in tracking space (i.e.

no teleportation applied). This is a convenience method for manipulating Pose types directly; for vector and quaternion types, equivalent behavior can be achieved by directly invoking the various InverseTransform methods on the Transform.

Did you find this page helpful?