Network TUIO Receive

Receives touch surfaces and tangible objects data using the TUIO 1.1 protocol (transmitted over OSC). See https://www.tuio.org/ for more info about the protocol.

TUIO Receive

TUIO trackers (multitouch surfaces, tablets, camera trackers like reacTIVision, etc.) continuously send the state of all alive sessions (fingers, fiducial markers or blobs). This module decodes those messages and exposes them as arrays: each alive session keeps a stable index in all the output arrays as long as it is alive (as long as the finger stays on the surface, for example).

When the module is created, Usine asks for the TUIO profile to decode:

  • 2Dcur : cursors (fingers on a touch surface).
  • 2Dobj : tangible objects identified by a fiducial marker.
  • 2Dblb : untagged blobs.

The outputs of the module depend on the chosen profile.

TUIO devices generally send on the UDP port 3333. Don't forget to add this port to the OSC input ports in the setup panel of Usine.

Settings

address

Osc address of the TUIO profile to decode, /tuio/2Dcur by default. Change it only if the tracker uses a custom address.

receive

Sends 1 value when a new data is received.

nb cursors

Number of currently alive sessions (cursors, objects or blobs depending on the chosen profile).

ids

Array of the session id of each alive session. A session id is a unique number attributed by the tracker: a new touch produces a new session id, and the id disappears from the array when the touch is released.

class ids

Only for the 2Dobj profile: array of the fiducial marker id of each alive object. Unlike the session id, the class id identifies which physical object is on the surface.

x

Array of the horizontal positions, in the range [0..1] (0 is the left border of the surface).

y

Array of the vertical positions, in the range [0..1] (0 is the top border of the surface).

angle

Only for the 2Dobj and 2Dblb profiles: array of the rotation angles in radians.

width

Only for the 2Dblb profile: array of the blobs width, normalized.

height

Only for the 2Dblb profile: array of the blobs height, normalized.

area

Only for the 2Dblb profile: array of the blobs area, normalized.

speed x

Array of the horizontal movement speeds.

speed y

Array of the vertical movement speeds.

rotation speed

Only for the 2Dobj and 2Dblb profiles: array of the rotation speeds.

acceleration

Array of the movement accelerations.

rotation acceleration

Only for the 2Dobj and 2Dblb profiles: array of the rotation accelerations.

frame id

Frame number transmitted by the tracker, increases at each new frame.

ip filter

Filter apply: receives only data's from the specified IP.

Use 0.0.0.0 for no filter.

Common Settings

info

show manual

Opens the web browser to display information or help about the selected object, if it exists.

For more details about information/help creation, see create-help-file.

description

Description of the module for internal help purposes only. The description is not displayed in the interface.

ID's

visible only in god mode, see setup-panel-tab-expert.

unique ID

Current private ID for this control used to identify the object.

preset ID

Current private preset ID for this control used for presets.

recreate ID

If you experience difficulties in Polyphonic mode, try to recreate new id(s) with this button.

repair ID s

Each Patch shared on the local network uses its own ID (identification number). If you experience issues of Patches that don't send information to the good target, this button will rebuild all these id's.

Object Remote Address

absolute

Absolute remote address. see objects-address.

local

Local to the current patch remote address. see objects-address.

user addr

User defined remote address. see objects-address.

See also

version 7.0.250121

Edit All Pages