Blacktrax Tracked Body
Updated: 4 Dec 2023
Generates a tracked point from Blacktrax.
Blacktrax Tracked Body
Method #
Takes a single Blacktrax Trackable and provides it as a tracked point (a bit like Null). You can track either the rigid body position and rotation of a given trackable or just individual tracked LEDs. To use, parent other objects to this node to have the positions and rotations inherited.
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.
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 Select Trackable
When receiving Blacktrax data, this enables you to select a provided trackable.
Trackable Name
The name of the trackable (as defined by Blacktrax)
Trackable Type
Choose whether to take the centroid of all the LEDs or take the position of a single LED
LED Index
If Trackable Type is LED Points then, choose the index of the LED to track.
Flip Z Axis
Flip positions in the Z axis
Flip Z Rotation
Flip rotations in the Z axis
The properties control the time at which the node is active. See Timeline for editing time segments.
Parameter Details Duration
Control the duration of the node’s time segment.
- Composition Duration : Use the length of the composition for the node’s time segment duration.
- Custom : Set a custom duration for the node’s time segment.
Node Time
The custom start and end time for the node.
Duration (Timecode)
The length of the node’s time segment (in time).
Duration (Frames)
The length of the node’s time segment (in frames).
Time Segment Enabled
Set whether the node’s time segment is enabled or not in the Timeline.
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 |
|---|---|
| Select Trackable | When receiving Blacktrax data, this enables you to select a provided trackable. |
| Trackable Name | The name of the trackable (as defined by Blacktrax) |
| Trackable Type | Choose whether to take the centroid of all the LEDs or take the position of a single LED |
| LED Index | If Trackable Type is LED Points then, choose the index of the LED to track. |
| Flip Z Axis | Flip positions in the Z axis |
| Flip Z Rotation | Flip rotations in the Z axis |
The properties control the time at which the node is active. See Timeline for editing time segments.
| Parameter | Details |
|---|---|
| Duration |
Control the duration of the node’s time segment.
|
| Node Time | The custom start and end time for the node. |
| Duration (Timecode) | The length of the node’s time segment (in time). |
| Duration (Frames) | The length of the node’s time segment (in frames). |
| Time Segment Enabled | Set whether the node’s time segment is enabled or not in the Timeline. |
| 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 |