Touch operation mode

Touch operation mode

Overview

By default, DISPLAX Touch Controllers automatically select the correct touch operation mode for the operating system in use. In most cases, no manual configuration is required.

However, if your application or environment requires a specific touch behavior, you can check or force the touch mode using DISPLAX Service command-line parameters.

Available Touch Operation Modes

DISPLAX Touch Controllers support the following modes:

ModeValueDescription
Mouse Emulation0Touch input is reported as mouse events
Single Touch1Only one touch point is reported
Multitouch2Multiple simultaneous touches are reported

Check the Current Touch Mode

To view the currently configured touch operation mode on a local device, run:

displaxservice -a 127.0.0.1 --dmode

This command returns the active mode value.

Force a Specific Touch Mode

Set Mouse Emulation Mode

displaxservice -a 127.0.0.1 --dmode 0 perm --device-settings save

Set Single Touch Mode

displaxservice -a 127.0.0.1 --dmode 1 perm --device-settings save

Set Multitouch Mode

displaxservice -a 127.0.0.1 --dmode 2 perm --device-settings save

The perm flag ensures the setting is saved permanently to the device.

To allow the Touch Controller to automatically determine the correct mode for the operating system, run:

displaxservice -a 127.0.0.1 --dmode 2 raw --device-settings save --dreset

This resets the mode configuration and returns control to the automatic detection logic.

When to Change Touch Mode

You may need to manually define the touch mode when:

  • Integrating with legacy software

  • Using systems that do not support multitouch

  • Troubleshooting OS-specific input behavior

  • Developing or testing custom touch applications

Best Practices

  • Use automatic mode whenever possible.

  • Force a mode only when required by the application or OS.

  • Always save device settings after making changes.

  • Restart the device or service if touch behavior does not update immediately.

  • Document any forced mode changes for future maintenance.

    • Related Articles

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

    • Parameters that can be used

      DISPLAX Service – Available Device Parameters Overview DISPLAX Service allows you to retrieve a complete list of available parameters and command options supported by a specific connected device. This ensures you only use parameters that are valid ...

    • Save / Load Settings

      Overview DISPLAX Service allows you to save and load all device settings and calibration data between Touch Controllers of the same model and firmware version. This feature is useful for backup, replication, and fast deployment across multiple ...

    • Restart the Touch Controller

      Overview The Restart Touch Controller command allows you to remotely reboot the Touch Controller using DISPLAX Service, without restarting the host computer. Restarting is recommended after: Changing low-level device parameters Applying and saving ...

    • List Connected Devices

      DISPLAX Service – List Connected Devices Overview DISPLAX Service allows you to list all touch devices connected to a specific computer, whether the devices are attached locally or to a remote host on the same network. Listing devices is typically ...