Difference between revisions of "OpenNI2"

From Wiki for iCub and Friends
Jump to: navigation, search
(Installation)
m (update installation manual)
Line 12: Line 12:
 
  sudo apt-get install g++ python libusb-1.0-0-dev libudev-dev freeglut3-dev doxygen graphviz
 
  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.
 
Also, you must have installed a Java SDK.
 
== OpenNI2 ==
 
  
Download and install:
+
Next, install OpenNI2 and NiTE2 according to the latest official instructions at http://www.openni.org
git clone https://github.com/OpenNI/OpenNI2.git
 
  
If you are using Debian testing (jessie), you have to make small changes:
+
== Environment variables ==
1) pthread
 
2) comment suppress errors
 
  
cd OpenNI2
+
Source the files OpenNIDevEnvironment and NiTEDevEnvironment by copying their content permanently into your .bashrc:
make
 
cd Packaging
 
./Release x64  // or: ./Release x86
 
cd Final
 
 
 
== NiTE2 ==
 
 
 
Download and install NiTE2:
 
 
 
tbc
 
./install.sh
 
 
 
add source ..../OpenNidev
 
ad source ..../NiTEDev
 
  
 +
cat OpenNIDevEnvironment >> ~/.bashrc
 +
cat NiTEDevEnvironment >> ~/.bashrc
 
  source ~/.bashrc  // or: logout and login
 
  source ~/.bashrc  // or: logout and login
  

Revision as of 19:33, 14 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 files OpenNIDevEnvironment and NiTEDevEnvironment by copying their content permanently into your .bashrc:

cat OpenNIDevEnvironment >> ~/.bashrc
cat NiTEDevEnvironment >> ~/.bashrc
source ~/.bashrc  // or: logout and login

YARP driver

Enable devices SET OpenNI2DeviceServer to ON set OpenNI2DeviceClient to ON

set INSTALL_WITH_RPATH to ON

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