DevTools | Skeleton Retargeting Tool
Note: This article applies to both Prime 3 Haptic XR Gloves and Prime 3 Mocap Gloves
Note: This article applies to both Quantum Mocap Metagloves and Quantum XR Metagloves.
Connection
When the user opens Manus DevTools, it will try to connect to Manus Core, if “Autoconnect” and “Local Host Only” are checked and Core is running, it will automatically connect.
If autoconnection if not possible the Core Selector Panel will popup letting the user to choose which Core, he wants to connect.
After a successful connection the Connection button will be highlighted with a green color.
Loading a Skeleton
If only one Skeleton is already saved in Core, Manus DevTools will automatically load it.
The user can also click the button “Available Models” to load or reload a new skeleton.
A popup panel will show up with the list of Sessions and available models to load.
The use can then select a skeleton and “OpenModel” or import a skeleton from the file system, previously saved as an mskl file.
Views
Manus DevTools offers some camera controls and predefined views so the user can position the camera to look into parts of the skeleton in more detail.
The user can also switch between 2D and 3D modes (orthographic and perspective).
Using right click + WASD keys, the user can free fly the camera into any desired position(in 3D mode) or pan the camera (in 2D mode).
Hierarchy Panel
The Hierarchy panel displays every node of the skeleton organized in a hierarchy.
Every node can be selected, collapsed/expanded, or hidden/shown.
On the bottom the list of selected nodes is displayed with a bit more detail.
Every selected node is also highlighted on the skeleton in the main view.
The visibility of each node can be toggled and hide undesired nodes in the skeleton.
The Hierarchy panel also offers a filter that the user can use to focus on only parts of the skeleton.
Node Selection
Selecting nodes can be done by clicking on node in the Hierarchy panel or directly on the skeleton.
To select multiple nodes the user can press the Ctrl or Shift key.
Ctrl key will select multiple individual nodes and Shift key will select every node between the first selection and second selection.
Ctrl key will select multiple individual nodes
Shift key will select every node between the first selection and second selection.
Shift key selection on the hierarchy will follow the hierarchy, if used directly on the skeleton it will follow a path tracing algorithm.
Creating Chains/Adding Bones
The whole purpose of Manus DevTools is to create and configure chains so the skeleton can be properly animated.
6.1. Manual creation
To create a chain manually, the following steps must be followed:
1. Select the desired nodes to be included in the new chain.
2. Click the button “Create Chain”.
3. Select a Type and Side.
4. Configure the Chain settings by setting the values in the displayed form.
6.2. Adding Bones
Nodes can also be added to the existing chains, the following steps must be followed:
1. Select the existing chain where nodes should be added.
2. Select the desired nodes to add to the chain.
3. Click the “Add Bones” button.
Chain Settings
For each chain type, different chain settings need to be configured, to do that simply select any chain and edit corresponding settings showed in the bottom form.
The user can also change the type and side of chain. Changing the type will change the settings form presented in the bottom.
Undo/Redo
All operations (excluding loading and saving a skeleton) can be undone or redone by pressing the key combination Ctrl + Z (Undo) or Ctrl + Y (Redo).
Preview Animation (ver. 2.1)
Starting on version 2.1, the user can preview pre-recorded animations and validate the result of the chains configuration.
Progress Panel
The progress panel shows a global view of the configuration progress.
A completely empty skeleton will display every segment in dark gray.
A skeleton with only empty chains (no nodes added) will be highlighted with a lighter gray.
If the chains contain the minimum required number of nodes to be considered “valid” the segments will be highlighted with green.
Saving a Skeleton
Once the skeleton configuration is finished (or at any time), the user has 2 options to save his work.
1. Send to Plugin: This will save the skeleton on the Core so it can be loaded back in the plugin that was used to send the skeleton to Manus DevTools.
2. Export to File: This will save the skeleton into the local file system using the .mskl file format, this file can be later loaded back into Manus DevTools or directly into the plugin.
