Defines an IInteractor which performs locomotion turns (i.e., rotating the user in virtual space) based on input from a pair of Unity Transforms, which typically are independently positioned in the scene based on hand or body tracking.

There is no real interactable for this interactor (LocomotionTurnerInteractable is an empty type, as described in the comments on that class).

For the controller-driven counterpart to this type, see LocomotionAxisTurnerInteractor.

Fields

ITrackingToWorldTransformer Transformer[Get]

ITrackingToWorldTransformer for moving spatial data between world space and tracking space.

This is required so that turning calculations can be performed in tracking space.

Pose MidPoint[Get]

Center point where the Axis value is 0.

This point is set at the start of interaction and moved based on user movement (for example, if the user moves Origin further than DragThresold from the MidPoint.

Pose Origin[Get]

Point of the actual origin in world space.

The offset from Origin to MidPoint indicates the Axis value. This point is articulated independently of the interactor, but it typically represents user motion (for example, a hand's position in space).

override bool ShouldHover[Get]

Implementation of IInteractor.ShouldHover; for details, please refer to the related documentation provided for that interface.

override bool ShouldUnhover[Get]

Implementation of IInteractor.ShouldUnhover; for details, please refer to the related documentation provided for that interface.

Properties

float DragThresold[Get]

Offset from MidPoint at which the pointer will be dragged.

The MidPoint of the turner interactor implies a "reset distance" on turn direction choice, and dragging it making it easier to choose the other direction to turn. For example, if the user begins interacting by moving their hand fifteen centimeters to the left, that will select "left" as the turn direction. Then, if the user wishes to change direction an turn right, without dragging the user will have to move more than fifteen centimeters to the right. However, if DragThreshold was 0.05 (or any number smaller than 0.15), then the user would only have to move right by that amount to change direction because the MidPoint would have been dragged after left movement exceeded the threshold.

Action< float > WhenTurnDirectionChanged

Event broadcast to indicate that the axis has changed sign (i.e., the user has switched from turning left to turning right, or vice versa).

For more information, see the remarks on Value.

Protected Functions

virtual override void Awake ( )

virtual override void Start ( )

virtual override void HandleEnabled ( )

virtual override void DoHoverUpdate ( )

virtual override void DoSelectUpdate ( )

virtual override LocomotionTurnerInteractable ComputeCandidate ( )

Member Functions

float Value ( )

Axis value of the interactor, between -1 and 1 where a negative number indicates a `left turn and a positive value a right turn.

"Axis" in this context refers to an underlying conceptual IAxis1D analogous to the IAxis2D used by LocomotionAxisTurnerInteractor. While there is no actual underlying axis for LocomotionTurnerInteractors, axis-like values are calculated from the Unity transforms the interactor observes, and those values are used to make interaction decisions.

Returns

A value between -1 and 1

void InjectAllLocomotionTurnerInteractor

( Transform origin,

ISelector selector,

Transform stabilizationPoint,

ITrackingToWorldTransformer transformer )

Injects all required dependencies for a dynamically instantiated LocomotionTurnerInteractor; effectively wraps InjectOrigin(Transform), InjectSelector(ISelector), InjectStabilizationPoint(Transform), and InjectTransformer(ITrackingToWorldTransformer).