docs/components/hand-controls.md
The hand-controls component provides tracked hands (using a prescribed model)
with animated gestures. hand-controls wraps the vive-controls and
meta-touch-controls which in turn wrap the tracked-controls
component. By specifying just hand-controls, we have something that
works well with both Vive and Rift. The component gives extra events and
handles hand animations and poses.
<a-entity id="leftHand" hand-controls="hand: left; handModelStyle: lowPoly; color: #ffcccc"></a-entity>
<a-entity id="rightHand" hand-controls="hand: right; handModelStyle: lowPoly; color: #ffcccc"></a-entity>
| Property | Description | Default Value |
|---|---|---|
| color | Color of hand material. | white |
| hand | Associated controller. Can be left or right. | left |
| handModelStyle | Style of the hand 3D model loaded. Can be lowPoly, highPoly or toon. | lowPoly |
| Event Name | Description |
|---|---|
| gripdown | The hand is closed into a fist without thumb raised. |
| gripup | The hand is no longer closed into a fist without thumb raised. |
| pointup | The hand is touching or pressing the trigger only. |
| pointdown | The hand is no longer touching or pressing the trigger only. |
| thumbup | The hand is closed into a fist with thumb raised. |
| thumbdown | The hand is no longer closed into a fist with thumb raised. |
| pointingstart | The hand is pointing with index finger without thumb raised. |
| pointingend | The hand is no longer pointing without thumb raised. |
| pistolstart | The hand is pointing with index finger and thumb raised. |
| pistolend | The hand is no longer pointing with thumb raised. |