Difference between revisions of "OpenNI2"

From Wiki for iCub and Friends
Jump to: navigation, search
m (Environment variables)
(YARP driver)
Line 32: Line 32:
 
  NITE2_REDIST64 or NITE2_REDIST
 
  NITE2_REDIST64 or NITE2_REDIST
  
== YARP driver ==
+
== OpenNI2 YARP driver ==
  
Enable devices
+
In the CMake configuration for YARP, set the following:
SET OpenNI2DeviceServer to ON
+
CREATE_DEVICE_LIBRARY_MODULES ON
set OpenNI2DeviceClient to ON
+
ENABLE_yarpmod_OpenNI2DeviceClient ON
 +
ENABLE_yarpmod_OpenNI2DeviceClient ON
  
set INSTALL_WITH_RPATH to ON
+
If your environment variables were defined correctly in the previous step, the following settings will be automatically taken care of by CMake:
 +
NITE2_INCLUDE_LOCAL: full path to NiTE-2.x.x/Include directory
 +
NITE2_LIBRARY: full path to libNiTE2.so
 +
OPENNI2_INCLUDE_LOCAL: full path to OpenNI-2.1.0-x64/Include directory
 +
OPENNI2_LIBRARY: full path to libOpenNI2.so
  
 
= Usage =
 
= Usage =

Revision as of 18:36, 15 November 2013

The OpenNI2 device driver for YARP works with PrimeSense compatible RGB-D sensors, including Asus Xtion Pro. Tested on Debian Jessie (testing), Ubuntu 12.04+ and Mac OS X 10.8.4+.

Debian Wheezy (stable) is not supported by OpenNI2, due to glibc version being < 2.14.

Note: Microsoft Kinect sensors are not supported by this driver. However, they are supported by the old Kinect YARP driver, which was based on OpenNI version 1.

Installation

Dependencies

For Debian and Ubuntu, install the following dependencies:

sudo apt-get install g++ python libusb-1.0-0-dev libudev-dev freeglut3-dev doxygen graphviz

Also, you must have installed a Java SDK.

Next, install OpenNI2 and NiTE2 according to the latest official instructions at http://www.openni.org

Environment variables

Source the environment files (obtained from the previous step) by copying their content permanently into your .bashrc. From your OpenNI2 directory:

cat OpenNIDevEnvironment >> ~/.bashrc

And from your NiTE2 directory:

cat NiTEDevEnvironment >> ~/.bashrc

Source the variables to make the change effective (or logout and login again):

source ~/.bashrc

At the end of this process, you should have four new environment variables defined in your system:

OPENNI2_INCLUDE
OPENNI2_REDIST 
NITE2_INCLUDE 
NITE2_REDIST64 or NITE2_REDIST

OpenNI2 YARP driver

In the CMake configuration for YARP, set the following:

CREATE_DEVICE_LIBRARY_MODULES ON
ENABLE_yarpmod_OpenNI2DeviceClient ON
ENABLE_yarpmod_OpenNI2DeviceClient ON

If your environment variables were defined correctly in the previous step, the following settings will be automatically taken care of by CMake:

NITE2_INCLUDE_LOCAL: full path to NiTE-2.x.x/Include directory
NITE2_LIBRARY: full path to libNiTE2.so
OPENNI2_INCLUDE_LOCAL: full path to OpenNI-2.1.0-x64/Include directory
OPENNI2_LIBRARY: full path to libOpenNI2.so

Usage

Print a short driver manual:

yarpdev --device OpenNI2DeviceServer --verbose

Available options:

--device

--playback filename.oni

   Playbacks the specified oni file.

--loop

   Forces the playback to loop. If not used, the playback will stop after one run.

--record filename.oni

   records to the specified oni file

--name

   chenge default port prefix (default=/OpenNI2)

--noCameras

   use only user tracker

--noMirror

   disable mirroring

--noUserTracking

--minConfidence x (double)

   set minimum confidence required. Default is 0.6

Doesn't start the user tracker.

--

The driver opens three ports: imageFrame:o depthFrame:o userTracker:o

imageFrame and depthFrame stream YARP images, and if connectd to a yarpview, the video is available. UserTracker outputs bottles in the format:

To use the driver in an application:

tbc