TUIO Array
Updated: 13 Dec 2024
Generate an Array from TUIO data.
TUIO Array
Method #
This node generates a transform array from TUIO data sent from a suitable external application that supports the TUIO protocol, via a network connection.
For TUIO to function, you’ll need a supporting application such as TUIOpad or TUIOdroid. This will be used as a source for the incoming TUIO Data. You will then need to make sure the host address and port number are the same as the target machines IP address and port number.
- Run a cmd prompt
- Type ipconfig
- Use the IP address for TUIOdroid or TUIOpad apps and setup as below
- To enable TUIO in your project, go to Project Settings and enable it in the Protocols tab
- Your mobile device will have to be on the same WiFi or network as your PC to connect to your Notch project
- If the TUIO app fails to connect to your Notch project, restart all of your Notch windows
You can then use TUIO in much the same way as a standard Transform Array.
The output transform array may be used directly with a Array Cloner, or to clone other nodes within a Field System or Particle System.
Parameters
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
Parameter Details Position X
The objects position along the local x-axis.
Position Y
The objects position along the local y-axis.
Position Z
The objects position along the local z-axis.
Rotation Heading
The objects rotation around the local y-axis.
Rotation Pitch
The objects rotation around the local x-axis.
Rotation Bank
The objects rotation around the local z-axis.
Scale X
The objects scale along the local x-axis.
Scale Y
The objects scale along the local y-axis.
Scale Z
The objects scale along the local z-axis.
Control the inheritance of the transforms from the parent.
Parameter Details Position
Toggle inheritance of the Position from the parent.
Rotation
Toggle inheritance of the Rotation from the parent.
Scale
Toggle inheritance of the Scale from the parent.
World Position Only
Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time
Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details Axis
Which axes for the generated shapes to generate on.
Apply Node Transforms To Array Elements Only
When Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used.
TUIO Cursors
Allow the TUIO node to receive Cursor data.
TUIO Objects
Allow the TUIO node to receive Object data.
TUIO Blobs
Allow the TUIO node to receive Blob data.
Use TUIO Rotations
Use rotations from the incoming TUIO source.
Use TUIO Scales
Use scales from the incoming TUIO source.
Use TUIO ID's For Transform Indexing
Use the TUIO ID’s to index each point generated. This will attempt to keep cloned shapes consistent, but can lose points.
Flip X Axis
Flip the X axis of the incoming TUIO data.
Flip Y Axis
Flip the Y axis of the incoming TUIO data.
These properties control how an element is eased into an array.
Parameter Details Ease Points On
Enable Point Easing in, so new points don’t immediately appear.
Ease Points On Mode
Edit the easing curve for how the new points will appear.
- Linear,
- Pow2,
- Pow4,
Ease Points On Duration
How long the points should take to fully appear.
Ease Points Off
Enable Point Easing out, so removed points don’t immediately disappear.
Ease Points Off Mode
Edit the easing curve for how the removed points will disappear.
- Linear,
- Pow2,
- Pow4,
Ease Points Off Duration
How long the points should take to fully disappear.
Easing Points Affects Point Scales
Allow the points to scale in size while easing.
Easing Points Affects Point Opacities
Allow the points to fade the opacity of objects while easing.
Set the bounding dimensions of the incoming data, and the area within which points will be generated.
Inputs
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
| Parameter | Details |
|---|---|
| Position X | The objects position along the local x-axis. |
| Position Y | The objects position along the local y-axis. |
| Position Z | The objects position along the local z-axis. |
| Rotation Heading | The objects rotation around the local y-axis. |
| Rotation Pitch | The objects rotation around the local x-axis. |
| Rotation Bank | The objects rotation around the local z-axis. |
| Scale X | The objects scale along the local x-axis. |
| Scale Y | The objects scale along the local y-axis. |
| Scale Z | The objects scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| Axis | Which axes for the generated shapes to generate on. |
| Apply Node Transforms To Array Elements Only | When Enabled, transform changes applied to this nodes transform properties will also be applied to the array elements, and carried onto any nodes this data is used. |
| TUIO Cursors | Allow the TUIO node to receive Cursor data. |
| TUIO Objects | Allow the TUIO node to receive Object data. |
| TUIO Blobs | Allow the TUIO node to receive Blob data. |
| Use TUIO Rotations | Use rotations from the incoming TUIO source. |
| Use TUIO Scales | Use scales from the incoming TUIO source. |
| Use TUIO ID's For Transform Indexing | Use the TUIO ID’s to index each point generated. This will attempt to keep cloned shapes consistent, but can lose points. |
| Flip X Axis | Flip the X axis of the incoming TUIO data. |
| Flip Y Axis | Flip the Y axis of the incoming TUIO data. |
These properties control how an element is eased into an array.
| Parameter | Details |
|---|---|
| Ease Points On | Enable Point Easing in, so new points don’t immediately appear. |
| Ease Points On Mode |
Edit the easing curve for how the new points will appear.
|
| Ease Points On Duration | How long the points should take to fully appear. |
| Ease Points Off | Enable Point Easing out, so removed points don’t immediately disappear. |
| Ease Points Off Mode |
Edit the easing curve for how the removed points will disappear.
|
| Ease Points Off Duration | How long the points should take to fully disappear. |
| Easing Points Affects Point Scales | Allow the points to scale in size while easing. |
| Easing Points Affects Point Opacities | Allow the points to fade the opacity of objects while easing. |
Set the bounding dimensions of the incoming data, and the area within which points will be generated.
| Name | Description | Typical Input |
|---|---|---|
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |