annotate README @ 23:ea0ff7df64f3

n/c

--------------------------------------------------------------------
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.