Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/openleap/aframe-leap-hands

A-Frame VR component for Leap Motion.
https://github.com/openleap/aframe-leap-hands

aframe leap-motion

Last synced: 2 months ago
JSON representation

A-Frame VR component for Leap Motion.

Awesome Lists containing this project

README

        

# A-Frame VR `leap-hand` for Leap Motion

[![Latest NPM release](https://img.shields.io/npm/v/aframe-leap-hands.svg)](https://www.npmjs.com/package/aframe-leap-hands)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/donmccurdy/aframe-leap-hands/master/LICENSE)
![Work in progress](https://img.shields.io/badge/status-experimental-orange.svg)

A-Frame VR component for Leap Motion controller.

![4d731aec-193d-463c-8189-d54c5e023206-20847-0002ac9dc2db9992](https://cloud.githubusercontent.com/assets/1848368/23005782/0909f4aa-f3cc-11e6-83f3-072b53374000.gif)

## Installation (Scripts)

In the [dist/](https://github.com/openleap/aframe-leap-hands/tree/master/dist) folder, download either the minified or unminified build. Include the scripts on your page, and all components are automatically registered for you.

Or, use a CDN-hosted version:

```html

```

## Installation (NPM)

Using NPM and Browserify or Webpack:

```bash
npm install --save aframe-leap-hands
```

```javascript
require('aframe');
require('aframe-leap-hands');
```

## Usage

```html


```

## Options

### `leap-hand` component:

| Property | Default | Description |
|--------------------|--------------|-------------|
| hand | — | `left` or `right` |
| enablePhysics | false | Adds a physics body for [aframe-physics-system](https://github.com/donmccurdy/aframe-physics-system). |
| holdDistance | 0.2 | Holding distance, in meters. |
| holdDebounce | 100 | Debouncing on grip, in milliseconds. |
| holdSelector | `[holdable]` | Selector that limits which objects may be held. |
| holdSensitivity | 0.95 | 0—1. |
| releaseSensitivity | 0.75 | 0–1. |
| debug | false | Shows a grip target indicator. |

### `leap` system:

| Property | Default | Description |
|------------|-----------|-------------|
| vr | true | If true, sets default VR position and quaternion. |
| scale | 0.001 | |
| position | `0 0 0` | |
| quaternion | `0 0 0 1` | |

For example, to set both hands to **desktop** configuration:

```html


```

## References:

### Official

+ [Leap JS](https://github.com/leapmotion/leapjs)
+ [Leap JS Plugins](https://github.com/leapmotion/leapjs-plugins)
+ [Leap JS cont'd](https://developer.leapmotion.com/javascript)
+ [Leap JS Network](https://github.com/leapmotion/leapjs-network)
+ [Leap JS Widgets](https://github.com/leapmotion/leapjs-widgets)
+ [Leap JS Rigged THREE.js Hand](https://github.com/leapmotion/leapjs-rigged-hand)

### Third-party

+ THREE.LeapMotion Wrapper [discussion](https://community.leapmotion.com/t/three-js-wrapper/769) and [GitHub](https://github.com/scottbyrns/THREE.LeapMotion)