changeset 11:e0f71c26195b

Minor changes to readme.
author Becky Stewart <rebecca.stewart@eecs.qmul.ac.uk>
date Thu, 17 Feb 2011 14:41:01 +0000
parents 326ee39a35fa
children abe9b8bfebf0
files README
diffstat 1 files changed, 65 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/README	Tue Feb 08 16:51:35 2011 +0000
+++ b/README	Thu Feb 17 14:41:01 2011 +0000
@@ -1,1 +1,65 @@
-Test file for initial repository.
\ No newline at end of file
+
+--------------------------------------------------------------------
+Install instructions for OpenNI
+--------------------------------------------------------------------
+
+Install notes:
+	1) Install unstable OpenNI (http://www.openni.org/downloadfiles/openni-binaries/20-latest-unstable)
+	   On Linux/Mac please do: ./sudo install.sh
+	2) Install Sensor (this version...)
+	   On Linux/Mac please do: ./sudo install.sh
+	3) Install unstable NITE (http://www.openni.org/downloadfiles/openni-compliant-middleware-binaries/33-latest-unstable)
+	   On Linux/Mac please do: ./sudo install.sh
+	   Use this license when asked during the installation: 0KOIk2JeIBYClPWVnMoRKn5cdY4=
+	4) Test #1: Run the NiViewer sample to make sure depth & image streams are working.
+	5) Test #2: Run the OpenNI/NiUserTracker sample play with the skeleton. Don't forget to start with the calibration pose! (Explained in the PDFs)
+	6) Test #3: Try the NITE/Sample-PointViewer sample for the hand tracking demo.
+
+	For Mac/Linux, you will need to install the latest LibUSB.
+	Linux:
+		1) Run: sudo apt-get install libusb-1.0-0-dev
+		2) Run: sudo apt-get install freeglut3-dev
+	MaxOSX:
+		1) Intall MacPorts from: http://distfiles.macports.org/MacPorts/MacPorts-1.9.2-10.6-SnowLeopard.dmg
+		2) Run: sudo port install libtool
+		3) Run: sudo port install libusb-devel +universal
+		   Note: Do not forget the +universal, it's very important!!
+		   If you're previously already installed libusb-devel then use "sudo port uninstall libusb-devel" and reinstall it again with the +universal flag.
+		
+		
+		Nutshell Mac OpenNi/Kinect install for DUMMIES: 
+		This job is going to take ONE DAY. It will be SLOW. Your computer is 
+		going to run a long time. 
+		You need to be running OS X 10.6, Xcode installed, there may be some 
+		recent-hardware constraint. 
+		You will install Git, Mac Ports libtool, libusb-devel, OpenNi, 
+		SensorKinect, and Nite in that order. 
+
+		- Install Git from http://git-scm.com/, use it to download 
+		SensorKinect from github: 
+		- run "git clone git://github.com/avin2/SensorKinect.git" 
+		- Get and *read* the README in SensorKinect. Keep that README open, it 
+		explains what is happening here. 
+		- Do a clean install of Mac Ports. Uninstall an existing Macports 
+		first. 
+		- run "sudo port install libtool +universal" 
+		- run "sudo port install libusb-devel +universal" 
+		- download OpenNi unstable:  http://www.openni.org/downloadfiles/openni-binaries/20-latest-unstable 
+		- run as sudo the OpenNi unstable binaries install.sh script 
+		- run as sudo the SensorKinect install.sh script 
+		- download Nite unstable: 
+		http://www.openni.org/downloadfiles/openni-compliant-middleware-binar... 
+		- edit the three Nite DATA XML files to 640x480 
+		- run as sudo the Nite install.sh script. License key is 
+		"0KOIk2JeIBYClPWVnMoRKn5cdY4=" 
+
+		Bravo! You should be done installing! As a reward, you now get to 
+		test: 
+		- go to the Nite tree, and in Samples/bin you have a bunch of binaries 
+		that just got built. 
+		- plug in the Kinect power supply, then the USB plug of the Kinect 
+		bar. Run the Box sample.
+		
+
+
+