Difference between revisions of "OpenNI2"

From Wiki for iCub and Friends
Jump to: navigation, search
(Created page with " Installation Download and install OpenNI2. The best option is from github: git clone ..... On Debian testing (jessie), you have to make small changes: 1) pthread 2) commen...")
 
(yarp openni2 driver manual fixes)
Line 1: Line 1:
 +
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.
  
Installation
+
Note: Microsoft Kinect sensors are not supported by this driver. However, they are supported by the old [http://wiki.icub.org/yarpdoc/group__kinect__openni.html Kinect YARP driver], which was based on OpenNI version 1.
  
Download and install OpenNI2. The best option is from github:
+
= Installation =
git clone .....
 
  
On Debian testing (jessie), you have to make small changes:
+
== OpenNI2 ==
1) pthread
 
2) comment supress errors
 
  
cd in the directory
+
Download and install:
 +
git clone https://github.com/OpenNI/OpenNI2.git
  
make
+
If you are using Debian testing (jessie), you have to make small changes:
 
+
1) pthread
cd Packaging
+
2) comment suppress errors
  
./Release x64 or x86
+
cd OpenNI2
 +
make
 +
cd Packaging
 +
./Release x64   // or: ./Release x86
 +
cd Final
  
cd Final
+
== NiTE2 ==
  
 +
Download and install NiTE2:
  
NiTE2
+
tbc
 
+
./install.sh
Download, extract, run instal.sh
 
  
 
add source ..../OpenNidev
 
add source ..../OpenNidev
 
ad source ..../NiTEDev
 
ad source ..../NiTEDev
  
log in/log out or source ~bashrc
+
source ~/.bashrc // or: logout and login
  
in YARP.
+
== YARP driver ==
  
 
Enable devices
 
Enable devices
Line 36: Line 40:
 
set OpenNI2DeviceClient to ON
 
set OpenNI2DeviceClient to ON
  
set INSTALL WITH RPATH to ON
+
set INSTALL_WITH_RPATH to ON
  
Usage:
+
= Usage =
  
Options:
+
Print a short driver manual:
 +
yarpdev --device OpenNI2DeviceServer --verbose
 +
 
 +
Available options:
  
 
--device
 
--device
Line 76: Line 83:
 
UserTracker outputs bottles in the format:
 
UserTracker outputs bottles in the format:
  
 +
To use the driver in an application:
  
To use the driver in an application:
+
tbc
Tested in Debian Jessie (testing), Ubuntu 12.04+ and Mac OS X 10.8.4+
 
The OpenNI2 and NiTE software does not work with Debian Wheezy (stable) due to glibc < 2.14
 
Many thanks to Giovanni Saponaro for his help and suggestions during development and testing of the driver.
 

Revision as of 20:46, 12 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

OpenNI2

Download and install:

git clone https://github.com/OpenNI/OpenNI2.git

If you are using Debian testing (jessie), you have to make small changes: 1) pthread 2) comment suppress errors

cd OpenNI2
make
cd Packaging
./Release x64   // or: ./Release x86
cd Final

NiTE2

Download and install NiTE2:

tbc
./install.sh

add source ..../OpenNidev ad source ..../NiTEDev

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