Track4J

A simple framework for body tracking in Java.

Download

Released builds are available from - Bintray
Released builds are available from - Maven Central
Snapshot builds are available from - Artifactory

Javadocs

If you need to access the documentation for any stable version, javadoc.io is probably the right place to search in.

Demo

Run the demo with:

gradlew run

Build

To build JFoenix, execute the following command:

gradlew build

NOTE : Track4j uses JavaFx so it may not work on older version of Java.

Gradle

How to Include In Gradle Project

repositories {
    mavenCentral()
    jCenter()
}

Reference the repository from this location using:

dependencies {
    compile 'com.github.giulianini:track4j:1.0.0'
}

Maven

How to Include In Maven Project

<dependency>
  <groupId>com.github.giulianini</groupId>
  <artifactId>track4j</artifactId>
  <version>1.0.0</version>
  <type>pom</type>
</dependency>

Ivy

How to Include In Ivy Project

<dependency org='com.github.giulianini' name='track4j' rev='1.0.0'>
  <artifact name='track4j' ext='pom' />
</dependency>

How can I use Track4J?

Set Up

Install the Kinect SDK
Download natives - Natives dll for Kinect
Put ufdw_j4k**bit.dll Natives into HOME/.Track4J/native. Track4J will find them.
- Build
  You can download the source code of the library and build it as mentioned previously. Building Track4J will generate Track4J.jar under the Track4J/build/libs folder. To use Track4J, import Track4J.jar into your project and start tracking your body :).
- Import the dependency
  Include the dependency for your build system.

Code

Start the Tracker

	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 via UI

	final Sensor sensor = new Kinect(Joint.RIGHT_HAND, KinectSensors.SKELETON_ONLY, KinectVersion.KINECT1);
        final Tracking tracker = Tracker.getInstance();
        tracker.attacheSensor(sensor);
	final View view = new TrackerView(tracker);
        tracker.attacheUI(view);
        tracker.setOnJointTracked(new JointListener(){
	....});

Define your own UI

 public class Gui extends AbstractView {
        public Gui(Tracking tracker) {
            super(tracker);
            // 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   
        }
    }

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

License

Apache 2.0

Giulianini/Track4J