HandGrabInteractor Class

Returns the fingers that are grabbing the interactable.

( HandGrabInteractable interactable )

( HandGrabInteractable interactable,

bool allowManualRelease )

Forces the interactor to select the passed interactable, which will be grabbed in the next interaction iteration.

Forces the interactor to deselect the currently grabbed interactable (if any).

( Func< HandGrabInteractable > computeCandidate,

bool shouldClearOverrideOnSelect )

( HandGrabAPI handGrabApi,

Transform grabOrigin,

IHand hand,

Rigidbody rigidbody,

GrabTypeFlags supportedGrabTypes )

Adds everything contained in <cref="HandGrabInteractor"/> to a dynamically instantiated GameObject.

( HandGrabAPI handGrabAPI )

Adds a <cref="HandGrabAPI" /> to a dynamically instantiated GameObject.

( IHand hand )

Adds a <cref="IHand" /> to a dynamically instantiated GameObject.

( Rigidbody rigidbody )

Adds a Rigidbody to a dynamically instantiated GameObject.

( GrabTypeFlags supportedGrabTypes )

Adds a list of <cref="GrabTypeFlags" /> to a dynamically instantiated GameObject.

( Transform grabOrigin )

Adds a grab origin to a dynamically instantiated GameObject.

( Transform gripPoint )

Adds a grip point to a dynamically instantiated GameObject.

( SphereCollider gripCollider )

Adds a grip collider to a dynamically instantiated GameObject.

( Transform pinchPoint )

Adds a pinch point to a dynamically instantiated GameObject.

( SphereCollider pinchCollider )

Adds a pinch collider to a dynamically instantiated GameObject.

( IThrowVelocityCalculator velocityCalculator )

Adds a velocity calculator to a dynamically instantiated GameObject.

Each call while the interactor is hovering, it checks whether there is an interaction being hovered and sets the target snap pose to it.

( HandGrabInteractable interactable )

( HandGrabInteractable interactable )

Each call while the hand is selecting/grabbing an interactable, it moves the item to the new position while also attracting it towards the hand if the snapping mode requires it.

( HandGrabInteractable interactable )

When a new interactable is selected, start the grab at the ideal point.

( HandGrabInteractable interactable )

When releasing an active interactable, calculate the releasing point in similar fashion to InteractableSelected.

( PointerEvent evt )

Compute the best interactable to snap to.

Returns the fingers that are grabbing the interactable.

Forces the interactor to select the passed interactable, which will be grabbed in the next interaction iteration.

Forces the interactor to deselect the currently grabbed interactable (if any).

Adds everything contained in <cref="HandGrabInteractor"/> to a dynamically instantiated GameObject.

Adds a <cref="HandGrabAPI" /> to a dynamically instantiated GameObject.

Adds a <cref="IHand" /> to a dynamically instantiated GameObject.

Adds a Rigidbody to a dynamically instantiated GameObject.

Adds a list of <cref="GrabTypeFlags" /> to a dynamically instantiated GameObject.

Adds a grab origin to a dynamically instantiated GameObject.

Adds a grip point to a dynamically instantiated GameObject.

Adds a grip collider to a dynamically instantiated GameObject.

Adds a pinch point to a dynamically instantiated GameObject.

Adds a pinch collider to a dynamically instantiated GameObject.

Adds a velocity calculator to a dynamically instantiated GameObject.

Each call while the interactor is hovering, it checks whether there is an interaction being hovered and sets the target snap pose to it.

In the HandToObject snapping behaviors this is relevant as the hand can approach the object progressively even before a true grab starts.

Each call while the hand is selecting/grabbing an interactable, it moves the item to the new position while also attracting it towards the hand if the snapping mode requires it.

In some cases the parameter can be null, for example if the selection was interrupted by another hand grabbing the object. In those cases it will come out of the release state once the grabbing gesture properly finishes.

When a new interactable is selected, start the grab at the ideal point.

When snapping is involved that can be a point in the interactable offset from the hand which will be stored to progressively reduced it in the next updates, effectively attracting the object towards the hand. When no snapping is involved the point will be the grip point of the hand directly. Note: ideally this code would be in InteractableSelected but it needs to be called before the object is marked as active.

When releasing an active interactable, calculate the releasing point in similar fashion to InteractableSelected.

Compute the best interactable to snap to.

In order to do it the method measures the score from the current grip pose to the closes pose in the surfaces of each one of the interactables in the registry. Even though it returns the best interactable, it also saves the entire Snap pose to it in which the exact pose within the surface is already recorded to avoid recalculations within the same frame.