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.

    • Related Articles

    • Enable / disable Infinity feature

      Overview The Infinity feature in DISPLAX Service allows for multiple sensors placed alongside each other to continue smoothly beyond standard sensor boundaries, and eliminating cross-talk (interference) between them, improving continuity in large or ...

    • Enable / disable touch in the operating system

      Overview DISPLAX Service allows you to enable or disable touch injection at the operating system level. This setting controls whether touch input from the DISPLAX touch controller is sent to and processed by the OS. When touch injection is disabled, ...

    • Enable / disable rows or columns

      Overview DISPLAX Service allows you to enable or disable specific rows or columns of the touch sensor. This is useful when: Certain areas must be excluded from touch A section of the sensor is affected by noise Physical obstructions exist near the ...

    • What is DISPLAX Service?

      DISPLAX Service Overview DISPLAX Service is a background process (agent/daemon) installed alongside DISPLAX Connect that enables low-level communication with your DISPLAX Touch Controllers. It acts as a command-line interface, allowing advanced ...

    • Enable or Disable Network Host Discovery

      DISPLAX Service – Enable or Disable Network Host Discovery Overview DISPLAX Service includes a network discovery feature that allows it to find and list other DISPLAX-enabled hosts on the same network. This is commonly used for remote management, ...