Blacktrax Array
Updated: 13 Dec 2024
Generate an array using multiple Blacktrax Trackables as a source.
Blacktrax Array
Method #
Takes multiple Blacktrax Trackables and instantiates the child nodes at the tracked points. You can track either the rigid body positions and rotation (Centroids) of given trackables or every LED of the trackable.
See the Array Sources node to see how this node is used in the nodegraph to multi-instance child nodes.
If you only wish to instantiate a subset of the trackables that Blacktrax is sending you can use the Trackable Filter attribute to set a prefix filter that all trackable ids must start with.
To enable listening to the Blacktrax data, you need to configure the Blacktrax options in menu: Devices->Mocap/Camera/Streaming Device Settings
A trackable is a Blacktrax name for a tracked object. It can either be a point, or rigid body.
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 Trackable Type
Choose whether to take the centroid of all the LEDs or instantiate an array item for each LED
Use Blacktrax Rotations
Use the rotations passed through by Blacktrax.
Flip Z Axis
Flip positions in the Z axis
Trackable Filter
A prefix filter for the trackable names.
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.
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 |
|---|---|
| Trackable Type | Choose whether to take the centroid of all the LEDs or instantiate an array item for each LED |
| Use Blacktrax Rotations | Use the rotations passed through by Blacktrax. |
| Flip Z Axis | Flip positions in the Z axis |
| Trackable Filter | A prefix filter for the trackable names. |
| 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. |
| 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 |