Unity3d Integration for OpenTSPS
C# JavaScript
Latest commit 46b26ce Mar 25, 2012 @obviousjim Merge pull request #1 from brianchasalow/master
added connect() to match disconnect() , changed broadcastmessage,
Failed to load latest commit information.
LICENSE.TXT beta version comitted Nov 24, 2010


Unity3d + OpenTSPS Example project
Created by James George 
art: http://www.jamesgeorge.org/  | com: http://www.flightphase.com

November 24th 2010

This project provides a template and example project for combining the Toolkit for Sensing People In Spaces (http://www.opentsps.com) 
with Unity3d Game Engine (http://www.unity3d.com)

a video example of the project is on my vimeo page


	Step 1: 
	Download the Unity example in this repository 

	Step 2: 
	Download a compiled binary of openTSPS from openTSPS.com

	Step 3:
	Set up your video camera to track some people. This requires some 
	pretty specific and stable lighting. If it's not convenient see below for 
	alternatives for prototyping applications with OpenTSPS/Unity3d

	Step 4:
	Start up OpenTSPS and configure the OSC communication to send to appropriate host/port.
	Most likely you're running these on the same computer, so you can specify IP of
	localhost and use the default OpenTSPS port 12000
	Step 5:
	Double click the OpenTSPSExample.unitypackage project. This will import the example scene into
	your current Unity Project if you have one open. Double click the openTSPSReceiver scene to 
	check out the example.
	Hit play. If are people in your TSPS scene you should see 
	little cubes moving around tracing their position. Now you can take it from here!
	The example project creates a cube for each person in the scene and moves 
	it along as the person moves across a 3d platform.  OpenTSPSUnityListener.cs script is attached
	to an empty object. This object begins listening for OpenTSPS messages on game start up
	and then instantiates / moves / destroys cubes as they are received.


		An example script that can be added to the an empty game object 
		that will then receive TSPS messages. This is an implementation of 
		the OpenTSPSListener interface class This object also moves the cubes 
		around within the scene.
		Interface for TSPS listeners. Classes implementing this 
		interface can listen to TPSP messages. 
		Internal code that handles OSC messages and calls back to 
		attached OpenTSPSListeners
		Container class for an OpenTSPS Person object which is created for each 
		person in the scene
		includes an OSC implementation for Unity3d in C#


	If access to a good people tracking set up isn't convenient there 
	is a great program called CamTwist for OS X that can play quicktime movie as a 
	WebCam. This lets OpenTSPS use a movie file as input instead of a live camera.

	You'll need a good video to test it with. Theo Watson has some test videos that work 
	well with people tracking. Any of the overhead ones will do

	here are some more security-camera movies that work fairly well with TSPS:


	The OSC implementation for Unity+TSPS is taken from the OSCuMote project:

	Which builds upon some code from the Unity/TUIO project

	Big props to the OpenTSPS project for leading the way.
	from the TSPS page:
		"TSPS was started as a collaboration between the LAB at Rockwell Group and the LABS at IDEO. 
		It began as an initiative between Dave  Vondle (IDEO) and Joshua Walton (LAB at Rockwell Group) 
		with many of the key components generated through the hard work of James Tichenor, 
		Brett Renfer, and James George who in turn also used components from the openframeworks 
		community, who in turn built upon many open source projects.

		Special thanks to the teams that develop Openframeworks, OpenCV, 
		and the many individuals who are all working on creating better computer vision systems."

	community contributors include:
		Joshua Walton & James Tichenor (http://lab.rockwellgroup.com)
		Brett Renfer (http://robotconscience.com/)
		myself (http://www.jamesgeorge.org)
		Zack Boka (http://www.zackboka.com)
		Jeff Crouse (http://www.jeffcrouse.info/)
		...and others