justzx2011 / kinect

Kinect Application Framework including some demo apps

#Atos Origin Kinect This Kinect application framework and demo apps are made by Marco Franssen and Jan Saris. During competence development at their company Atos Origin they started on februari 2011 by creating some apps and a framework with Microsoft Kinect. They started with a implementation in c#/WPF using the PrimeSense drivers and OpenNI SDK.

#Contributors

• Marco Franssen - Founder
• Jan Saris - Founder
• Rein Steens - Implementer Pong
• Erwin Wolff - Created installer for PowerPoint plugin
• Pieter-Joost van de Sande - Gave some advice on the architecture

#Goal Our goal is to create a framework for developers on top of Kinect. This Framework should support easy access to gestures etc. All the demo apps we created to test our framework are included. We would love it when you guys help to extend and improve the framework. Don't forget to add your own demo apps so you can show of all the cool stuff you made to the other developers participating.

Install Git

Install Git Extensions. This will provide you a good GUI to Git (easy for Git starters), includes GIT.

#SSH Key for github repo access
In order to connect to your github repository you need a SSH Key, so if you don't have one follow the following instructions.

1. Generate a ssh key
   

Navigate to your directory where you did install GitExtensions. (Default: C:\Program Files (x86)\GitExtensions)
Open the folder PuTTY and click the executable puttygen.exe and click the button Generate.

1. Save private key
   

Optionally configure a password for your private key and then save the private key to a location on your harddrive. (For example: c:\sshKeys\github.ppk)

1. Paste public key on your github profile
   

Optionally save your public key to your harddrive. Then navigate to https://github.com/account/ssh and click add another public key. Copy the public key from puttygen.exe and paste it in the Key input-field and click save. (Title field not required)

#How to fork

1. Fork the Kinect repo
   

Fork the Kinect repo by clicking the Fork button on https://github.com/atosorigin/Kinect

1. Clone the Kinect project
   

Navigate to the folder where you want to add the Kinect folder. Right-Click this folder and choose for Git Bash here. Run the following code: (replace username by your own Github username)
$ git clone [email protected]:username/Kinect.git

1. Configure remotes
   

When a repo is cloned, it has a default remote called origin that points to your fork on GitHub, not the original repo it was forked from. To keep track of the original repo, you need to add another remote named upstream:
$ cd Kinect the active directory in the prompt to the newly cloned "Kinect" directory
$ git remote add upstream [email protected]:atosorigin/Kinect.git Assigns the original repo to a remote called "upstream"
$ git fetch upstream

1. Pushing
   

Pushing is always done to you fork
$ git push origin master

1. Fetch the upstream with your fork
   

When you want to get the latest changes fetched from the upstream into your fork, you need to fetch the upstream.
$ git fetch upstream
$ git merge upstream/master

1. Pull requests
   

Don't forget to do a pull request when you have added value to the project.

#Installation

• Install the Microsoft Kinect SDK. (You can find them in the lib/Third Party/Microsoft Kinect SDK folder)
• Start one of the demo's to check if it works.