All pages
Powered by GitBook
1 of 8

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Settings

An introduction to the Applications Settings panel.

Overview

Use the Application Settings panel to customize Motive and set default values. This includes camera system setting, data pipeline settings, streaming settings, and hotkeys and shortcuts. Please see the following pages for descriptions of the settings on each tab:

  • Settings: General

The Settings panel can be opened from the or by clicking the icon on the main toolbar.

Advanced Settings

Show Advanced

Advanced settings are hidden by default. To access, click the button in the top-right corner of the panel and select Show Advanced.

Edit Advanced

Customize the Standard view to show the settings that you frequently adjust during your capture applications. Click the button on the top-right corner of the pane and select Edit Advanced.

Checked items will appear in the Standard view while unchecked items will only be visible when Show Advanced is selected. Click Done Editing to exit and save your changes when you've made your selections.

Reset Settings

To restore all settings to their default values, select Reset Settings from the Edit menu.

Settings: Assets
Settings: Live Pipeline
Settings: Streaming
Settings: Views
Settings: Mouse and Keyboard
Settings: Audio
View tab
Application settings panel in Motive.
Show or Edit Advanced Settings.
The Edit Menu in Motive.
Toolbar AppSettings 20.png

Settings: Assets

Overview

The Assets tab in the application settings panel is where you can configure the creation properties for Rigid Body and Skeleton assets. In other words, all of the settings configured in this tab will be assigned to the Rigid Body and Skeleton that are newly created in Motive.

Assets tab in Application Settings.

Rigid Bodies Basic Settings

A list of the default Rigid Body creation properties is listed under the Rigid Bodies tab. These properties are applied to only Rigid Bodies that are newly created after the properties have been modified. For descriptions of the Rigid Body properties, please read through the page.

Note that this is the default creation properties. Asset specific Rigid Body properties are modified directly from the .

Rigid Body Creation Properties

Default Name (Default: RigidBody)

You can change the naming convention of Rigid Bodies when they are first created. For instance, if it is set to RigidBody, the first Rigid Body will be named RigidBody when first created. Any subsequent Rigid Bodies will be named RigidBody 001, RigidBody 002, and so on.

Streaming ID

User definable ID. When streaming tracking data, this ID can be used as a reference to specific Rigid Body assets.

Minimum Markers to Boot

The minimum number of markers that must be labeled in order for the respective asset to be booted.

Minimum Markers to Continue

The minimum number of markers that must be labeled in order for the respective asset to be tracked.

Smoothing

Applies double exponential smoothing to translation and rotation. Disabled at 0.

Forward Prediction

Compensate for system latency by predicting movement into the future.

For this feature to work best, smoothing needs to be applied as well.

Visuals

Label

Toggle 'On' to enable. Displays asset's name over the corresponding skeleton in the 3D viewport.

Creation Color

Select the default color a Rigid Body will have upon creation. Select 'Rainbow' to cycle through a different color each time a new Rigid Body is created.

Bone Position History

When enabled this shows a visual trail behind a Rigid Body's pivot point. You can change the History Length, which will determine how long the trail persists before retracting.

Visual

Shows a Rigid Body's visual overlay. This is by default Enabled. If disabled, the Rigid Body will only appear as individual markers with the Rigid Body's color and pivot marker.

Bones

When enabled for Rigid Bodies, this will display the Rigid Body's pivot point.

Marker Constraints

Shows the transparent sphere that represents where an asset first searches for markers, i.e. the Marker Constraints.

Replace Geometry

When enabled and a valid geometric model is loaded, the model will draw instead of the Rigid Body.

Rigid Bodies Advanced Settings

Rigid Body Creation Properties

Deflection Ratio

Allows the asset to deform more or less to accommodate markers that don't fix the model. High values will allow assets to fit onto markers that don't match the model as well.

Skeletons Basic Settings

A list of the default Skeleton display properties for newly created Skeletons is listed under the Skeletons tab. These properties are applied to only Skeleton assets that are newly created after the properties have been modified. For descriptions of the Skeleton properties, please read through the page.

Note that this is the default creation properties. Asset-specific Skeleton properties are modified directly from the .

Skeleton Creation Properties

Straight Arms

Straightens each arm along the line from shoulder to wrist, regardless of the position of the elbow markers.

Straight Legs

Straightens each leg along the line from hip to ankle, regardless of the position of the knee markers.

Feet On Floor

Scales the shin bone length to align the bottom of foot with the floor, regardless of the ankle marker height.

Head Upright

Creates the skeleton with the head upright, removing tilt or bend, regardless of the head marker positions.

Height Marker

Scales the skeleton model so that the top of the head aligns with the top head marker.

Vertical Hand Adjustment

Height offset applied to hands to account for markers placed above the write and knuckle joints.

Visuals

Same as the Rigid Body visuals above:

  • Label

  • Creation Color

  • Bones

  • Marker Constraints

Quality Visual

Changes the color of the skeleton visual to red when there are no markers contributing to a joint.

Skeleton Advanced Settings

Visuals

Bone Orientation

Display Coordinate axes of each joint.

Marker Constraints

Displays the lines between labeled skeleton markers and corresponding expected marker locations.

Marker Lines

Displays lines between skeleton markers and their joint locations.

Settings: Mouse and Keyboard

In Motive, the Application Settings can be accessed under the or by clicking icon on the main toolbar. Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main .

Mouse

Customizing Mouse Actions

The Mouse tab under the application settings is where you can check and customize the mouse actions to navigate and control in Motive.

Mouse actions configured in the application settings panel.

Basic Controls

The following table shows the most basic mouse actions:

Function
Default Control

Rotate view

Right + Drag

Pan view

Middle (wheel) click + drag

Zoom in/out

Mouse Wheel

Select in View

Left mouse click

Toggle Selection in View

CTRL + left mouse click

Preset Profile

