Enable / disable TUIO

Enable / disable TUIO

Overview

All DISPLAX touch products support the TUIO protocol, allowing touch data to be sent over the network to compatible client applications.

When TUIO is enabled, the Touch Controller sends the following data:

  • X coordinate

  • Y coordinate

  • Pressure sensing (available only on DISPLAX Skin Ultra)

TUIO is commonly used in interactive installations, multitouch applications, and custom software integrations.

Before You Begin (Important)

Before enabling TUIO, ensure that:

  • All touch settings (Gain, Threshold, Shield, etc.) are finalized

  • Geometric calibration has been completed

  • DISPLAX Connect is no longer being used for calibration

⚠️ Do not perform calibration while TUIO is active.

How to Enable TUIO

  1. Open a Command Prompt and navigate to the DISPLAX Service installation directory.

  2. Identify the following values:

    • DEVICE_SERIAL_NUMBER → Touch Controller serial number

    • IP_ADDRESS → Destination computer IP (use 127.0.0.1 for localhost)

    • PORT → Network port for TUIO events (default: 3333)

Command Syntax

displaxservice.exe -d DEVICE_SERIAL_NUMBER --tuio start IP_ADDRESS:PORT

Example

displaxservice.exe -d 022101000141 --tuio start 127.0.0.1:3333

Once started, TUIO events will begin streaming to the specified host and port.

How to Disable TUIO

To stop sending TUIO events, use the same command with stop:

displaxservice.exe -d 022101000141 --tuio stop 127.0.0.1:3333

TUIO Limitations and Notes

Windows Behavior

  • If the Touch Controller is reset or unplugged, you must restart TUIO manually

  • If the computer is restarted, TUIO will start automatically

Configuration Best Practices

  • Always configure TUIO after completing:

    • Gain and Threshold tuning

    • Shield adjustment

    • Calibration

  • Stop TUIO before uninstalling DISPLAX Connect

  • If using a limited Windows account, run TUIO as Administrator

Summary

TUIO provides a powerful way to stream touch data from DISPLAX sensors to third-party applications. For reliable operation, always complete configuration and calibration first, and manage TUIO as a background service using DISPLAX Service.