schlangen avatar schlangen committed ed7d16f

added readme

Comments (0)

Files changed (1)

+============
+NeverKinect
+============
+:Author: Julian Habrock
+:Date: January 2, 2012 
+:Description: This code allows you to play the game Neverball with kinect, the 3d motion sensor by Microsoft.
+
+
+Install
+========
+Linux
+--------
+download and install OpenNI, NiTE and SensorKinect (the kinect driver for OpenNI)
+as explained in the readme of https://github.com/avin2/SensorKinect
+
+then checkout a recent trunk version from the neverball svn::
+
+    $> svn checkout https://s.snth.net/svn/neverball/trunk neverball
+
+checkout this project::
+
+    $> hg clone https://bitbucket.org/schlangen/neverkinect
+
+copy the files into the neverball repo::
+
+    $> cp neverkinect/* neverball/ -r
+
+compile with kinect support::
+
+    $> make ENABLE_TILT=kinect
+
+
+Windows / Mac / ???
+---------------------
+currently not supported, but as both neverball and OpenNI run on these systems,
+it should be easy to modify the makefile and get it running. (patches welcome!)
+
+
+Troubleshooting
+================
+
+* you (may) need to edit
+  ::
+    
+      /usr/include/ni/Linux-x86/XnOSLinux-x86.h
+
+  and change *line 147* from 
+  ::
+      
+      struct timespec tStartTime;
+      
+  to 
+
+  ::
+
+      struct timespec {} tStartTime;
+
+
+* also, (depending on your version of cc(?)) you may need to move the definition 
+  of **XnModuleExportedProductionNodeInterface** from `/usr/include/ni/XnModuleInterface.h`
+  to `/usr/include/ni/XnTypes.h` to avoid its forward declaration in `XnTypes.h` (*l. 249*)
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.