You can also pick a preset mouse action profiles to use. The presets can be accessed from the below drop-down menu. You can choose from the provided presets, or save out your current configuration into a new profile to use it later.

Mouse profile presets.

Keyboard

Customizing Hotkeys

The Keyboard tab under the application settings allows you to assign specific hotkey actions to make Motive easier to use. List of default key actions can be found in the following page also: Motive Hotkeys

Keyboard hotkeys configured in the application settings panel.

Hotkey Profiles

Configured hotkeys can be saved into preset profiles to be used on a different computer or to be imported later when needed. Hotkey presets can be imported or loaded from the drop-down menu:

Keyboard hotkey presets in the application settings panel.
View tab
Toolbar
Properties: Rigid Body
Properties pane
Properties: Skeleton
Properties pane

Settings: General

Motive's General Settings defined.

Use the Application Settings panel to customize Motive and set default values. This page will cover the items available on the General tab. Properties are Standard unless noted otherwise.

Please see the following pages for descriptions of the settings on other tabs:

  • Settings: Assets

  • Settings: Live Pipeline

Application Settings can be accessed from the or by clicking the icon on the main toolbar.

Advanced Settings

The Settings panel contains advanced settings that are hidden by default. To access these settings, click the button in the top right corner.

Use the Edit Advanced option to customize which settings are in the Advanced Settings category and which appear in the standard view, to show only the settings that are needed specifically for your capture application.

To restore all settings to their default values, select Reset Settings from the Edit menu.

General Settings

The following items are available in the top section of the General section. Settings are Standard unless noted otherwise.

Take Suffix

Set the separator (_) and string format specifiers (%03d) for the suffix added after existing file names.

Auto Archive Takes

Enable auto-archiving of Takes when .

Device Profile (Advanced Setting)

Set the default device profile, in XML format, to load into Motive. The device profile determines and configures the settings for peripheral devices such as force plates, NI-DAQ, or navigation controllers.

Persistent Data Folders

When enabled, all of the session folders loaded in the when exiting will be available again when launching Motive the next time.

Glove Server Address (Advanced Setting)

Enter the IP address of the glove server, if one is used. Leave blank to use the Local Host IP.

Log Filename (Advanced Setting)

Click the folder icon to the right of the field to select a text file to write the Motive event log to. This allows you to maintain a continuous log that persists between sessions, which can be helpful for troubleshooting.

Camera Displays

The following items are available in the Camera Displays section. Settings are Standard unless noted otherwise.

Numeric LEDs (Advanced Setting)

Display the assigned camera number on the front of each camera.

Camera ID

Set how Camera IDs are assigned for each camera in a setup. Available options are:

  • By Location: Follows the positional order in a clockwise direction, starting from the -X and -Z quadrant with respect to the origin.

  • By Serial Number: Numbers the cameras in numerical order by serial number.

  • Custom: Opens the Number property field for editing in the Camera Properties pane.

Status Rings

Set the color of the (Prime Series cameras only) to indicate various camera statuses in Motive.

Live

(Default: Blue) Camera is in Live mode.

Recording

(Default: Green) Camera is recording a capture.

Playback

(Default: Black) Camera is idle while Motive is in playback mode.

Selection

(Default: Yellow) Camera is selected.

Video Mode

(Default: Orange) Camera is in video (reference) mode.

Hibernation Visual

(Default: Enabled) Enable the hibernation light for all cameras when Motive is closed.

Calibration Camera Visuals (Advanced Setting)

(Default: Enabled) Display visuals of wanding coverage in the Camera Viewport during calibration.

Disable All Lights

(Default: Off) Turn off all numeric LEDs and ring lights on all cameras in the system.

Aim Assist

All of the Aim Assist settings are standard settings.

Switch to Video when Aiming

(Default: On) Set the Aim Assist button on the back of the camera to toggle the camera between MJPEG mode and back to the default camera group record mode.

Aiming Crosshairs

(Default: Grayscale Only) Display aiming crosshairs on the the camera in the Camera Viewport. Options are None, Grayscale Only, All Modes.

Aiming Button LED

(Default: On) Enable the LED light on the Aim Assist button on the back of the Prime Series cameras.

Calibration Settings (Advanced)

All calibration settings are part of the General tab's Advanced Settings.

Calibration

Restore Calibration on Startup

(Default: On) Automatically load the previous, or last saved, calibration file when starting Motive.

Auto-Mask Duration

(Default: 1 s) The duration, in seconds, that the camera system will auto-detect extraneous reflections for masking during process.

Suggested Samples

(Default: 1,000) Number of samples suggested for calibration. During the process, the camera status in the will turn bright green as cameras reach this target.

Record Calibration Samples

(Default: On) Save two TAKE files in the current data folder every time a calibration is performed: one for the calibration wanding and one for the ground plane.

Calibration Visual

(Default: On) Display visuals of wanding coverage in the Camera Viewport during calibration.

Editable in 3D View

(Default: Off) Allows editing of the camera calibration position with the 3D Gizmo tool.

Bumped Camera Correction Mode

(Default: Disabled) Select the default mode for Bumped Camera correction. Options are Disabled, Camera Samples, and Selected Camera. Please see the page for more information on these settings and the Bumped Camera tool.

Correction Tool Max Translation

(Default: 100 mm) The maximum distance cameras can be translated by the position correction tool, in mm.

Continuous Calibration Max Sampling Period

(Default: 120) The maximum length, in seconds, that samples are collected during continuous calibration.

Continuous Calibration While Recording

(Default: Off) Allows Continuous Calibration to continue running while recording is in progress.

Network (Advanced)

The Network setting is part of the General tab's Advanced Settings.

LLDP (PoE+) Detection

(Default: Override) Enable detection of PoE+ switches by High Power cameras (Prime 17W, PrimeX 22, Prime 41, and PrimeX41). LLDP allows the cameras to communicate directly with the switch and determine power availability to increase output to the IR LED rings.

