Kinect - Revision history

Giovanni Saponaro: add a note stating obsolescence of this page

2015-03-25T00:00:50Z

add a note stating obsolescence of this page

← Older revision		Revision as of 00:00, 25 March 2015
Line 1:		Line 1:
			'''Note: as of 2014, this page is obsolete. Refer to active projects such as http://structure.io/openni or [http://pointclouds.org/ PCL] instead.'''

	This page lists some software instructions for RGBD cameras such as the Microsoft Kinect and Asus Xtion PRO Live.		This page lists some software instructions for RGBD cameras such as the Microsoft Kinect and Asus Xtion PRO Live.

Line 13:		Line 15:
	See http://openkinect.org/		See http://openkinect.org/

	== ~~[http://yarp0.svn.sf.net/viewvc/yarp0/trunk/yarp2/~~ YARP] wrapper ==		== YARP wrapper ==

	See <code>$YARP_ROOT/src/modules/kinect/freenect/README.txt</code> for installation instructions.		See <code>$YARP_ROOT/src/modules/kinect/freenect/README.txt</code> for installation instructions.
Line 23:		Line 25:
	Below we explain how to manually install Kinect programs on Ubuntu 10.04 LTS or higher (officially you need 10.10+, but 10.04 works too). For OpenNI version 2, see [http://www.openni.org/]. For OpenNI version 1, read below.		Below we explain how to manually install Kinect programs on Ubuntu 10.04 LTS or higher (officially you need 10.10+, but 10.04 works too). For OpenNI version 2, see [http://www.openni.org/]. For OpenNI version 1, read below.

	== ~~[http://yarp0.svn.sf.net/viewvc/yarp0/trunk/yarp2/~~ YARP] wrapper ==		== YARP wrapper ==

	See <code>$YARP_ROOT/src/modules/kinect/OpenNI/README.txt</code> for installation instructions.		See <code>$YARP_ROOT/src/modules/kinect/OpenNI/README.txt</code> for installation instructions.

Giovanni Saponaro: /* NiTE */ note down license

2014-04-07T13:46:42Z

NiTE: note down license

← Older revision		Revision as of 13:46, 7 April 2014
Line 85:		Line 85:
	* extract this archive:		* extract this archive:
	tar -jxvf NITE-Bin-Linux64-v1.3.0.18.tar.bz2		tar -jxvf NITE-Bin-Linux64-v1.3.0.18.tar.bz2
	* (''obsolete'') edit your <code>Nite-VERSION/Data/Sample-*.xml</code> files by filling in PrimeSense license and preferred resolution as reported by several guides online such as http://www.keyboardmods.com/2010/12/howto-kinect-openninite-skeleton.html		* (''obsolete'') edit your <code>Nite-VERSION/Data/Sample-*.xml</code> files by filling in PrimeSense license '''0KOIk2JeIBYClPWVnMoRKn5cdY4=''' and preferred resolution as reported by several guides online such as http://www.keyboardmods.com/2010/12/howto-kinect-openninite-skeleton.html

	== Demos ==		== Demos ==

Giovanni Saponaro: clarify intro, begin page restructuring (to be continued)

2013-11-29T14:44:07Z

clarify intro, begin page restructuring (to be continued)

← Older revision		Revision as of 14:44, 29 November 2013
Line 1:		Line 1:
	~~There are several~~ software interfaces to the ~~Microsoft Kinect~~:		This page lists some software instructions for RGBD cameras such as the Microsoft Kinect and Asus Xtion PRO Live.

			Available software interfaces to the RGBD cameras:

	# [http://openkinect.org/ OpenKinect]/[https://github.com/OpenKinect/libfreenect libfreenect]: fully open source, still lacking some functionality		# [http://openkinect.org/ OpenKinect]/[https://github.com/OpenKinect/libfreenect libfreenect]: fully open source, still lacking some functionality

Giovanni Saponaro: /* OpenNI + Prime Sensor + NiTE */ OpenNI versions

2013-01-17T19:32:10Z

OpenNI + Prime Sensor + NiTE: OpenNI versions

← Older revision		Revision as of 19:32, 17 January 2013
Line 19:		Line 19:
	Installing binary files, if you prefer this possibility, is straightforward.		Installing binary files, if you prefer this possibility, is straightforward.

	Below we explain how to manually install Kinect programs on Ubuntu 10.04 LTS or higher (officially you need 10.10+, but 10.04 works too).		Below we explain how to manually install Kinect programs on Ubuntu 10.04 LTS or higher (officially you need 10.10+, but 10.04 works too). For OpenNI version 2, see [http://www.openni.org/]. For OpenNI version 1, read below.

	== [http://yarp0.svn.sf.net/viewvc/yarp0/trunk/yarp2/ YARP] wrapper ==		== [http://yarp0.svn.sf.net/viewvc/yarp0/trunk/yarp2/ YARP] wrapper ==

Giovanni Saponaro: NITE -> NiTE

2013-01-17T19:26:21Z

NITE -> NiTE

← Older revision		Revision as of 19:26, 17 January 2013
Line 2:		Line 2:

	# [http://openkinect.org/ OpenKinect]/[https://github.com/OpenKinect/libfreenect libfreenect]: fully open source, still lacking some functionality		# [http://openkinect.org/ OpenKinect]/[https://github.com/OpenKinect/libfreenect libfreenect]: fully open source, still lacking some functionality
	# [http://www.openni.org/ OpenNI] framework + Prime Sensor drivers + ~~NITE~~ motion tracking middleware binaries (skeleton tracking, gesture recognition etc.). The last component is closed source, while the first two ones are open source. The OpenNI/~~NITE~~ combination is endorsed by the [http://www.ros.org ROS] community and is the most popular		# [http://www.openni.org/ OpenNI] framework + Prime Sensor drivers + NiTE motion tracking middleware binaries (skeleton tracking, gesture recognition etc.). The last component is closed source, while the first two ones are open source. The OpenNI/NiTE combination is endorsed by the [http://www.ros.org ROS] community and is the most popular
	# [http://research.microsoft.com/en-us/um/redmond/projects/kinectsdk/ Kinect for Windows SDK]		# [http://research.microsoft.com/en-us/um/redmond/projects/kinectsdk/ Kinect for Windows SDK]

Line 15:		Line 15:
	See <code>$YARP_ROOT/src/modules/kinect/freenect/README.txt</code> for installation instructions.		See <code>$YARP_ROOT/src/modules/kinect/freenect/README.txt</code> for installation instructions.

	= OpenNI + Prime Sensor + ~~NITE~~ =		= OpenNI + Prime Sensor + NiTE =

	Installing binary files, if you prefer this possibility, is straightforward.		Installing binary files, if you prefer this possibility, is straightforward.
Line 74:		Line 74:
	Installation instructions may vary, but keep an eye on https://github.com/PrimeSense/Sensor/tree/unstable		Installation instructions may vary, but keep an eye on https://github.com/PrimeSense/Sensor/tree/unstable

	=== ~~NITE~~ ===		=== NiTE ===

	[[Image:NITE-download.png\|500px]]		[[Image:NITE-download.png\|500px]]

	* http://www.openni.org/downloadfiles "PrimeSense ~~NITE~~ Unstable Build for Ubuntu" (also known as "OpenNI Compliant Middleware Binaries")		* http://www.openni.org/downloadfiles "PrimeSense NiTE Unstable Build for Ubuntu" (also known as "OpenNI Compliant Middleware Binaries")
	* Latest Unstable		* Latest Unstable
	* download, for example, PrimeSense NITE Unstable Build for for Ubuntu 10.10 x64 (64-bit) v1.3.0.18 to <code>~/kinect</code>		* download, for example, PrimeSense NITE Unstable Build for for Ubuntu 10.10 x64 (64-bit) v1.3.0.18 to <code>~/kinect</code>

Giovanni Saponaro: /* Prerequisites */ typo

2012-07-21T08:06:04Z

Prerequisites: typo

← Older revision		Revision as of 08:06, 21 July 2012
Line 38:		Line 38:
	Mandatory:		Mandatory:
	sudo apt-get install g++ python git-core libusb-1.0-0-dev freeglut3-dev		sudo apt-get install g++ python git-core libusb-1.0-0-dev freeglut3-dev
	~~audo~~ adduser $USER video		sudo adduser $USER video

	Optional:		Optional:

Giovanni Saponaro: /* Conflict with gspca_kinect kernel module */ SensorKinect will blacklist gspca automatically

2012-07-06T15:43:53Z

Conflict with gspca_kinect kernel module: SensorKinect will blacklist gspca automatically

← Older revision		Revision as of 15:43, 6 July 2012
Line 93:		Line 93:
	== Conflict with gspca_kinect kernel module ==		== Conflict with gspca_kinect kernel module ==

	In early 2012, a new Linux kernel module called '''gspca_kinect''' was introduced: it allows the Kinect to be used as a standard camera, but it conflicts with OpenNI when trying to access the device.		In early 2012, a new Linux kernel module called '''gspca_kinect''' was introduced: it allows the Kinect to be used as a standard camera, but it conflicts with OpenNI when trying to access the device. SensorKinect automatically blacklists this module, but in case it doesn't work, here is the manual procedure:

	~~Workaround:~~
	* in the current session, rmmod this module (in Ubuntu: <code>sudo modprobe -r gspca_kinect</code>)		* in the current session, rmmod this module (in Ubuntu: <code>sudo modprobe -r gspca_kinect</code>)
	* to make the change permanent, blacklist it (<code>sudo sh -c 'echo "blacklist gspca_kinect" > /etc/modprobe.d/blacklist-kinect.conf'</code>)		* to make the change permanent, blacklist it (<code>sudo sh -c 'echo "blacklist gspca_kinect" > /etc/modprobe.d/blacklist-kinect.conf'</code>)

Giovanni Saponaro: improve sectioning

2012-06-26T16:15:02Z

improve sectioning

← Older revision		Revision as of 16:15, 26 June 2012
Line 90:		Line 90:
	* <code>Nite-VERSION/Samples/Bin</code>		* <code>Nite-VERSION/Samples/Bin</code>
	* <code>OpenNI/Platform/Linux/Bin/x64-Release</code> (or <code>OpenNI/Platform/Linux-x86/Bin/Release</code>)		* <code>OpenNI/Platform/Linux/Bin/x64-Release</code> (or <code>OpenNI/Platform/Linux-x86/Bin/Release</code>)

	~~= Notes =~~

	== Conflict with gspca_kinect kernel module ==		== Conflict with gspca_kinect kernel module ==

Giovanni Saponaro at 18:54, 23 June 2012

2012-06-23T18:54:18Z

← Older revision		Revision as of 18:54, 23 June 2012
Line 85:		Line 85:
	* (''obsolete'') edit your <code>Nite-VERSION/Data/Sample-*.xml</code> files by filling in PrimeSense license and preferred resolution as reported by several guides online such as http://www.keyboardmods.com/2010/12/howto-kinect-openninite-skeleton.html		* (''obsolete'') edit your <code>Nite-VERSION/Data/Sample-*.xml</code> files by filling in PrimeSense license and preferred resolution as reported by several guides online such as http://www.keyboardmods.com/2010/12/howto-kinect-openninite-skeleton.html

	== Notes ==		== Demos ==

			Demos are located in
			* <code>Nite-VERSION/Samples/Bin</code>
			* <code>OpenNI/Platform/Linux/Bin/x64-Release</code> (or <code>OpenNI/Platform/Linux-x86/Bin/Release</code>)

			= Notes =

	=== Conflict with gspca_kinect kernel module ===		== Conflict with gspca_kinect kernel module ==

	In early 2012, a new Linux kernel module called '''gspca_kinect''' was introduced: it allows the Kinect to be used as a standard camera, but it conflicts with OpenNI when trying to access the device.		In early 2012, a new Linux kernel module called '''gspca_kinect''' was introduced: it allows the Kinect to be used as a standard camera, but it conflicts with OpenNI when trying to access the device.
Line 94:		Line 100:
	* in the current session, rmmod this module (in Ubuntu: <code>sudo modprobe -r gspca_kinect</code>)		* in the current session, rmmod this module (in Ubuntu: <code>sudo modprobe -r gspca_kinect</code>)
	* to make the change permanent, blacklist it (<code>sudo sh -c 'echo "blacklist gspca_kinect" > /etc/modprobe.d/blacklist-kinect.conf'</code>)		* to make the change permanent, blacklist it (<code>sudo sh -c 'echo "blacklist gspca_kinect" > /etc/modprobe.d/blacklist-kinect.conf'</code>)

	~~== Demos ==~~

	~~Demos are located in~~
	* <code>Nite-VERSION/Samples/Bin</code>
	* <code>OpenNI/Platform/Linux/Bin/x64-Release</code> (or <code>OpenNI/Platform/Linux-x86/Bin/Release</code>)

	= See also =		= See also =

Giovanni Saponaro: Conflict with gspca_kinect kernel module

2012-06-23T18:53:48Z

Conflict with gspca_kinect kernel module

@@ Line 84: / Line 84: @@
    tar -jxvf NITE-Bin-Linux64-v1.3.0.18.tar.bz2
 * (''obsolete'') edit your <code>Nite-VERSION/Data/Sample-*.xml</code> files by filling in PrimeSense license and preferred resolution as reported by several guides online such as http://www.keyboardmods.com/2010/12/howto-kinect-openninite-skeleton.html
 == Demos ==