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.
Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.
Parameter Details
Position X Toggle inheritance of the X Position from the parent.
Position Y Toggle inheritance of the Y Position from the parent.
Position Z Toggle inheritance of the Z Position from the parent.
Rotation Heading Toggle inheritance of the Rotation Heading from the parent.
Rotation Pitch Toggle inheritance of the Rotation Pitch from the parent.
Rotation Bank Toggle inheritance of the Rotation Bank from the parent.
Scale X Toggle inheritance of the X Scale from the parent.
Scale Y Toggle inheritance of the Y Scale from the parent.
Scale Z Toggle inheritance of the Z 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
XSens Server Address The address / IP of the XSens server providing the skeleton stream.
XSens 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. |
Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.
| Parameter | Details |
|---|---|
| Position X | Toggle inheritance of the X Position from the parent. |
| Position Y | Toggle inheritance of the Y Position from the parent. |
| Position Z | Toggle inheritance of the Z Position from the parent. |
| Rotation Heading | Toggle inheritance of the Rotation Heading from the parent. |
| Rotation Pitch | Toggle inheritance of the Rotation Pitch from the parent. |
| Rotation Bank | Toggle inheritance of the Rotation Bank from the parent. |
| Scale X | Toggle inheritance of the X Scale from the parent. |
| Scale Y | Toggle inheritance of the Y Scale from the parent. |
| Scale Z | Toggle inheritance of the Z 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 |
|---|---|
| XSens Server Address | The address / IP of the XSens server providing the skeleton stream. |
| XSens 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 Imported 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 |