Summary

Package Contents

This package, TUIO Kinect Complete, includes and automates the installation of the following components:

·    OpenKinect USB drivers. These drivers enable use of the Kinect device with the libfreenect library. Obtained from http://www.openkinect.org/.

·    Open Exhibits Kinect TUIO Tray (aka “tuio_tray_kinect.exe”), which uses OpenKinect libfreenect to access the Kinect.

·    Open Exhibits Flosc Bridge for TUIO Kinect (aka “tuio_kinect_flosc.exe”).

·    Open Exhibits Panoramic viewer, configured to work out-of-the box with Kinect+Flosc (http://openexhibits.org/software/panoramicviewer/).

Usage                                         

Launch the following programs:

1.    Start Menu -> All Programs -> Open Exhibits TUIO Kinect Complete -> Update Drivers. (This should be necessary only if the drivers have not already been updated.)

2.    Start Menu -> All Programs -> Open Exhibits TUIO Kinect Complete -> TUIO Kinect Tray

3.    Start Menu -> All Programs -> Open Exhibits TUIO Kinect Complete -> Flosc Bridge for TUIO Kinect

4.    Start Menu -> All Programs -> Open Exhibits TUIO Kinect Complete -> Panoramic Viewer

The Flosc Bridge for TUIO is a very simple program and probably never needs to be restarted. The TUIO Kinect Tray, however, may need to be restarted sometimes (see Troubleshooting for more info).

Troubleshooting

·    Q: What should I do if the TUIO Kinect Tray shows a window that is gray?
A: The TUIO Kinect Tray should show a window that has a black background, and uses white lines to highlight contours of objects (such as your hands) that are visible to the Kinect. If you see a gray screen, then quit the tray program, unplug and replug the Kinect, then start the tray program.

·    Q: The computer locks/crashes if I unplug the Kinect while the other programs are running.
A: Make sure to quit the TUIO Kinect Tray before unplugging the Kinect (hopefully this will be fixed in the future, to eliminate need for quiting and restarting the TUIO Kinect Tray.)

OpenKinect License

The Open Exhibits TUIO Kinect Complete package uses, under the terms of the Apache License, version 2.0, software from the OpenKinect project. OpenKinect and libfreenect (http://www.openkinect.org/) are published under the following license:

Copyright (c) 2010 individual OpenKinect contributors. See the CONTRIB file
for details.

This code is licensed to you under the terms of the Apache License, version
2.0, or, at your option, the terms of the GNU General Public License,
version 2.0. See the APACHE20 and GPL20 files for the text of the licenses,
or the following URLs:
http://www.apache.org/licenses/LICENSE-2.0
http://www.gnu.org/licenses/gpl-2.0.txt

If you redistribute this file in source form, modified or unmodified,
you may:
1) Leave this header intact and distribute it under the same terms,
accompanying it with the APACHE20 and GPL20 files, or
2) Delete the Apache 2.0 clause and accompany it with the GPL20 file, or
3) Delete the GPL v2.0 clause and accompany it with the APACHE20 file
In all cases you must keep the copyright notice intact and include a copy
of the CONTRIB file.
Binary distributions must follow the binary distribution requirements of
either License.

Features

There are no features for this project yet.

Example Code

Using this

There is no example code for this project yet.

Properties and Customization

Included XML tags and functions:

Included AS3 Classes and customization: