🧲Distance Grabbing

Distance Grabber

The Hand Distance Grabber is responsible for managing targeting and selecting objects with the Distance Grabbable Component.

Hands

Primary Hand is the hand component of the hand this is attached to
Secondary Hand is the hand component of the other hand this is attached to (if primary hand is right, this would be the left hand)

Pointing Options

Forward Pointer is a transform that represents the start point and forward direction of the pointer line
Line is the line renderer that will manage the visual properties of of the grab pointer line
Max Range will be the max distance in units that distance grabbing is possible
Layers represent the physics layers possible for distance grabbing, (for ease of use purposes) if set to nothing will default to “Grabbable” unless removed from the start function
Default Targeted Material will be used on only targeted distance grabbable if its distance grabbable targeted material is empty (Targeting is when the pointer is pointing at an object but not selecting)
Default Selected Material will be used on only selected distance grabbable if its distance grabbable targeted material is empty (Selecting is when the pointer is grabbing an object before the pull)

Pull Options

Distance grabber includes "Pull Options" which will allow you to choose how grabbing is triggered after "selection"

Use Instant Pull will instantly trigger pull on select
Use Flick Pull will require you quickly flick your hand back to pull after selecting a target
Distance Pull will be active if using neither use flick pull or use instant pull this will pull the selected target when moving your hand Pull Grab Distance units away from where the hand was during the selection point

Events

Distance Grabbable

In order to make an object distance grabbable, each Grabbable object will need a Distance Grabbable component. This component will control how an individual object is going to be distance grabbed.

In order to target and activate Distance Grabbables, you will need to use a Hand Distance Grabber which should be attached under your hand(s)/controller(s). (example can be found under the right hand in the demo scene)

This component will allow you to control how each distance grabbable is grabbed

Instant Pull will make the object instantly appear in your hand on Pull
Velocity Shoot options will control how an object will launch toward the hand when pulling it, (only possible if the instant pull is not active)