TouchDesigner Websocket

Augmenta native plugin for TouchDesigner, which is designed to receive data from Augmenta's WebSocket output. It supports:

Tracking feature (clusters IDs, positions, bounding boxes, speed, etc.)

Point Cloud streaming

Zone triggering and control

TouchDesigner plugin (.dll + .tox ) : Download

Install the plugin

Install the Microsoft Visual C++ Redistributable packages 2022 : https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170

Download the version according to your architecture.

Copy the 3 folders inside Plugins Folder to Derivative plugin folder located in :

C:\Users\"your-username"\Documents\Derivative\Plugins

Launch demoscene.toe, accept the prompt that pop up when launching TD. This corresponds to the 3 new nodes you will get access.

Copy Augmenta.tox to your palette C:\Users\"your-username"\Documents\Derivative\Palette to have access to the Augmenta base in all your projects.

Augmenta Node

You can find these nodes in the Custom operator family.

Node	Description
Augmenta Client	Main Augmenta node DAT opens the websocket connection and stream data to CHOP, TOP and POP.
Augmenta Scenes	Select the scene for which you want to receive data.
Augmenta Clusters	Dynamic array of clusters
Augmenta Zones	Dynamic array of zones
Augmenta Zones	Zones infos : Slider / Pad XY / Presence / Enters / Leaves
Augmenta Point POP	Stream the point cloud from clusters/scenes/zones.
Augmenta Point TOP	Stream the point cloud from clusters/scenes/zones.

How to use

TouchDesigner

Enter the Augmenta IP address and port in the augmentaDAT. If you are using the simulator on the same machine you can enter 127.0.0.1

Augmenta

Create a WebSocket output ( Setup → Sources & Outputs → Output → Generic → Websocket )

Tracking Data

Cluster Data : IDs, positions, bounding boxes, speed, etc

Pointcloud

You can stream the point cloud of clusters/scenes/zones. To do this, enter the corresponding Augmenta DAT.

With POP

With TOP (instancing)

Zone triggering and control

You can retrieve zone information from the DAT by enabling "Show Events", or alternatively access only the specific data you need directly from the Augmenta CHOP.

In the example, to visualize the slider, we multiply the size of the zones by the padXY values in order to instantiate it. If you need a precise value for a slider, we recommend using the Augmanta Chop Zone Event. You have access to:

Slider

Pad XY

Presence

Enters

Leaves

Scene

Get scene data. It represents your interactive zone. It is the white box in geometry view.

Requierement

Compatible with Augmenta version 1.5b or newer Compatible with the new simulator :

Get the simulator Only Windows support currently TouchDesigner 2025+