Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/leapmotion/leapjs-plugins

A collection of plugins available to be used with LeapJS.
https://github.com/leapmotion/leapjs-plugins

Last synced: 2 days ago
JSON representation

A collection of plugins available to be used with LeapJS.

Awesome Lists containing this project

README 

        
LeapJS Plugins

==============



This repository holds a collection of independent plugins which extend the functionality of LeapJS itself.



**`leap-plugins.js`** is a collection of amazing plugins to get you started quickly.



 - **[Hand Entry](http://leapmotion.github.io/leapjs-plugins/docs/#hand-entry)** Emit events when a hand enters of leaves the field of view.

 - **[Hand Hold](http://leapmotion.github.io/leapjs-plugins/docs/#hand-hold)** Save data on to hands or fingers which will be persisted between frames.

 - **[Screen Position](http://leapmotion.github.io/leapjs-plugins/docs/#screen-position)** Get the on-screen position of any Leap-space point.

 - **[Version Check](http://leapmotion.github.io/leapjs-plugins/docs/#version-check)** Ensure a minimum protocol version when running your app.

 - **[Playback](http://leapmotion.github.io/leapjs-plugins/docs/#playback)** Record hand-data from the Leap, compress it, and use it to animate your app.

 - **[Transform](http://leapmotion.github.io/leapjs-plugins/main/transform/)** Translate, rotate, and scale Leap Motion data. Easily.

 - **[Bone Hand](http://leapmotion.github.io/leapjs-plugins/main/bone-hand/)** Drop THREE.js Hands in to any scene, or quick-start with the default scene.



**`leap-plugins-utils.js`** explores what can be done with LeapJS Plugins.



 - **[LeapDataPlotter](http://leapmotion.github.io/leapjs-plugins/utils/data-plotter/)** Allows super trivial plotting of streaming data.

 

**Other libraries** 

 - **[Widgets](https://github.com/leapmotion/leapjs-widgets)** 3D input elements - buttons and planes.

 - **[Rigged Hand](https://github.com/leapmotion/leapjs-rigged-hand)** Easily add virtual 3d hands to any web page with THREE.js.



## Download



[developer.leapmotion.com/downloads/javascript#plugins](https://developer.leapmotion.com/downloads/javascript#plugins)



## Usage



Include LeapJS >= 0.4.0 and either javascript file of an individual plugin or a collection.

Configure your controller to use the plugin, and that functionality will be available to you.

See [hand-entry](http://leapmotion.github.io/leapjs-plugins/docs/index.html#hand-entry) for docs on hand-entry itself.



```html



  Leap.loop()

    .use('handEntry')



```



 - Download [from the CDN](http://developer.leapmotion.com/leapjs/plugins).

 - Each plugin is individually documented, with demo, on the gh-pages [docs site](http://leapmotion.github.io/leapjs-plugins/docs/).

 - See [making plugins](http://github.com/leapmotion/leapjs/wiki/plugins) on the leapjs wiki.



## Examples



Examples are available on the [developer gallery](http://developer.leapmotion.com/gallery/tags/javascript) live editor

and in subfolders here of individual plugins.



To run them on localhost, you'll need a web server to resolve asset paths.



```bash

> python -m SimpleHTTPServer

```



Contributing

===============



#### Open an issue!

 - https://github.com/leapmotion/leapjs-plugins/issues



#### Open a pull request!



 - Read up on [Making Plugins](https://github.com/leapmotion/leapjs/wiki/Plugins#plugin-development), then:

 - Make a fork, name your branch, add your plugin or fix.

 - Add your name, email, and github account to the CONTRIBUTORS.txt list, thereby agreeing to the terms and conditions of the Contributor License Agreement.

 - Open a Pull Request. If your information is not in the CONTRIBUTORS file, your pull request will not be reviewed.