# Hand Projector ## Hand Projector Hand projection component will allow you to add a "soft grab" or "highlight grab" affect depending on the setup on the Hand Projector The Hand Projector goes on an empty copy of the hand with everything except the Hand component and models / visual components removed ### Soft Grab Setup To create a soft grab affect, you will enable the `Hide Hand` and add the mesh renderer for the main hand. This will make the main hand invisible when the hand projection is happening. You will also need to enable the `Use Grab Transition` value. This will use the Grip Axis value on the [Hand Controller Link](/auto-hand-docs/auto-hand/controller-input.md) to transition the hand between the root hands pose and the target grab pose when the grip axis is greater than 0
### Highlight Grab Setup Also described as "ghost hands" this setup configuration will create a copy of the hand that will show what pose the hand is going to take on grab while targeting a grab object. This hand should also have a custom material on the hand copy's mesh renderer to differentiate it as a highlight hand
## Settings `Hand` the main hand this projection is copying `Hand Projection` the empty hand copy this component should be attached to with just the hand, finger, rig, and mesh renderer components left `Hand Projection Visuals` the visual components of this hand projection copy, cannot be the object with this script on it, should be the object below the hand containing the rig and mesh renderer `Speed` is the rate at which the hand projection moves to match the target pose and location. Turning this up creates snappier projections but can sometimes jitter if turned too high `Hide Hand` Whether or not the root hand should be hidden when the projection is happening. Good for a soft grab affect where it looks like the hand is smoothly transitioning to the grab before actually performing the grab. `Use Grab Transition` Whether or not the hand projection should interpolate between the hand pose and the target pose based on the hands grip axis, or if the hand should use the `grab percent` value instead * `Grab Transition Offset` will offset the grab transition by this given percentage from 0-1 * `Grab Distance Multiplier` will multiply how close the hand is to its target position/rotation based on the handcontrollerlink grab axis * `Grab Transition Multiplier` will multiply how close the hand is to its target pose based on the handcontrollerlink grab axis `Grab Percent` how much to interpolate the projection pose between the root pose and the target pose. 1 is fully target pose 0 is the root hands pose ## Events Follows the same rules as the hands Highlight/Stop Highlight events
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://earnest-robot.gitbook.io/auto-hand-docs/auto-hand/hand/hand-projector.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.