When writing or utilising a touch application that is receiving touches via TUIO, there several things to consider when used with UPDD Commander. This generally involves setting up the application in Commander so that some or all gestures do not trigger their normal actions when touches are performed on the application, so as not to interfere with the application's touch functionality, on top of converting touches to TUIO.
The first step is to add the application into the application list. Then you need to either:
1. Remove all gestures from the application if you want it to have no touch functionality outside of its own functionality. This usually requires setting the application not to inherit gestures from "Default Gestures":
Or,
2. Remove some gestures from the application, or set their action to "No Action". If the gestures are inherited, then you need to add them directly to the application. (A shortcut for this is to double click the inherited gesture.) This way some gestures can retain their functionality, for example default gestures used for showing the Notification Center or the Smart Magnifier, but other touches will be processed by the application itself. In this case, you can either set the application not to inherit gestures from "Default Gestures" and then create only the set of gestures you want to apply to this application, or set it to keep inheriting gestures, but add the gestures you want to only be handled by the application and set their action to "No Action". This way, the gestures defined for the application itself will override Default Gestures.
For example, if the application will handle single finger taps and drags on its own, but you want to continue using the multi-finger gestures you have configured in "Default Gestures", you can add "One Finger Tap" and "One Finger Drag" and set their action to "No Action".
Then add the "Convert touches to TUIO" gesture to the application:
Be sure to set the host and port correctly. Usually the host should be localhost (unless your TUIO server is running on another computer), and the usual port for TUIO is 3333, though some applications can be configured to use a different port.
In the gesture's advanced settings, you may want to set the "TUIO touch positions" setting, depending on how the app responds to TUIO touches. If you find that your touches don't correspond to where the application thinks they land, you can try setting it to "Relative to window". In this case, the touch positions will be normalized using the boundaries of the window, rather than the boundaries of the screen.
