XSens Mocap Skeleton
Method #
This node reads bone data from a XSens motion capture suit and applies it to Bone nodes, either via direct input links or by a connection to the root of the target hierarchy.
A network connection must be made to the XSens software which provides a stream of bone data from the suit. The server address and port must be entered to match the output address and port in XSens. If there is no connection the node will be hatched out in red.
The input skeleton the node is applied to must have been designed to receive motion capture data: the bones must be named, oriented and arranged appropriately. Mixamo rigs are a good reference.
Please be advised you can only import one live stream into a notch project at a time.
Imported characters tend work best with Convert FBX disabled on import, and Rotate Bind Joints enabled. Although, because rigged characters can come from various sources with different standards, you may need to try a few different combinations to see which works right for your character.
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 Move along the local x-axis.
Position Y Move along the local y-axis.
Position Z Move along the local z-axis.
Rotation Heading Rotate around the local y-axis.
Rotation Pitch Rotate around the local x-axis.
Rotation Bank Rotate around the local z-axis.
Scale X Scale along the local x-axis.
Scale Y Scale along the local y-axis.
Scale Z 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 Server Address The address / IP of the XSens server providing the skeleton stream.
Server Port The port of the XSens server providing the skeleton stream.
Avatar Index Select the mocap actor to drive the skeleton.
Rotate Bind Pose Joints By Facing Direction Determines whether the input skeleton has been rigged so that the bones in their bind pose are rotated to point in the direction of the next bone, or whether they are unrotated in their bind pose.
Input Skeleton Scale Uniformly scale the size of the input mocap skeleton.
Mirrored Mirror the movements of the incoming mobcap data along the x axis.
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 | Move along the local x-axis. |
| Position Y | Move along the local y-axis. |
| Position Z | Move along the local z-axis. |
| Rotation Heading | Rotate around the local y-axis. |
| Rotation Pitch | Rotate around the local x-axis. |
| Rotation Bank | Rotate around the local z-axis. |
| Scale X | Scale along the local x-axis. |
| Scale Y | Scale along the local y-axis. |
| Scale Z | 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 |
|---|---|
| Server Address | The address / IP of the XSens server providing the skeleton stream. |
| Server Port | The port of the XSens server providing the skeleton stream. |
| Avatar Index | Select the mocap actor to drive the skeleton. |
| Rotate Bind Pose Joints By Facing Direction | Determines whether the input skeleton has been rigged so that the bones in their bind pose are rotated to point in the direction of the next bone, or whether they are unrotated in their bind pose. |
| Input Skeleton Scale | Uniformly scale the size of the input mocap skeleton. |
| Mirrored | Mirror the movements of the incoming mobcap data along the x axis. |
| Name | Description | Typical Input |
|---|---|---|
| Mocap Stream | Input a pre-recorded mocap stream to run instead of any live data. | Mocap Stream |
| Hierarchy Root | The root of the input skeleton to be driven by motion capture. | You’ll need to connect the skeleton root within an 3D Scene. |
| 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 |