Structure Core customers: OpenNI does not currently support Structure Core. To start developing with Structure Core download Structure SDK (Cross-Platform) on the Developer Portal.

OpenNI2 homepage: http://structure.io/openni

The latest ongoing development is currently being done in the develop branch. Refer to README and ReleasesNotes in the develop branch for up to date build instructions.

Pull requests that do not apply cleanly on top of the develop branch head will be rejected.

Other than that, sensible and meaningful contributions are very welcome!

• Microsoft Visual Studio 2010

  • Download and install from: http://msdn.microsoft.com/en-us/vstudio/bb984878.aspx

• Microsoft Kinect SDK v1.6

  • Download and install from: http://go.microsoft.com/fwlink/?LinkID=262831

• Python 2.6+/3.x

  • Download and install from: http://www.python.org/download/

• PyWin32

  • Download and install from: http://sourceforge.net/projects/pywin32/files/pywin32/

  Please make sure you download the version that matches your exact python version.

• JDK 6.0

  • Download and install from: http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u32-downloads-1594644.html

  You must also define an environment variable called JAVA_HOME that points to the JDK installation directory. For example:

    set JAVA_HOME=c:\Program Files (x86)\Java\jdk1.6.0_32
  

• WIX 3.5

  • Download and install from: http://wix.codeplex.com/releases/view/60102

• Doxygen

  • Download and install from: http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc

• GraphViz

  • Download and install from: http://www.graphviz.org/Download_windows.php

• GCC 4.x

  • Download and install from: http://gcc.gnu.org/releases.html

  • Or use apt:

      sudo apt-get install g++
    

• Python 2.6+/3.x

  • Download and install from: http://www.python.org/download/

  • Or use apt:

      sudo apt-get install python
    

• LibUSB 1.0.x

  • Download and install from: http://sourceforge.net/projects/libusb/files/libusb-1.0/

  • Or use apt:

      sudo apt-get install libusb-1.0-0-dev
    

• LibUDEV

    sudo apt-get install libudev-dev
  

• JDK 6.0

  • Download and install from: http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u32-downloads-1594644.html

  • Or use apt:

    • On Ubuntu 10.x:

        sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
        sudo apt-get update
        sudo apt-get install sun-java6-jdk
      

    • On Ubuntu 12.x:

        sudo apt-get install openjdk-6-jdk
      

• FreeGLUT3

  • Download and install from: http://freeglut.sourceforge.net/index.php#download

  • Or use apt:

      sudo apt-get install freeglut3-dev
    

• Doxygen

  • Download and install from: http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc

  • Or use apt:

      sudo apt-get install doxygen
    

• GraphViz

  • Download and install from: http://www.graphviz.org/Download_linux_ubuntu.php

  • Or use apt:

      sudo apt-get install graphviz
    

• Download and install the Android NDK version r8d. Newer versions will NOT work.

• For Mac OS X: http://dl.google.com/android/ndk/android-ndk-r8d-darwin-x86.tar.bz2

• For Windows: http://dl.google.com/android/ndk/android-ndk-r8d-windows.zip

• For Linux: http://dl.google.com/android/ndk/android-ndk-r8d-linux-x86.tar.bz2

  Building Android packages requires the NDK_ROOT environment variable to be defined, and its value must be pointing to the NDK installation dir: NDK_ROOT=/path/to/android-ndk-r8d

Open the solution OpenNI.sln

Run:

make

The following environment variables should be defined:

• ARM_CXX=path-to-cross-compilation-g++
• ARM_STAGING=path-to-cross-compilation-staging-dir

Then, run:

PLATFORM=Arm make

• Go into the directory Packaging

• Run:

  ReleaseVersion.py [x86|x64|arm|android]
  

• The installer will be placed in the Final directory