Emmanuel Courtoux, Caroline Appert & Olivier Chapuis
Université Paris-Saclay, CNRS, Inria, LISN, Orsay, France
emails: first.familly@upsaclay.fr

This is beta code. Should you spot any problem or have any question email us.

########################################################################
### Use in a C# project:

Put this directory inside your project, and create a new class that implements TuioWallTokenListener:


using WTT;

public class TouchTokenManager :  [MonoBehaviour, ...] TuioWallTokenListener
{
	...
	WallTokensTuio wtt;
	...

	TouchTokenManager(...){ // or in Start() in a Unity3D project [MonoBehaviour,]
		...
		// use default TUO input port 3333, arguments must specify the size in mm of the "touch" screen
		wtt = new WallTokensTuio(
			"WallTokens/Resources/templates/template.txt", screenWidthMM, screenHeightMM);
		...
		wtt.AddTuioWallTokenListener(this);
        wtt.Start();
        ...
	}

	// extended WallToken TUIO:
	void TuioWallTokenListener.addTuioWallToken(TuioWallToken tok){
		...
	}
	void TuioWallTokenListener.updateTuioWallToken(TuioWallToken tok){
		...
	}
	void TuioWallTokenListener.removeTuioWallToken(TuioWallToken tok){
		...
	}
	// standard TUIO
	void TuioListener.addTuioCursor(TuioCursor tcur){ ... }
	void TuioListener.updateTuioCursor(TuioCursor tcur){ ... }
	// etc., all the standard TUIO interface functions
}


See the source code for more details, in particular:

- TuioWallToken.cs for TuioWallToken properties (TokenID, Fixed (attached), RGBA, Shape, Ray, etc.)
- WallTokensTuio.cs for all the options that you can pass on to the constructor (port, template file name, etc.)


############################################
### Use the forwarder for non C# application

In a nutshell, compile wall-token-tuio.cs and run wall-token-tuio.exe with appropriate options. Then, run any program using TUIO or TUIO WallToken (see option -m below) listening on the "output" port that is specified as an option to wall-token-tuio.exe. Details below.

Compile:

Under Linux  (need the mono-mcs package): type "./compile.sh" in a terminal
Under Mac OSX [TODO]
Under Windows [TODO]

Then run:

	mono wall-token-tuio.exe [options]

Options:
	-ip port 	 input port [default 3333]
	-op port 	 output port [default 13333]
	-oip ip 	 output IP [default 127.0.0.1]
	-m mode		 mode=1,2 or 3. 1: WallToken as TuioObject (default), 2: WallToken as TuioCursor, 3: Extended TUIO
	-tf path 	 path to the template file [Resources/templates/template.txt]
	-sw w 		 width in mm of the input surface [default 1000]
	-sh h 		 height in mm of the input surface [default 500]
	-v  value    verbosity, 0: nothing; 1: start info (default), 2: 1 + add/remove, 3: 2 + update
	-h 		 	 print this help and exit


example:

	mono wall-token-tuio.exe -sw 5920 -sh 1975 -ip 3333 -op 13333


######################################
### Java TUIO WallToken Client library

Download TUIOWT.zip at http://walltokens.lisn.upsaclay.fr and use it like any TUIO library (with, e.g., input port 13333), but with the forwarder above.

There are 3 new callback methods:

addTuioWallToken(TuioWallToken ttok)
updateTuioWallToken(TuioWallToken ttok)
removeTuioWallToken(TuioWallToken ttok)

Note: TUIOWT requires the OSC package from https://www.illposed.com/software/javaosc.html