Document toolboxDocument toolbox

Private & Confidential

(1.3.0) TUIO Protocol

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.xml file, located at C:\\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>

 

(c) Igloo Vision 2020