License requirement

The functionality described requires a MANUS Bodypack or a MANUS license dongle with one of the following licenses: Core OptiTrack Core OptiTrack Pro DEMO, or a Feature license with the OptiTrack feature enabled.

Getting started

The Motive Plugin for MANUS Core enables live-streaming finger data of OptiTrack Metagloves and previous generation OptiTrack Gloves into Motive:Body.

Installation

To get started with the Motive Plugin for MANUS Core, please first follow the installation guides:

It is important to follow these guides before proceeding further with the setup and usage of the plugin.

Usage

Before launching Motive, please ensure the following steps are completed:

Launch MANUS Core.
Connect your MANUS dongle.

When launching Motive, please note the following:

Motive will automatically load the plugin upon start-up.
The plugin will attempt to establish a connection with MANUS Core.
If MANUS Core is not running, Motive will stop attempting to connect after a certain number of attempts.
In the event that Motive has stopped attempting to connect, please run MANUS Core and restart Motive.

To verify the successful loading of the plugin and the connection with MANUS Core, you can refer to the Log panel as shown below:

Note

It’s recommended to either close the MANUS Core Dashboard while running Motive or disable render when unfocused. MANUS Core will continue to run in the background and stream data even when the MANUS Core Dashboard is closed.

Local & Remote Glove Data

Glove Server

The Motive Plugin for MANUS Core can receive MANUS Core data from either a local or remote computer. To configure the Glove Server, follow these steps:

Launch Motive and go to the General Settings.
In the Glove Server Address field, enter the IP address of the computer running MANUS Core.
Click Apply to save the settings.

Make sure that your firewall settings allow Motive and MANUS Core to send and receive data.

Skeleton Marker Sets

The OptiTrack Metagloves can be used with any skeleton marker set, including Core (50), Baseline (41), Conventional (39) and Biomech (57).

Attach markers on the wrist, index knuckle and/or pinky knuckle depending on the marker set.

Velcro Markers

The OptiTrack Metagloves can be used with X-base markers.

Use Velcro adhesive tape to attach X-base/finger markers for the index knuckle and/or pinky knuckle to the glove fabric.
Use X-base markers for the wrist.

OptiTrack Hand Rigid Bodies

The OptiTrack Metagloves can be used with OptiTrack Hand Rigid Bodies.

Use Velcro adhesive tape or double sided tape to attach OptiTrack Hand Rigid Bodies to the top of the OptiTrack Metagloves electronics casing.
Use the Vertical Hand Adjustment and/or the Gizmo tool to compensate for the height offset.

MANUS Rigid Marker Set

The MANUS Rigid Marker Set can be used with the OptiTrack Metagloves.

Full Body Tracking

Use the MANUS Rigid Marker Set with markers for the index knuckle and/or pinky knuckle.
Use X-base markers for the wrist.
Use the transformation/rotation gizmo tool to compensate for the knuckle marker(s) height offset.

Hands Only Tracking

Use the MANUS Rigid Marker Set with M3 marker posts to create unique tracking shapes.
Use Motive’s Gizmo tool to compensate for the marker offset.

Configuring Full Body Tracking

Skeleton Marker Sets

Select all your markers, and right click to create a skeleton:

Then pair your gloves to the skeleton you have created, by using the right click menu for each glove:

OptiTrack Hand Rigid Body

Set the Vertical Hand Adjustment to compensate for the marker height. Depending on the attachment method, the height adjustment value might be around 46mm. Measure to be sure.

Select all your markers, and right click to create a skeleton:

Then pair your gloves to the skeleton you have created, by using the right click menu for each glove:

MANUS Rigid Marker

Select all your markers, and right click to create a skeleton:

Then pair your gloves to the skeleton you have created, by using the right click menu for each glove:

Use the Gizmo tool to compensate for the knuckle marker(s) height offset.

Configuring Hands Only Tracking

OptiTrack Hand Rigid Body

Create a unique rigid body for each hand:

Select your rigid body markers, and right click to create either a left hand or a right hand skeleton:

Then, pair your glove device to your newly created skeleton, using the right click menu:

Use the Gizmo tool to align the hand skeleton:

MANUS Rigid Marker

Create a unique rigid body for each hand by using M3 marker posts:

Select your rigid body markers, and right click to create either a left hand or a right hand skeleton:

Then, pair your glove device to your newly created skeleton, using the right click menu:

Use the Gizmo tool to align the hand skeleton:

Predefined MANUS Rigid Body Assets (3.1 only)

Included with the Motive 3.1 plugin are Motive files containing predefined rigid body assets for using the MANUS Rigid Body in Motive. There are two different types of assets available:

MANUS Rigid Body: This asset uses markers directly on the MANUS Rigid Marker Set.
MANUS Extended Rigid Body: This asset uses a spacer on the wrist out marker.

To use the predefined rigid body assets, follow these steps:

Open Motive and go to File -> Open.
Select one of the included files that matches the rigid body configuration you are using.
In the Assets pane, you will see the left and right rigid body assets.
These assets will be used to track the hand-only rigid body in Motive.

Alignment

You can use the camera reference mode to make sure the digital hands are properly aligned:

You can use the Gizmo tool to offset the hand position and rotation, to further tweak the digital hand alignment.

Exporting Asset Definitions

For hands only tracking, the rigid body alignment for the created hand skeleton can be exported in case the same asset definition needs to be used again:

For full-body skeletons, however, this alignment process will need to be repeated as the exported asset will no longer be reliable after the person takes off the suit or removes the markers.