Private & Confidential
TUIO Protocol
- Harvey Buchan
Analytics
The TUIO protocol (http://www.tuio.org/) is utilised for handling touch events over a network, using UDP for data transmission.
Touch Events Handling
Coordinates System: Touch events are reported with fractional X and Y coordinates. These represent fractions of the total canvas size.
Event Mapping: These fractional coordinates are mapped directly to the canvas, functioning similarly to mouse click coordinates.
Multiple Input Device Support
Device Identification: Touch event inputs can be received from multiple devices. Each device is identified uniquely by its IP address and/or port number.
Device Assignment: Individual devices can be assigned to specific areas of the canvas. This configuration is done through the application settings (Config > General > TUIO).
Configuration Settings
Location: Settings are stored in the
TuioSettings.xmlfile, located atC:\\ProgramData\\Igloo Vision\\IglooCoreEngine\\settings.XML Structure:
<TUIO>: The root element.<ROI>: Represents a Region of Interest (ROI) for a specific device.<IP>: The IP address of the device.<port>: The port number used for TUIO communication.<X>and<Y>: The top-left coordinates of the ROI on the canvas (as fractions of total canvas size).<W>and<H>: The width and height of the ROI on the canvas (as fractions of total canvas size).
Example XML Configuration
<TUIO>
<ROI>
<IP>192.168.1.64</IP>
<port>3333</port>
<X>0.000000000</X>
<Y>0.000000000</Y>
<W>0.500000000</W>
<H>0.982999980</H>
</ROI>
<ROI>
<IP>192.168.1.64</IP>
<port>3334</port>
<X>0.000000000</X>
<Y>0.500000000</Y>
<W>0.259999990</W>
<H>0.500000000</H>
</ROI>
<ROI>
<IP>192.168.1.63</IP>
<port>3333</port>
<X>0.000000000</X>
<Y>0.500000000</Y>
<W>0.259999990</W>
<H>0.500000000</H>
</ROI>
</TUIO>
Related content
(c) Igloo Vision 2020