When using Ethernet switches that are not PoE+ enabled or switches that are not LLDP enabled, cameras will not go into high power mode even with this setting on.

Editing

All of the Editing settings are standard settings.

Take Auto-Save

(Default: Always Ask) Set Motive's default behavior when changes are made to a TAKE file. Options are:

  • Do Not Auto-Save: Changes made to TAKE files must be manually saved.

  • Auto-Save: Updates the TAKE file as changes are made.

  • Always Ask: Prompts the user to save TAKE files upon exit.

Settings: Audio

In Motive, the Application Settings can be accessed under the View tab or by clicking icon on the main toolbar. Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main Toolbar.

If you have an audio input device, you can record synchronized audio along with motion capture data in Motive. Recorded audio files can be played back from a captured Take or be exported into a WAV audio files. This page details how to record and playback audio in Motive. Before using an audio input device (microphone) in Motive, first make sure that the device is properly connected and configured in Windows.

Audio Recording/Playback

Audio Settings

In Motive, audio recording and playback settings can be accessed from .

Audio Recording Steps

  1. In Motive, open the Audio Settings, and check the box next to Enable Capture.

  2. Select the audio input device that you want to use.

  3. Press the Test button to confirm that the input device is properly working.

  4. Make sure the device format of the recording device matches the device format that will be used in the playback devices (speakers and headsets).

Audio Playback Steps

  1. Enable the Audio device before loading the TAK file with audio recordings. Enabling after is currently not supported, as the audio engine gets initialized on TAK load

  2. Open a Take that includes audio recordings.

  3. To playback recorded audio from a Take, check the box next to Enable Playback.

Device Format

In order to playback audio recordings in Motive, audio format of recorded sounds MUST match closely with the audio format used in the output device. Specifically, communication channels and frequency of the audio must match. Otherwise, recorded sound will not be played back.

The recorded audio format is determined by the format of a recording device that was used when capturing Takes. However, audio formats in the input and output devices may not always agree. In this case, you will need to adjust the input device properties to match them. Device's audio format can be configured under the Sound settings in Windows. In Sound settings (accessed from Control Panel), select the recording device, click on Properties, and the default format can be changed under the Advanced Tab, as shown in the image below.

Audio Export

Recorded audio files can be exported into WAV format. To export, right-click on a Take from the and select Export Audio option in the context menu.

Other Options

If you want to use an external audio input system to record synchronized audio, you will need to connect the motion capture system into a Genlock signal or a Timecode device. This will allow you to precisely synchronize the recorded audio along with the capture data.

