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

XML

<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>