Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thedevstone/Jestures
A simple framework for gesture recognition in Java
https://github.com/thedevstone/Jestures
bintray demo dtw dynamic-time-warping eclipse eclipse-plugin findbugs gesture-recognition ivy java java-8 javadoc kinect kinect-sensor kinect-v2 kinect2 knn-algorithm knn-classification microsoft pmd
Last synced: 2 months ago
JSON representation
A simple framework for gesture recognition in Java
- Host: GitHub
- URL: https://github.com/thedevstone/Jestures
- Owner: thedevstone
- License: apache-2.0
- Created: 2018-07-17T09:59:07.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-10-02T23:13:48.000Z (over 5 years ago)
- Last Synced: 2024-11-24T11:09:53.833Z (2 months ago)
- Topics: bintray, demo, dtw, dynamic-time-warping, eclipse, eclipse-plugin, findbugs, gesture-recognition, ivy, java, java-8, javadoc, kinect, kinect-sensor, kinect-v2, kinect2, knn-algorithm, knn-classification, microsoft, pmd
- Language: Java
- Homepage:
- Size: 53 MB
- Stars: 33
- Watchers: 4
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://travis-ci.org/Giulianini/Jestures)
[](https://www.codacy.com/app/Giulianini/Jestures?utm_source=github.com&utm_medium=referral&utm_content=Giulianini/Jestures&utm_campaign=Badge_Grade)
[](https://www.codacy.com/app/Giulianini/Jestures?utm_source=github.com&utm_medium=referral&utm_content=Giulianini/Jestures&utm_campaign=Badge_Coverage)
[](https://github.com/Giulianini/Jestures/blob/master/LICENSE.txt)
[ ](https://bintray.com/giulianini/maven/Jestures/0.0.2/link)
[](https://search.maven.org/search?q=g:com.github.giulianini.jestures)
[](https://www.javadoc.io/doc/com.github.giulianini.jestures/jestures)
---
# Jestures
## A simple framework for gesture recognition in Java
## Donate
[](https://paypal.me/LucaGiulianini?locale.x=it_IT)
## Download
* Released builds are available from - [Bintray](https://bintray.com/giulianini/maven/Jestures/_latestVersion)
* Released builds are available from - [Maven Central](https://search.maven.org/search?q=g:com.github.giulianini.jestures)
* Snapshot builds are available from - [Artifactory](http://oss.jfrog.org/oss-snapshot-local/com/github/giulianini/jestures/)
## Javadocs
If you need to access the documentation for any stable version, [javadoc.io](https://www.javadoc.io/doc/com.github.giulianini.track4j/track4j/) is probably the right place to search in.
## Build
To build Jestures, execute the following command:
gradlew build
**NOTE** : Jestures uses JavaFx so it may not work on older version of Java.
## Demo
Run the demo with:
cd Jestures_Recorder
gradlew run
## Gesture Recorder Tool
Run the demo with:
cd Jestures_Demo
gradlew run
## Adding Jestures to your build
### Gradle
#### How to Include In Gradle Project
```gradle
repositories {
mavenCentral()
jCenter()
}
```
Reference the repository from this location using:
```gradle
dependencies {
compile 'com.github.giulianini.jestures:jestures:1.0.0'
}
```
### Maven
#### How to Include In Maven Project
```xml
com.github.giulianini.jestures
jestures
1.0.0
pom
```
### Ivy
#### How to Include In Ivy Project
```xml
```
## How can I use Jestures
### Set Up The Framework
1. Install the [__Kinect SDK__ ](https://www.microsoft.com/en-us/download/confirmation.aspx?id=40278)
2. Download natives - [Natives dll for Kinect](https://drive.google.com/open?id=1Dpvs71O2dN6AxnTrMUGLAIDJkp0y8YXD)
3. Put __ufdw_j4k_**bit.dll_ Natives into __HOME/.Jestures/native__. Jestures will find them.
4.
* **Build**
You can download the source code of the library and build it as mentioned previously. Building Jestures will generate Jestures.jar under the Track4J/build/libs folder. To use Jestures, import Jestures.jar into your project and start recognizing gestures :).
* **Import the dependency**
Include the dependency for your build system.
### Start The Recorder Tool
5. Follow the step above and the recorder tool must work with your kinect version.
### Code
#### Tracker only
```java
final Sensor sensor = new Kinect(Joint.RIGHT_HAND, KinectSensors.SKELETON_ONLY, KinectVersion.KINECT1);
final Tracking tracker = Tracker.getInstance();
tracker.attacheSensor(sensor);
tracker.startSensor();
tracker.setOnJointTracked(new JointListener(){
....});
```
#### Start the Recognizer
```java
final Sensor sensor = new Kinect(Joint.RIGHT_HAND, KinectSensors.SKELETON_ONLY, KinectVersion.KINECT1);
final Recognition recognizer = Recognizer.getInstance();
recognizer.attacheSensor(sensor);
recognizer.startSensor();
recognizer.setOnGestureRecognized(System.out::println);
```
#### Start via UI
```java
final Sensor sensor = new Kinect(Joint.RIGHT_HAND, KinectSensors.SKELETON_ONLY, KinectVersion.KINECT1);
final Recognition recognizer = Recognizer.getInstance();
recognizer.attacheSensor(sensor);
final RecognitionView view = new RecognitionScreenView(recognizer);
recognizer.attacheUI(view);
recognizer.setOnGestureRecognized(System.out::println);
```
#### Define your own UI
```java
public class Gui extends AbstractView {
public Gui(Recognition recognizer) {
super(recognizer);
// TODO Auto-generated constructor stub
}
@Override
public void notifyOnFrameChange(int frame, Vector2D derivative, Vector2D path) {
// TODO Auto-generated method stub
}
@Override
public void notifyOnFeatureVectorEvent() {
// TODO Auto-generated method stub
}
..... A lot of methods to implements
}
```
## Supported sensors
* **Windows:**
- _Kinect v1_
- _Kinect v2_
### Future support
* **Windows:**
- _Lipmotion_
* **Linux:**
- _Kinect v1_
- _Kinect v2_
## Notes for Developers
### Importing the project
The project has been developed using Eclipse, and can be easily imported in such IDE.
#### Recommended configuration
* Install the required eclipse plugins:
* In Eclipse, click "Help" -> "Eclipse Marketplace..."
* In the search field enter "findbugs", then press Enter
* One of the retrieved entries should be "FindBugs Eclipse Plugin", click Install
* Click "< Install More"
* In the search field enter "checkstyle", then press Enter
* One of the retrieved entries should be "Checkstyle Plug-in" with a written icon whose text is "eclipse-cs", click Install
* Click "< Install More"
* Wait for Eclipse to resolve all the features
* Click "Confirm >"
* Follow the instructions, accept the license, wait for Eclipse to download and install the product, accept the installation and restart the IDE
* When restarted, click "Help" -> "Install New Software..."
* Click "Add..."
* In "Location" field, enter `https://dl.bintray.com/pmd/pmd-eclipse-plugin/updates/`
* The "Name" field is not mandatory (suggested: "PMD")
* Click OK.
* If not already selected, in "Work with:" dropdown menu choose the just added update site
* Select "PMD for Eclipse 4" and click next
* Follow the instructions, accept the license, wait for Eclipse to download and install the product, accept the installation and restart the IDE.
* Set the line delimiter to LF (only for Windows users)
* In Eclipse, click window -> preferences
* In the search form enter "encoding", then press Enter
* Go to General -> Workspace
* In the section "New text file line delimiter" check "Other" and choose Unix
* Apply
* Use space instead of tabs
* In Eclipse, click window -> preferences
* Go to General -> Editors -> Text Editors
* Check "insert spaces for tabs" option.
* Apply.
* Go to Java -> Code style -> Formatter
* Click Edit button
* In Indentation tab, under "General Settings", set "tab policy" to "Spaces only"
* Apply (you should probably rename the formatter settings).
## Screenshots
### Recognition
### Dataset
### Recording
## License
[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)