OpenNI

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

Develop branch

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.

Contributing

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!

Building Prerequisites

Windows

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

Linux

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
```

Android

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

Building

Building on Windows:

Open the solution OpenNI.sln

Building on Linux:

Run:

make

Cross-Compiling for ARM on Linux

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

Creating OpenNI2 packages

Go into the directory Packaging