Single Cell

The TUIO protocol is often used to transmit tracking coordinates from the MultiTaction Cell to the application computer. MultiTaction Cells can transmit TUIO stream directly from the Cell to the computer. TUIO transmission can be configured from using the on-screen display by selecting from the "Setup" menu option "TUIO".

TUIO transmission is disabled by default. It is enabled by clicking on the "TUIO disabled" button.

TUIO network parameters

TUIO stream needs to be directed to some specific address. You can set the IP address of your application PC in the "Target host" field. UDP port is typically 3333, but may vary depending on the client application.

"UDP packet size" is typically 1500 bytes typical Ethernet frame size). The packet size needs to be seldom adjusted, as 1500 bytes should work with most networks. In some exceptional networks it may be necessary to make the packet size smaller. This may be caused by internal packet filtering systems may consume some of 1500 bytes, so the value needs to be brought down to 1400 bytes etc.

Multiple Cells

Individual MultiTaction Cells can be used directly to provide TUIO output that is matching the single screen. When multiple Cells are in use this does not work automatically, because Cells are not aware of each other.

To be able to use TUIO with multiple MultiTaction Cells, one needs to create a tracking hub that collects information from multiple Cells and sends out the information in normalized TUIO coordinates, as a single coordinate stream. This operation can be done on the application PC with the following approach.

Create a config.txt file for multiple MultiTaction Cells
Add TUIOSender block to config.txt file.
Run a Cornerstone application. Any Cornerstone application can act as a hub collecting tracking results from individual Cells and sending them to the client as a TUIO stream. Most common applications for TUIO use are HelloWorld (for simple visual feedback) and MTServer (for operating without any windows).

In the TUIOSender block instructs the Cornerstone application to send the tracking data t specified host.

    TUIOSender {
            /* The features that should be enabled, options are: [fingers hands objects silent].
               "fingers" - Send finger tip locations
               "hands" - Enable the TUIO Hand Extension and send palm / finger connectivity information.
               "objects" - Send marker information
               "verbose" - Print TUIOSender output messages
               To enable multiple features, just put multiple keywords into the field.
               The default value is "fingers objects" /*/
            features = "fingers objects"
            /* address: The TUIO stream receiver IP network address, default = 127.0.0.1 /*/
            address = "localhost"
            /* port: The TUIO stream receiver IP port, default = 3333 /*/
            port = "3333"
    }

Using the example from screens and tracker, the complete config.txt file might look like this:

TUIOSender {
    features = "fingers objects"
    address = "localhost"
    port = "3333"
}      
NetBridge {
    host = "10.0.0.1"
    input-translate = "0 0"
}
NetBridge {
    host = "10.0.0.2"
    input-translate = "1985 0"
}

NetBridge and TUIOSender blocks are independent of each other. NetBridge block tells the Cell address and how to transform the tracking data coming from it. If there are multiple NetBridge present, the transformed tracking data from each of the Cells are combined into one tracking stream. The TUIOSender block tells to send the tracking stream as TUIO stream to specified host.

Table of Contents

Single Cell

TUIO network parameters

Multiple Cells