This is a demonstration prototype for the modeling of human computer interactions using ModHel'X.

See http://wwwdi.supelec.fr/software/ModHelX/ for information about ModHel'X

To run this demo, you need a computer and a Kinect (the Xbox model is cheaper and works perfectly for our purpose).
You have first to build the Kinect interface in the "InteractionKinect" directory and the 3D rendering program in the "OgreMaterials" directory.

This may require to install some libraries:

  - libusb
    git clone git://git.libusb.org/libusb.git
  
  - OpenNI
    git clone --branch unstable https://github.com/OpenNI/OpenNI/
    
  - SensorKinect
    git clone https://github.com/avin2/SensorKinect
  
  - NITE
    http://openni.org/Downloads/OpenNIModules.aspx
    
  - OpenCV
    svn co http://code.opencv.org/svn/opencv/trunk/opencv
   
  - Ogre 3D
    http://www.ogre3d.org/download/sdk
   
  - CG
    http://developer.nvidia.com/cg-toolkit-download

Once the libraries and the kinect and 3dscene programs have been built, you can build ModHel'X:
  - cd to the Modhelx directory.
  - "make" should built ModHel'X and the plugins used to communicate with the Kinect and Ogre 3D
  - "Make run" should launch ModHel'X and load the model.

  Press the "Run" button in the GUI to start the demo.
  You should see the Ogre window appear first, then the Kinect window should show a black and white rendering of the 3D information from the Kinect.
  Stand in front of the Kinect so that the program can calibrate and find your "skeleton". Your hands should appear in green when open and in red when closed.
  You can start opening/closing the book (close your left hand and move it to the right or to the left) and moving it around (close the right hand and move it).
  
See http://wwwdi.supelec.fr/software/ModHelX/Kilix for more details.

2012-06-27 frederic.boulanger@supelec.fr
