Motive 3 Plugin Installation Instructions

Plugin Overview

‍
This document explains how to install the MANUS Core 2.x plugin for Motive 3.0.x.

This plugin adds support for the OptiTrack Metagloves by MANUS and continues to support the previous generation OptiTrack Gloves by MANUS.

This plugin consists of two main components:

• ManusPeripheralDevice.dll
  This is the plugin DLL that will be loaded into Motive on start-up.

• ManusSDK.dll
  The plugin DLL uses, and depends on, ManusSDK.dll.

This plugin supports:

• OptiTrack Metagloves by MANUS
• OptiTrack Gloves by MANUS
  ‍

This plugin requires MANUS Core 2.0 or newer.

‍

Downloading the plugin

The Motive 3 Plugin for MANUS Core 2 can be downloaded from the MANUS Resource Center.

‍

Installing the plugin

Motive 3.0.x doesn’t currently ship with this plugin included. Please follow these steps to install the plugin.

‍

Place the Plugin DLL

Copy the ManusPeripheralDevice DLL into the Motive’s devices folder, which is located in Motive’s installation directory:

• C:\Program Files\OptiTrack\Motive\devices\

Then, remove the older version of the plugin in the same folder, ManusVRPeripheral.dll, as this will no longer be used.
‍

‍

Place the ManusSDK DLL

Next, copy the ManusSDK DLL into the Motive’s installation directory:

• C:\Program Files\OptiTrack\Motive\

‍

Using the plugin

Once the above two DLLs are placed in the correct directory, Motive will load the plugin on start-up. You can check the Logs pane to check if it was successfully loaded.

The main workflow for using the plugin follows the same steps as the previous integration, which is documented in the following webpage: https://docs.optitrack.com/markersets/full-body-+-fingers/manus-glove-setup

The plugin can also connect to a MANUS Core 2 host running on a remote PC. Although this will require another network to communicate between Motive and the MANUS Core 2 computer, this is recommended setup to manage the processing of MANUS Core 2 and Motive on separate computers.

‍

‍

Setting up the Glove in Motive

OptiTrack Metagloves by MANUS come with a rigid body with 4-markers that will attach to the glove. The rigid body is labeled for left or right use, please attach them to the corresponding glove.

Now, these markers can be used to create a glove-hand skeleton in Motive. Before creating the skeleton, please make sure the Vertical Hand Adjustment setting is configured to MANUS Rigid Body:

Then select the markers and create the MANUS supported skeleton that you wish to use. Once this is done, one more step needs to be done to adjust the rotational alignment. For adjusting the rotation, use the GIZMO tool in the viewport to apply the rotation. Note that this part of the setup workflow will be improved in the next version of Motive.

‍
GIZMO tool: https://docs.optitrack.com/motive/assets/gizmo-tool-translate-rotate-and-scale

• Left hand: rotate +10 degrees about z-axis (blue)
• Right hand: rotate -10 degrees about z-axis (blue)

Once this is done, 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 may need to be repeated as the exported Asset will no longer be reliable after the person takes off the suit or removes the markers.

‍

Preview

With everything configured you can see your glove data live in Motive 3.

‍

Notes

• It’s recommended to close the MANUS Core Dashboard while running Motive. Manus Core will continue to run in the background even when the MANUS Core Dashboard is closed.
• The plugin will attempt to connect to a MANUS Core 2.x host when Motive starts. Please launch MANUS Core 2.x first before launching Motive. After a certain number of connection attempts to MANUS Core 2.x, the device plugin will shut down itself if it doesn’t find any host.

‍