License requirement
The functionality described requires a MANUS Bodypack
or a MANUS license dongle
containing one of these licenses to be connected:
Core Pro
Core Xsens Pro
Core Qualisys Pro
Core OptiTrack Pro
Demo
Remote recording start/stop triggering over UDP
When creating a recording pipeline using MANUS gloves in conjunction with body data, it's generally a good idea to include remote triggering of MANUS Core recordings for easier post processing. The functionality works via a UDP message coming over the network to a pre-specified port.
In the settings panel there is a section for recording settings. Here you can configure the remote triggering functionality. Below follows resources on how the functionality works specifically and how to set it up for each supported application.
UDP Packet
The payload is an XML file and includes a CaptureStart
or CaptureStop
element. If the Name
or DatabasePath
is omitted, the MANUS Core wide default settings for naming and autosaving are used. If the name and path attributes are sent in both the start and stop commands, the value used in the stop command override the start values.
CaptureStart
<?xml version="1.0" encoding="UTF-8"?>
<CaptureStart>
<Name VALUE="TakeName"/>
<DatabasePath VALUE="C:/Recording"/>
</CaptureStart>
CaptureStop
<?xml version="1.0" encoding="UTF-8"?>
<CaptureStop>
<Name VALUE="TakeName"/>
<DatabasePath VALUE="C:/Recording"/>
</CaptureStop>
Naming
The filename the recording will be saved with is built up as follows:
"C:/Recording/Take001_2024-05-01_12:00:00_MANUS.mrec"
{{DatabasePath}}/{{Name}}_{{yyyy-MM-dd_HH-mm-ss}}_MANUS.mrec
Integrations
MANUS Core has triggered recording functionality for the following software packages:
- Xsens MVN
- Vicon Shogun Live
- Qualisys QTM
- Optitrack Motive:Body
- PeelCapture
- Rokoko Studio
Default settings
The following ports
are the default ports for each application:
Application | Default trigger port | Default send port |
---|---|---|
Xsens MVN | 6004 | N/A |
Vicon Shogun Live | 30 | N/A |
Qualisys QTM | 8989 | N/A |
OptiTrack Motive:Body | 1515 | N/A |
PeelCapture | 1212 | 1213 |
Rokoko Studio | 14048 | N/A |
These ports may be different for your specific setup, so please refer to your application's documentation below on specific instructions.
Xsens MVN
Enables start and stop triggering in Movella's Xsens MVN. Please refer to Movella's documentation for detailed instructions on how to set up remote triggering in MVN.
Vicon Shogun Live
Enables start and stop triggering in Vicon's Shogun Live. The Vicon Shogun Live may additionally send a delay
element. The value will be used to delay the start command by as many milliseconds as stated. Please refer to Vicon's documentation for detailed instructions on how to set up remote triggering in Shogun Live.
Qualisys QTM
Enables start and stop triggering in Qualisys's Qualisys Track Manager (QTM). Please refer to QTM's documentation for detailed instructions on how to set up remote triggering in QTM.
OptiTrack Motive
Enables start and stop triggering in Optitrack's Motive:Body. Please refer to Optitrack's documentation for detailed instructions on how to set up remote triggering in Motive.
PeelCapture
The PeelCapture integration differs a a bit from the other integrations. MANUS Core will communicate back its current status so it can be displayed within PeelCapture. Please refer to our peelcapture documentation for detailed setup instructions.
Rokoko Studio
Enables start and stop triggering in Rokoko's Studio software. Please refer to Rokoko's documentation for detailed instructions on how to set up remote triggering in Rokoko Studio.
Timecode
It's highly advised to have all recordings (MANUS and others) timecoded for easy merging. Please refer to our article on timecode for more information on how to set this up in MANUS Core.