For more information on synchronizing external devices, read through the page.

  • Capture the Take.

  • Select the audio output device that you will be using.
  • Make sure the configurations in Device Format closely match the Take Format. This is elaborated further in the section below.

  • Play the Take.

  • Application Settings
    Data pane
    Synchronization
    Audio settings in Motive.
    Accessing microphone properties from the Sound settings.
    Configuring microphone device format.
    Exporting recorded audio in Motive.
    Settings: Streaming
    Settings: Views
    Settings: Mouse and Keyboard
    Settings: Audio
    View menu
    trimming Takes
    Data pane
    RGB Status Indicator Ring LEDs
    Calibration
    wanding
    Calibration pane
    Continuous Calibration (Info Pane)
    Standard Settings on the General Tab of the Settings Panel.
    Show or Edit Advanced Settings.
    General Settings - Standard and Advanced.
    Camera Displays Settings - Standard and Advanced.
    Camera Properties with Custom Camera Number.
    Status Ring settings - Standard and Advanced.
    Aim Assist Settings.
    Calibration settings.
    Network Settings.
    Editing Settings.

    Settings: Streaming

    In Motive, the Application Settings can be accessed under the View tab or by clicking icon on the main toolbar. Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main Toolbar.

    In Motive, the Data Streaming pane can be accessed under the View tab or by clicking icon on the main toolbar. For explanations on the streaming workflow, read through the Data Streaming page.

    NatNet Basic Settings

    This section allows you to stream tracking data via Motive's free streaming plugins or any custom-built NatNet interfaces. To begin streaming, select Broadcast Frame Data. Select which types of data (e.g. markers, Rigid Bodies, or Skeletons) will be streamed, noting that some third party applications will only accept one type of data. Before you begin streaming, ensure that the network type and interface are consistent with the network you will be streaming over and the settings in the client application.

    Enable

    (Default: False) Enables/disables broadcasting, or live-streaming, of the frame data. This must be set to true in order to start the streaming.

    Local Interface

    (Default: loopback) Sets the network address which the captured frame data is streamed to. When set to local loopback (127.0.0.1) address, the data is streamed locally within the computer. When set to a specific network IP address under the dropdown menu, the data is streamed over the network and other computers that are on the same network can receive the data.

    Transmission Type

    (Default: Multicast) Selects the mode of broadcast for NatNet. Valid options are: Multicast, Unicast.

    Labeled Markers

    (Default: True) Enables, or disables, streaming of labeled Marker data. These markers are point cloud solved markers.

    Unlabeled Markers

    (Default: True) Enables/disables streaming of all of the unlabeled Marker data in the frame.

    Asset Markers

    (Default: True) Enables/disables streaming of the Marker Set markers, which are named collections of all of the labeled markers and their positions (X, Y, Z). In other words, this includes markers that are associated with any of the assets (Marker Set, Rigid Body, Skeleton). The streamed list also contains a special marker set named all which is a list of labeled markers in all of the assets in a_Take_. In this data, Skeleton and Rigid Body markers are point cloud solved and model-filled on occluded frames.

    Rigid Bodies

    (Default: True) Enables/disables streaming of Rigid Body data, which includes the name of Rigid Body assets as well as positions and orientations of their .

    Skeletons

    (Default: Skeletons) Enables/disables streaming of Skeleton tracking data from active Skeleton assets. This includes the total number of bones and their positions and orientations in respect to global, or local, coordinate system.

    Devices

    When enabled, this streams active peripheral devices (ie. force plates, Delsys Trigno EMG devices, etc.)

    Skeleton Coordinates

    (Default: Global) When set to Global, the tracking data will be represented according to the global coordinate system. When this is set to Local, the streamed tracking data (position and rotation) of each skeletal bone will be relative to its parent bones.

    Bone Naming Convention

    (Default: Motive) Sets the bone naming convention of the streamed data. Available conventions include Motive, FBX, and BVH. The naming convention must match the format used in the streaming destination.

    Up Axis

    (Default: Y Axis) Selects the upward axis of the right-hand coordinate system in the streamed data. When streaming onto an external platform with a Z-up right-handed coordinate system (e.g. biomechanics applications) change this to Z Up.

    Remote Trigger

    (Default: False) Allows using the remote trigger for recording using XML commands. See more:

    NatNet Advanced Settings

    Skeleton as Rigid Bodies

    (Default: False) When set to true, Skeleton assets are streamed as a series of Rigid Bodies that represent respective Skeleton segments.

    Subject Prefix

    (Default: True) When set to true, associated asset name is added as a subject prefix to each marker label in the streamed data.

    Visual3D Compatible

    Enables streaming to Visual3D. Normal streaming configurations may be not compatible with Visual3D, and this feature must be enabled for streaming tracking data to Visual3D.

    Scale

    Applies scaling to all of the streamed position data.

    Command Port

    (Default: 1510) Specifies the port to be used for negotiating the connection between the NatNet server and client.

    Data Port

    (Default: 1511) Specifies the port to be used for streaming data from the NatNet server to the client(s).

    Multicast interface

    Specifies the multicast broadcast address. (Default: 239.255.42.99). Note: When streaming to clients based on NatNet 2.0 or below, the default multicast address should be changed to 224.0.0.1 and the data port should be changed to 1001.

    Multicast as Broadcast

    Warning: This mode is for testing purposes only and it can overflood the network with the streamed data.

    When enabled, Motive streams out the mocap data via broadcasting instead of sending to Unicast or Multicast IP addresses. This should be used only when the use of Multicast or Unicast is not applicable. This will basically spam the network that Motive is streaming to with streamed mocap data which may interfere with other data on the network, so a dedicated NatNet streaming network may need to be set up between the server and the client(s).To use the broadcast set the streaming option to Multicast and have this setting enabled on the server. Once it starts streaming, set the NatNet client to connect as Multicast, and then set the multicast address to 255.255.255.255. Once Motive starts broadcasting the data, the client will receive broadcast packets from the server.

    Socket Size

    Warning: Do not modify unless instructed.

    (Default: 1000000)

    This controls the socket size while streaming via Unicast. This property can be used to make extremely large data rates work properly.

    VRPN Streaming Engine

    For information on streaming data via the VRPN Streaming Engine, please visit the . Note that only 6 DOF Rigid Body data can be streamed via VRPN.

    Enabled

    (Default: False) When enabled, Motive streams Rigid Body data via the VRPN protocol.

    Broadcast Port

    [Advanced] (Default: 3883) Specifies the broadcast port for VRPN streaming. (Default: 3883).

    pivot points
    Remote Triggering
    VRPN knowledge base
    Data streaming settings in Motive
    Toolbar AppSettings 20.png

    Settings: Views

    Motive's Views Settings defined.

    Use the Application Settings panel to customize Motive and set default values. This page will cover the items available on the View tab. Properties are Standard unless noted otherwise.

    Please see the following pages for descriptions of the settings on other tabs:

    • Settings: General

    • Settings: Assets

    Application Settings can be accessed from the or by clicking the icon on the main toolbar.

    Advanced Settings

    The Settings panel contains advanced settings that are hidden by default. To access these settings, click the button in the top right corner.

    Use the Edit Advanced option to customize which settings are in the Advanced Settings category and which appear in the standard view, to show only the settings that are needed specifically for your capture application.

    To restore all settings to their default values, select Reset Settings from the Edit menu.

    2D View Settings

    The 2D tab of the Views settings contains display settings for the in Motive. These are all standard settings.

    Background

    (Default: Black) Set the background color of the .

    Back-project Selected Markers

    (Default: On) Display yellow crosshairs in the 2D camera view based on the calculated position of the markers selected in the 3D Perspective View.

    Crosshairs that are not directly over the marker may indicate occlusion or poor camera calibration.

    Show Camera Filters

    (Default: On) When enabled, the Cameras View displays a red graphic over markers filtered out by the camera's circularity and size filters. This is useful for determining why certain cameras are not tracking specific markers in the view.

    3D View Settings

    The 3D tab contains display settings for the in Motive. Settings are Standard unless noted otherwise.

    Basic 3D Settings

    This section contains settings that control the look of the 3D Perspective View. All are standard settings.

    Background

    (Default: black) Set the background color of the Perspective View.

    Fog Effect

    (Default: off) Turn on a gradient “fog” effect.

    Grid Color

    (Default: white) Set the color of the ground plane grid.

    Grid Width

    (Default: 6 meters) Set the width, in meters, of the ground plane grid.

    Grid Length

    (Default: 6 meters) Set the length, in meters, of the ground plane grid.

    Floor Plane

    (Default: off) Display the floor plane in the Perspective View. When disabled, only the floor grid is visible.

    Floor Plane Color

    (Default: gray) Set the color for the floor plane. This option is only available when the Floor Plane setting is enabled.

    Selection Color

    (Default: yellow) Set the color of selected objects in the 3D Viewport. This color is applied to secondary items when multiple items are selected.

    Primary Selection Color

    (Default: cyan) Set the color of the primary selected object in the 3D Viewport. When multiple objects are selected, the primary selection is the object that was selected last.

    Heads Up Display

    Settings in this section determine which informational overlays to include in the 3D Viewport. All settings are standard unless noted otherwise.

    Coordinate Axis

    (Default: on) Display the coordinate axis in the lower left corner. This overlay can also be toggled on or off from the Visuals menu in the 3D Viewport.

    Timecode

    When using an external timecode signal through an eSync device, this setting determines where to display the timecode:

    • Show in 3D View: Display the timecode at the bottom of the 3D Viewport. This is the default setting.

    • Show in Control Deck: Display the timecode in the control deck below the 3D Viewport.

    • Do not Show: Hide the timecode.

    Precision Timestamp (Advanced)

    Determine where to display the timecode for Precision Time Protocol (PTP) devices, if in use:

    • Show in 3D View: Display the PTP timecode at the bottom of the 3D Viewport.

    • Show in Control Deck: Display the PTP timecode in the control deck below the 3D Viewport.

    • Do not Show: Hide the PTP timecode. This is the default setting.

    Marker Details

    (Default: on) Show marker count details in the bottom-right corner:

    • Total markers tracked

    • Total markers selected

    This overlay can also be toggled on or off from the Visuals menu in the 3D Viewport.

    OptiTrack Logo

    (Default: off) Display the OptiTrack logo in the top right corner.

    Frame Rate

    (Default: off) Display the refresh rate in the top left corner.

    Markers

    Settings in this section determine how markers are displayed in the 3D Viewport. All settings are standard unless noted otherwise.

    Size

    (Default: custom) Determine whether markers are represented by the calculated size or overwritten with a set diameter (custom).

    Custom Size

    (Default: 14mm) Determines the fixed diameter of all 3D markers when the marker Size is set to Custom.

    Labeled

    (Default: white) Set the color for labeled markers. Markers labeled using either a Rigid Body or Skeleton solve are colored according to their asset properties.

    Passive

    (Default: white) Set the color for passive markers. Retro-reflective markers or continuously illuminating IR LEDs are recognized as passive markers in Motive.

    Active

    (Default: cyan) Set the color for .

    Intermediate (Advanced)

    (Default: white) Set the color for active markers that have yet to be identified in Motive. The marker color will change to the Active color once the marker is identified.

    To adjust the number of frames it takes for Motive to identify an active marker, go to

    Measurement

    (Default: white) Set the color for measurement points created using the .

    The Measurement Probe is used to collect the x/y/z coordinates of a fixed point in the capture volume that is not linked to a physical marker.

    Solved Asset Marker Opacity

    (Default: 70) Set the opacity level for markers in a solved asset. Lower values reduce the brightness and color of the markers in the 3D Viewport.

    Label Visual

    Determine whether marker labels displayed in the 3D Viewport will include the Asset name (the default setting) or just the marker label name.

    Marker Info

    (Default: off) Display the 3D positions and estimated diameter of selected markers. If the marker label visual is also enabled, the marker info will display at the end of the label.

    Marker History

    (Default: on) Display a trail to show the history of marker positions over time. When the marker is selected, the trail will use the color chosen in the Selection Color setting (yellow by default). The trail for unselected markers will follow the color of the marker itself.

    Only Selected History

    (Default: on) When marker history is selected, this setting restricts the marker history trails to only the markers selected in the 3D Viewport.

    History Length

    (Default: 250) Set the number of past frames to include in the marker history.

    Untracked Stick Opacity

    (Default: 50) Set the opacity level for marker sticks when their markers are not being tracked. Lower values reduce the brightness and color of the sticks in the 3D Viewport.

    Cameras

    Settings in this section determine how cameras are displayed in the 3D Viewport. All settings are standard.

    Tracking

    (Default: teal) Set the color of tracking cameras in the 3D Perspective View. Tracking cameras are set to .

    Reference

    (Default: magenta) Set the color of reference cameras in the 3D Perspective View. Reference cameras are set to capture MJPEG grayscale videos or color videos (Prime Color series).

    Camera Partitions

    (Default: off) Use color to distinguish cameras by partitions rather than function.

    Rays

    Cameras detect reflected rays of infrared light to track objects in the capture volume. Settings in this section determine how camera rays are displayed in the 3D Viewport. All settings are standard unless noted otherwise.

    Tracked

    (Default: green) Set the color for Tracked Rays, which are rays that connect a camera to a marker.

    Unlabeled (Advanced)

    (Default: green) Set the color for rays that are tracked but connect to unlabeled markers.

    Untracked

    (Default: red) Set the color for untracked rays, which are rays that do not connect to a marker.

    All Tracked Rays (Advanced)

    (Default: off) Display all tracked rays. Additional options to display tracked rays are available from the Menu in the 3D Viewport. Click the button and select Tracked Rays to see more.

    Capture Volume

    The 3D Viewport Visual Aids includes an option to view the Capture Volume. Settings in this section determine how the Capture Volume visual displays. All settings are standard.

    Color

    (Default: checkered blue) Set the color used to visualize the capture volume.

    Overlap

    (Default: 3) Set the minimum number of cameras required to form a field of view (FOV) overlap when visualizing the parameters of the capture volume.

    Graphs View Settings

    The Graphs tab under the Views settings contains display settings for the . These are all standard settings.

    Color Scheme

    (Default: dark) Set the color to use for the plot guidelines.

    Background

    (Default: black) Set the background color to use for the plots.

    Autoscale

    (Default: on) When enabled, the y-axis of each plot will autoscale to fit all the data in the view, and zoom automatically for best visualization. For fixed y-plot ranges, this setting can be disabled. See the page for more information.

    Preferred Live Layout

    (Default: none) Preferred used for Live mode. Enter the name of the layout you wish to use exactly as it appears on the layout menu. Both System layouts and User layouts can be used.

    Preferred Edit Layout

    (Default: none) Preferred used for Edit mode. Enter the name of the layout you wish to use exactly as it appears on the layout menu. Both System layouts and User layouts can be used.

    Graph layouts are .xml files saved in C:\ProgramData\OptiTrack\Motive\GraphLayouts.

    You can copy the .xml files to your project folders for sharing and later use. Copy them back into the GraphLayouts folder when needed to make them available in Motive.

    Scope Duration

    (Default: 1000) The scope, in frames, of the domain range used for plotting graphs.

    Settings: Live Pipeline
    Settings: Streaming
    Settings: Mouse and Keyboard
    Settings: Audio
    View menu
    Cameras View
    Camera View
    Perspective View
    active markers
    Settings -> Live Pipeline -> Solver -> Live Pipeline Presets -> Active Pattern.
    Measurement Probe
    Object mode or Precision mode
    Visual Aids
    Graph Pane
    Graph View pane
    graph layout
    graph layout
    Show or Edit Advanced Settings.
    2D view settings from the Application Settings panel.
    Markers selected in the perspective view are marked with yellow crosshairs in the Cameras view.
    Reflection in Object mode that did not pass the Circle Filter.
    Grayscale view of the filtered reflection.
    3D view settings from the Application Settings panel.
    Applications Settings: Views - 3D Tab Heads Up Display.
    Applications Settings: Views - 3D Tab, Markers settings.
    A Solved Rigid Body with Marker History displayed for the selected marker.
    Applications Settings: Views - 3D Tab, Cameras settings.
    Applications Settings: Views - 3D Tab, Rays settings.
    Applications Settings: Views - 3D Tab, Capture Volume settings.
    Applications Settings: Views - Graph Tab, All settings.
    Applications Settings: Views - Graph Tab, with Preferred Layouts selected.
    Plotting 6 DoF data for a Rigid Body in the Graph View pane.

    Settings: Live Pipeline

    Motive's Live Pipeline Settings defined.

    Overview

    Use the Application Settings panel to customize Motive and set default values. This page will cover the items available on the Live Pipeline tab. Properties are Standard unless noted otherwise.

    Solver settings for recorded captures:

    Please note that these settings apply only to Live 3D data. To optimize the solver settings for captures that are already recorded, adjust the solver values from the of the corresponding TAK file.

    Live Pipeline settings contain camera filter and solver settings for obtaining 3D data in Motive. These settings are optimized by default to provide high-quality tracking for most applications.

    Please see the following pages for descriptions of the settings on other tabs:

    • ​​

    • ​

    Application Settings can be accessed from the or by clicking the icon on the main toolbar.

    Advanced Settings

    The Settings panel contains advanced settings that are hidden by default. To access these settings, click the button in the top right corner.

    Use the Edit Advanced option to customize which settings are in the Advanced Settings category and which appear in the standard view, to show only the settings that are needed specifically for your capture application.

    To restore all settings to their default values, select Reset Settings from the Edit menu.

    Solver Settings

    Solver settings control how each marker's trajectory is reconstructed into the 3D space and how Rigid Bodies, Skeletons, and Trained Markersets track. The solver is designed to work for most applications using the default settings. However, in some instances, changing settings will lead to better tracking results.

    The standard settings are those most likely to be customized by the user. We recommend exercising caution before making adjustments to any Solver advanced settings.

    General Solver Settings

    Live Pipeline Presets

    Live Pipeline Presets provide an easy way to switch between the default (Motive) and custom solver settings, such as the With Reconstruction Bounds preset.

    Click the drop down to select a new preset or to Import, Save, or Delete existing configurations. Presets are saved as .MOTIVE files in:

    C:\ProgramData\OptiTrack\Motive\LiveReconstructionSettings

    • Import Preset: Allows the user to browse to a previously-saved preset .MOTIVE file in another location on the local computer or on a network drive.

    DoF Prediction Percent (Advanced)

    Controls the deceleration of the asset joint angles in the absence of other evidence. For example, a setting of 60% will reduce the velocity by 99% in 8 frames; whereas 80% will take 21 frames to get to the same velocity reduction.

    IK Iterations

    Sets the number of inverse kinematic (IK) solve iterations to perform for a skeleton to get to the final pose in each frame when the skeleton is tracking continuously. Note that larger numbers increase the CPU usage and increase batch processing times.

    See the advanced property to set the number of iterations when the skeleton is booting.

    In recorded captures, this property may need to be changed, under the , if the recording starts with actors who are not in standing-up positions or if any are difficult to solve. When this is the case, Skeletons may not solve in the first couple of frames. Increasing this value will allow the Skeletons to converge on the first frame.

    Residual Threshold (Advanced)

    The residual is the distance between a Marker Constraint and its assigned trajectory. If the residual exceeds this threshold, then that assignment will be broken. A larger value helps catch rapid acceleration of limbs, for example.

    Reconstruction Bounds

    These properties are only available when Advanced settings are displayed.

    Enable

    Ignores reconstructed 3D points outside of the reconstruction bounds.

    Show Bounds

    Adds a visual display to the 3D Viewport that shows the limits of the reconstruction bounds.

    Shape

    This setting establishes the general shape of the reconstruction bounds. Options are:

    • Cuboid

    • Cylinder

    Additional Reconstruction Bound Settings

    The rest of the settings in this section can be modified in relation to center, width, radius, and height.

    Trajectorizer

    The Trajectorizer settings control how the 2D marker data is converted into 3D points in the calibrated volume. The Trajectorizer performs reconstruction of 2D data into 3D data, and these settings control how markers are created in the 3D scene over time.

    3D Acceleration Threshold
    • What it does: This setting controls the maximum distance between a marker trajectory and its predicted position.

    • When to change: This setting may need to be increased when tracking extra fast assets. The default setting should track most applications. Attempt to track with default settings first, and if there are any gaps in the marker trajectories, you can incrementally increase the distance until stable tracking is achieved.

    3D Marker Threshold

    This setting controls the maximum distance between a ray and the marker origin.

    3D Merge Threshold (Advanced)

    Two marker trajectories discovered within this distance are merged into a single trajectory.

    2D Threshold (Advanced)

    A marker trajectory is predicted on a new frame and then projected in all the cameras. To be assigned to a marker detection in a particular camera, the distance (in pixels) must not exceed this threshold.

    2D Marker Threshold (Advanced)

    The maximum number of pixels between a camera detection and the projection of its marker.

    Angle Threshold (Advanced)

    The new marker trajectory is generated at the intersection of two rays through detections in different cameras. Each detection must be the only candidate within this many pixels of the projection of the other ray.

    Marker Prediction Percent (Advanced)

    Marker trajectories are predicted on the next frame to have moved with this percentage of their velocity on the previous frame.

    Skeleton Reversion Percent (Advanced)

    When a Skeleton marker trajectory is not seen, its predicted position reverts towards its assigned Marker Constraints by this percentage.

    Rigid Body Reversion Percent (Advanced)

    When a Rigid Body marker trajectory is not seen, its predicted position reverts towards its assigned Marker Constraints by this percentage.

    Minimum Rays to Start
    • What it does: This sets the minimum number of that need to converge on one location to create a new marker in 3D. This is also the minimum number of calibrated cameras that see the same target marker within the 3D threshold value for them to initially get trajectorized into a 3D point.

    • When to change: For large volumes with high camera counts, increasing this value may provide more accurate and robust tracking. The default value of 3 works well with most medium and small-sized volumes. For volumes that only have two cameras, the trajectorizer will use a value of 2 even when it's not explicitly set.

    Minimum Rays to Continue
    • What it does: This sets the minimum number of rays that need to converge on one location to continue tracking a marker that already initialized near that location. A value of 1 will use asset definitions to continue tracking markers even when a 3D marker could not have been created from the camera data without the additional asset information.

    • When to change: This is set to 1 by default. It means that Motive will continue the 3D data trajectory as long as at least one ray is obtained and the asset definition matches. When single ray tracking is not desired or for volumes with a large number of cameras, change this value to 2 to utilize camera overlaps in the volume.

    Active Pattern Depth
    • What it does: This setting is used for tracking active markers only. It sets the number of frames of motion capture data used to uniquely identify the ID value of an active marker.

    • When to change: When using a large number of active tags or active pucks, this setting may need to be increased. We recommend using the active batch programmer when configuring multiple active components, and when each batch of active devices has been programmed, the programmer will provide a minimum active pattern depth value that should be used in Motive.

    Minimum Active Count (Advanced)
    • What it does: The total number of rays that must contribute to an active marker before it is considered active and given an ID value.

    • When to change: Change this setting to increase the confidence in the accuracy of active marker ID values (not changed very often).

    Maximum Fill Frames
    • What it does: The number of frames of data that the solver will attempt to fill if a marker goes missing for some reason. This value must be at least 1 if you are using active markers.

    • When to change: If you would like more or fewer frames to be filled when there are small gaps.

    Booter

    The Booter settings control when the assets start tracking, or boot, on the trajectorized 3D markers in the scene, which determine when Rigid Bodies and/or Skeletons track on a set of markers.

    Missing Marker Penalty Value (Advanced)

    The penalty for leaving Marker Constraints unassigned (per label graph edge).

    Boot Residual Threshold (Advanced)

    The maximum average distance between the marker trajectory and the Marker Constraints before the asset is rebooted.

    • What it does: This controls the maximum distance between a pair of Marker Constraints to be considered as an edge in the label graph.

    • When to change: The default settings should work for most applications. This value may need to be increased to track large assets with markers that are far apart.

    Boot Skeleton Label Percent
    • What it does: This sets the percentage of Skeleton markers that need to be trajectorized in order to track the corresponding Skeleton(s). If needed, this setting can also be configured per each asset from the corresponding asset properties using the .

    • When to change: The default settings should work for most applications. Set this value to about 75% to help keep Skeletons from booting on other markers in the volume if there are similar Skeleton definitions or lots of loose markers in the scene. If you would like Skeletons to boot faster when entering the volume, then you can set this value lower.

    Boot Residual Percent (Advanced)

    This value controls how willing an asset is to boot onto markers. A higher value will make assets boot faster when entering the volume. A lower value will stop assets from booting onto other markers when they leave the volume.

    Boot IK Iterations (Advanced)

    Sets the number of inverse kinematic (IK) solve iterations to perform for a skeleton to get to the final pose when the skeleton is booting or has been occluded or otherwise left and re-entered the scene. Note that larger numbers increase the CPU usage and increase batch processing times.

    See the standard property to set the number of iterations when the skeleton is already tracking.

    In recorded captures, this property can be changed under the , if the recording starts with actors who are not in standing-up positions or if any are difficult to solve. When this is the case, Skeletons may not solve in the first couple of frames. Increasing this value will allow the Skeletons to converge on the first frame.

    Boot Max Assets (Advanced)

    The maximum number of assets to boot per frame.

    Cameras Settings

    This Cameras tab of the Live Pipeline settings is used to configure the filter properties for all the cameras in the system.

    General Cameras Settings

    Live Pipeline Presets

    Live Pipeline Presets provide an easy way to switch between the default (Motive) and custom solver settings, such as the With Reconstruction Bounds preset.

    Click the drop down to select a new preset or to Import, Save, or Delete existing configurations. Presets are saved as .MOTIVE files in:

    C:\ProgramData\OptiTrack\Motive\LiveReconstructionSettings

    • Import Preset: Allows the user to browse to a previously-saved preset .MOTIVE file in another location on the local computer or on a network drive.

    Mask Padding (Advanced)

    Changes the padding around masks by pixels.

    Shutter Offset (Advanced)

    Delay this group from sync pulse by this amount.

    Synchronizer Control (Advanced)

    Controls how the synchronizer operates. Options include:

    • Force Timely Delivery

    • Favor Timely Delivery

    Camera Filters - Software

    Filter Type (Advanced)

    Choose the filter type. Options include:

    • Size and Roundness

    • None

    Minimum Pixel Threshold

    Establishes the minimum pixel size of a 2D object (a collection of pixels grouped together) for the object to be included in the Point Cloud reconstruction.

    All pixels must first meet the brightness threshold defined in the Cameras pane in order to be grouped as a 2D object. This setting can be used to filter out small reflections that are flickering in the view. The default value for the minimum pixel size is 4, which means that there must be 4 or more pixels in a group for a ray to be generated.

    Maximum Pixel Threshold (Advanced)

    The maximum allowable size of the 2D object (pixels over threshold).

    Circularity

    This property sets the threshold of the circularity filter. Valid range is between 0 and 1; with 1 being a perfectly round reflection and 0 being flat.

    Using this 2D object filter, the software identifies marker reflections based on the shape, specifically the roundness, of the group of thresholded pixels. A higher circularity setting will filter out all other reflections that are not circular. We recommend optimizing this setting so that extraneous reflections are efficiently filtered out while true marker reflections are not.

    When using lower resolution cameras to capture smaller markers at a long distance, the marker reflection may appear to be more pixelated and non-circular. In this case, you may need to lower the circularity filter value for the reflection to be considered a 2D object from the camera view. This setting may also need to be lowered when tracking non-spherical markers in order to avoid filtering those reflections.

    Camera Filters - Hardware

    The Camera Filters - Hardware section is shown only when the advanced settings are displayed.

    Intrusion Band

    The size of the guard region beyond the object margin for neighbor detection.

    Grayscale Floor

    The pixel intensity of the grayscale floor (pixel intensity).

    Object Margin Diameter

    The minimum space (in pixels) between objects before they begin to overlap.

    Object Skew

    The number of pixels a 2D object is allowed to lean.

    Max Aspect Tolerance

    The maximum allowable aspect tolerance to process a 2D object (width:height).

    Aspect Base

    The allowable aspect tolerance for very small objects.

    Aspect Step Size

    The rate at which the aspect tolerance relaxes as object size increases.

    Toolbar AppSettings 20.png

    ​Settings: Mouse and Keyboard​

  • ​Settings: Audio​

  • Save Preset: Saves the current configuration as a new .MOTIVE file. If the file is saved in the Presets folder, it will appear in the top section of the drop down list.

  • Delete Preset: Removes obsolete presets from the list and deletes the .MOTIVE file.

  • Open Presets Folder: Opens the Presets folder in an Explorer window for direct file management. Use this option if you wish to move files in bulk or to save old presets in an alternate location.

  • Spherical
  • Ellipsoid

  • Save Preset: Saves the current configuration as a new .MOTIVE file. If the file is saved in the Presets folder, it will appear in the top section of the drop down list.

  • Delete Preset: Removes obsolete presets from the list and deletes the .MOTIVE file.

  • Open Presets Folder: Opens the Presets folder in an Explorer window for direct file management. Use this option if you wish to move files in bulk or to save old presets in an alternate location.

  • Force Complete Delivery
    properties
    Settings: General
    ​Settings: Assets​
    ​Settings: Streaming​
    Settings: Views​
    View menu
    Boot IK Iterations
    TAK properties
    tracked rays
    Properties pane
    IK Iterations
    TAK properties
    A screenshot of the menu options available in the Settings panel.
    Show or Edit Advanced Settings.
    A screenshot of the Settings panel, Live Pipeline section, Solver Tab - basic settings only.
    Basic Live Pipeline Solver settings.
    A screenshot of the standard and advanced settings available in the General section of the Live Pipeline settings.
    Basic and Advanced General settings on the Live Pipeline Solver tab.
    A screenshot of the Live Pipeline Preset solver options from the Motive Settings panel, Live Pipeline settings.
    A screenshot of the advanced settings available in the Reconstruction Bounds section of the Live Pipeline settings.
    Advanced Reconstruction Bounds settings on the Live Pipeline Solver tab.
    A screenshot of the standard and advanced settings available in the Trajectorizer section of the Live Pipeline settings.
    Basic and Advanced Trajectorizer settings on the Live Pipeline Solver tab.
    A screenshot of the Booter section of the Advanced Solver properties on the Live Pipeline tab of the Motive Application settings panel.
    Basic and Advanced Booter settings on the Live Pipeline Solver tab.
    A screenshot of the Basic settings on the Cameras tab of the Live Pipeline section of the Motive application settings panel.
    Basic Live Pipeline Cameras settings.
    A screenshot of the Advanced General settings on the Cameras tab of the Live Pipeline section of the Motive application settings panel.
    Basic and Advanced General settings on the Live Pipeline Cameras tab.
    A screenshot of the Live Pipeline Preset solver options from the Motive Settings panel, Live Pipeline settings.
    A screenshot of the Advanced Camera Filters - Software settings on the Cameras tab of the Live Pipeline section of the Motive application settings panel.
    Basic and Advanced Camera Filters - Software settings on the Live Pipeline Cameras tab.
    A screenshot of the 2D Camera view, showing reflections that do not meet the minimum circularity filter.
    The circle filter omitting non-circular reflections from a 2D camera view.
    A screenshot of the Advanced Camera Filters - Hardware settings on the Cameras tab of the Live Pipeline section of the Motive application settings panel.
    Basic and Advanced Camera Filters - Hardware settings on the Live Pipeline Cameras tab.
    A screenshot of the Settings button in Motive.
    A screenshot of the Menu button in Motive.
    Toolbar AppSettings 20.png
    Toolbar Stream 20.png