Motive 2.1 beta is now available. Please check the documentation versions on the sidebar.

Application Settings


Main page


In Motive, the Application Settings can be accessed under the View tab or by clicking Toolbar AppSettings 20.png icon on the main toolbar.

Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main Toolbar.

ApplicationSettings 20.png


General[edit]


Misc[edit]

AppSet GeneralMisc 20.png

Take Suffix Format String[edit]

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

Numeric LEDs[edit]

Enable or disable the LED panel in front of cameras that displays assigned camera numbers.

Auto Archive Takes[edit]

Enable/Disable auto-archiving of Takes when trimming Takes

Save Data Folder[edit]

Motive persists all of the session folders that are imported into the Data pane so that the users don't have to re-import them again after closing out of the application. If this is set to false, the session folders will no longer be persisted, and only the default session folder will always be loaded.

Startup Options[edit]

AppSet Startup 20.png

Restore Calibration[edit]

Automatically loads the previous, or last saved, calibration setting when starting Motive.

Camera ID[edit]

Sets how Camera IDs are assigned for each camera in a setup. Available options are By Location and By Serial Number. When assigning by location, camera IDs will be given following the positional order in clockwise direction, starting from the -X and -Z quadrant in respect to the origin.

Device Profile[edit]

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

Aim Assist Button[edit]

ApplicationSettings Options CameraButton.png

Switch to MJPEG[edit]

Configures the Aim Assist button. Sets whether the button will switch the camera to MJPEG mode and back to the default camera group record mode. Valid options are: True (default) and False.

Aiming Crosshairs[edit]

Sets whether the camera button will display the aiming crosshairs on the MJPEG view of the camera. Valid options are True (default), False.

Aiming Button LED[edit]

Enables or disables LED illumination on the Aim Assist button behind Prime Series cameras.

Camera Status Ring[edit]

AppSet CameraStat.png

Controls the color of the RGB Status Indicator Ring (Prime Series cameras only). Options include distinct indications for Live, Recording, Playback, Selection and Scene camera statuses, and you can choose the color for the corresponding camera status.

Live Color[edit]

(Default: Blue) Sets the indicator ring color for cameras in Live mode. Default: Blue

Recording Color[edit]

(Default: Red) Sets the indicator ring color for cameras when recording a capture.

Playback Color[edit]

(Default: Black) Sets the indicator ring color for cameras when Motive is in playback mode.

Selection Color[edit]

(Default: Yellow) Sets the indicator ring color for cameras that are selected in Motive.

Scene Camera[edit]

(Default: Orange) Sets the indicator ring color for cameras that are set as the reference camera in Motive.

Networking[edit]

ApplicationSettings Options Networking.png

LLDP (PoE+) Detection[edit]

Enables detection of PoE+ switches by High Power cameras (Prime 17W and Prime 41). 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 the high power mode even with this setting enabled.

Strobe On During Playback[edit]

Keeps the camera IR strobe on at all times, even during the playback mode.

View[edit]


2D Display Options[edit]

ApplicationSettings Display 2Ddisp.png

Camera Health Info[edit]

Displays various assessments of camera health over the 2D camera views, for troubleshooting performance issues. If any performance issues is detected, corresponding problem will be listed at the bottom of the 2D camera view.

Reticles[edit]

When enabled, renders a crosshair on top of the 2D camera views, which can be useful for camera aiming.

Masks[edit]

Enables displaying masked area on the 2D camera views, in red.

Backproject Markers[edit]

Enables markers selected from the 3D Perspective View to be also highlighted with yellow crosshairs in the 2D camera view, based on calculated position. Crosshairs that are not directly over the marker tend to indicate occlusion or poor camera calibration.

Marker Filter[edit]

When enabled, filtered reflections will be labeled with the corresponding object filters in the 2D camera view.

Marker Coordinates[edit]

Displays 2D coordinate of the detected object centroids within the captured image, in pixels.

Marker Centroids[edit]

Displays crosshairs on marker centroids in the 2D view.

Marker Boundaries[edit]

Displays a box around each marker, indicating its calculated edges after the birghtness threshold.

Marker Circularity[edit]

Displays the roundness of an object. A value of 1 indicates maximum roundness, while a value of 0 indicates no roundness.
Pixel inspector enabled in 2D view

Marker Aspect Ratio[edit]

Displays the ratio of object width to object height as a decimal, resolved to .01 pixel.

Marker Size[edit]

Displays the area of the object in pixels, accurate to .01 pixel.

Marker Label[edit]

Displays the pre-identified labels assigned to 2D objects for initial tracking from frame to frame.

Pixel Inspection[edit]

Displays X,Y coordinates for cursor location when hovering over a camera, and pixel brightness for selected pixels when a region is drag-selected. Inspecting pixel brightness can be useful during camera focusing, tuning, and aiming.

Visual FPS Target[edit]

Sets a maximum frame display rate for the 2D camera view.

Background Color[edit]

Selects the color to display in the viewport between camera panes.

Camera Info[edit]

Enables text overlay of pertinent camera information on the 2D Multi Camera view panes. Displayed information includes image mode, time, data rate, frame ID, visual FPS, number of objects, camera serial, exposure value, threshold value, IR intensity value, internal temperature, and camera sync mode.

Distortion Map[edit]

ApplicationSettings Display Distortion.png

Show Distortion[edit]

Displays each camera’s lens distortion map.

Overlay Color[edit]

Selects the color of the lens distortion map display.

Overlay Transparency[edit]

Selects the transparency percentage for the lens distortion map.

Overlay Resolution[edit]

Selects the level of details for displaying the lens distortion. More specifically, it sets number of distortion grids on the width and height of the distortion map.

Show as Predistortion[edit]

Selects whether the map is shown as predistorted or distorted.

Multi-Camera 2D Display[edit]

ApplicationSettings Display Multi.png

Display Mode[edit]

Sets levels of details for the markers displayed in the multi-camera 2D view. Available modes are Frame Buffer, Marker Centers, and Automatic LOD modes. Default is Automatic LOD.
  • Automatic LOD switches between Frame Buffer mode and Marker Centers mode depending on the zooming of the 2D camera view, or the LOD threshold setting.
  • Frame Buffer mode pushes the entire camera frame to the video card for scaling and display. It provides verbose information on detected reflections and centroids, but it is data intensive at the same time.
  • Marker centers mode merely defines a white circle of the rough size and shape of the marker as it would appear. More specifically, it displays the reflections by its size and location and is significantly less hardware intensive.

Pane Gap[edit]

The distance between 2D Multi View camera panes, in pixels.

LOD Threshold[edit]

The size, zoom percentage, at which the system switches between Marker Centers and Frame Buffer mode.

Raster Priority[edit]

Defines the update rate for the camera pixel data shown in the 2D camera views. The priority value ranges from 1 - 6, and a higher priority indicates a higher rate of update.

3D Display Options[edit]

ApplicationSettings Display 3Ddisp.png

Camera Names[edit]

Displays the camera model, serial, and master/slave status above and below camera objects.

Text Size[edit]

Adjusts the size of the camera name text.

Solid Cameras[edit]

Setting this to true disables camera object transparency in the 3D Perspective View.

Labeled Marker Color[edit]

Sets the color for labeled markers in the 3D view port.

Active Marker Color[edit]

Sets the color for active markers in the 3D viewport.

Unlabeled Marker Color[edit]

Sets the color for Unlabeled markers in the 3D view port.

Marker History[edit]

Displays a history trail of marker positions over time.

Selected History Only[edit]

Determines whether marker history will be shown for selected markers or all markers.

Show Marker Count[edit]

Displays the number of markers detected by the system as well as the number of markers selected at the bottom right corner of the perspective view.

Show Marker Labels[edit]

Displays marker labels for selected markers in the perspective view.

Display mode[edit]

Toggles camera numbers on and off in the 3D Perspective View.

Marker Diameter[edit]

Determines whether marker sizes in the 3D Perspective View are represented by the calculated size or overwritten with a set diameter.

Background Color[edit]

Selects the background color displayed in the 3D Perspective View.

Fog Effect[edit]

Turns a gradient “fog” effect on in the 3D Perspective View.

Diameter (mm)[edit]

Sets the diameter in millimeters for marker sizes in the 3D Perspective View, if Marker Diameter is set to Set Diameter.

[edit]

Overlays the OptiTrack logo over top of the 3D Perspective View.

Grid Color[edit]

Selects the color of the ground plane grid in the 3D Perspective View.

Grid Transparency[edit]

Selects the level of transparency applied to the ground plane grid in the 3D Perspective View.

Grid Size[edit]

Selects the size of the ground plane grid in the 3D Perspective View. Specifically, it sets the number of grids (20cm x 20cm) along the positive and negative direction in both the X and Z axis.

Coordinate Axis[edit]

Displays the coordinate axis in the 3D view port.

Video Overlay Display FPS[edit]

Controls of often scene video overlays are updated for display.

Undistort Video Overlay[edit]

Removes distortions from the grid when displaying the video distortion overlay in the reference video.

Show Tracked Rays[edit]

Displays tracked rays in the view port. Tracked rays are marker rays with residual values less than the Maximum Residual setting from the reconstruction pane. In other words, tracked rays are marker rays that are contributing to 3D reconstructions.

Show Untracked Rays[edit]

Displays the untracked rays in the view port. Untracked rays are the rays which start from each camera and goes through the detected 2D centroids, but fails to be reconstructed in the 3D space. When there are several untracked rays in the capture, it is usually a sign of bad calibration or extreme reconstruction settings.

Show Missing Rays[edit]

Displays the missing rays in the view port. Missing rays form when tracking a rigid body or a skeleton, and it indicates expected marker rays that are not detected from the camera view but expected from the rigid body or the skeleton solve.

Show Two Marker Distance[edit]

Enabling this will display distance between two markers in the Perspective View pane. Two markers must be selected to calculate the distance.

Show Three Marker Angle[edit]

Enabling this will measure an angle formed by three markers in the Perspective View pane. Three markers must be selected, and the calculated angle will follow the selection order. When all three markers are selected at once, the widest angle will be measured.

Show Marker Sticks[edit]

Setting this to true will show marker sticks on skeleton assets for clearer identification of skeleton markers and segments in each individual actor. Setting this to true will reveal marker sticks in 3D data.

Show Marker Colors[edit]

When labeled, each skeleton marker is colored as defined in the corresponding markerset template. Enabling this setting will color the markers for better identification of the marker labels.

Ray Options[edit]

ApplicationSettings Display Ray.png

Show Selected Residual[edit]

Displays the offset distance between rays converging into a marker. The residual value will be displayed on top of the view pane. Note that ray information will be displayed only in the 2D data.

Tracked Ray Color[edit]

Sets the color for Tracked Rays in the 3D Perspective View.

Untracked Ray Color[edit]

Sets the color for untracked Rays in the 3D Perspective View.

Missing Ray Color[edit]

Sets the color for Missing Rays in the 3D Perspective View.

Tracked Ray Transparency[edit]

Sets the level of transparency for Tracked Rays.

Untracked Ray Transparency[edit]

Sets the level of transparency for Untracked Rays.

Missing Ray Transparency[edit]

Sets the level of transparency for Missing Rays.

Missing Ray Threshold[edit]

Sets the distance in millimeters that a 2D marker must be from an expected location before declaring the marker missing.

Graphs[edit]

AppSet DisplayGraph.png

Color Scheme[edit]

Toggles the theme for the timeline playback graph between light and dark.

Background Color[edit]

Specifies the background color for the timeline playback graph.

Scope[edit]

(Deprecated)

Autoscale[edit]

Automatically scales trajectory graphs in the Timeline pane.

Reference View Options[edit]

AppSet ReferenceView.png

Show Markers[edit]

Overlays markers in the reference video when this setting is set to true.

Show Skeletons[edit]

Overlays skeletons in the reference video when this setting is set to true.

Show Rigid Bodies[edit]

Overlays rigid bodies in the reference video when this setting is set to true.

Show Distortion Grid[edit]

Displays reference camera distortion grid in the reference view.

Lock Aspect Ratio[edit]

Keeps the aspect ratio constant for reference videos.

Split Horizontal[edit]

When set to true, multiple reference view is divided into multiple columns in the reference view pane.

Skeletons[edit]


A list of the default rigid body creation properties is listed under the Skeletons tab. Thes properties are applied to only skeleton assets that are newly created after the properties have been modified.

Info2.png

Note that this is the default creation properties. Asset specific skeleton properties are modified directly from the Properties pane.

Skeleton Properties


Default Skeleton Display Settings[edit]

Skeleton[edit]

Toggle between visible and hidden to change visibility of a newly created skeleton.

Segments[edit]

Toggle between visible and hidden to change the visibility of skeleton segments from a newly created skeleton.

Segment Color[edit]

Set the skeleton segment color for a newly created skeleton.

Specular Color[edit]

Set the skeleton specular color for a newly created skeleton.

Specular Power[edit]

Sets the intensity of specular colors on a newly created skeleton.

Rim Light Intensity[edit]

Controls the strength of the glowing edge effect of the skeleton model.

Rim Light Start[edit]

Sets the starting range for skeleton rim lights.

Rim Light End[edit]

Sets the ending range for skeleton rim lights.

Rim Light Color[edit]

Sets the color for skeleton rim lights.

Avatar[edit]

Show or hide an avatar for the skeleton.

Bones[edit]

Show or hide skeleton bones.

Bone Color[edit]

Sets the color of bones when Bones are visible

Show Markers[edit]

Show or hide the expected marker locations for skeletons

Marker Color[edit]

Sets the color of expected marker locations

Show Label[edit]

Shows skeleton label.

Show Segment Axes[edit]

Displays orientation axes of each segments in the skeleton.

Show Target Marker Lines[edit]

Displays a line between actual markers and related expected marker locations.

Show Tracking Errors[edit]

Changes color of skeleton segments with errors.

Skeleton Create Pose Settings[edit]

Skeleton Creation Pose[edit]

Chooses which Skeleton calibration pose to be used for creation. (T-pose, A-pose Palms Downward, A-pose Palms Forward, and A-pose Elbows Bent)

Head Upright[edit]

Creates the skeleton with heads upright irrespective of head marker locations.

Straight Arms[edit]

Creates the skeleton with arms straight even when arm markers are not straight.

Straight Legs[edit]

Creates the skeleton with straight knee joints even when leg markers are not straight.

Feet On Floor[edit]

Creates the skeleton with feet planted on the ground level.

Height Marker[edit]

Force the solver so that the height of the created skeleton aligns with the top head marker.

Rigid Bodies[edit]


A list of the default rigid body creation properties is listed under the Rigid Bodies tab. Thes properties are applied to only rigid bodies that are newly created after the properties have been modified.

Info2.png

Note that this is the default creation properties. Asset specific rigid body properties are modified directly from the Properties pane.

Rigid Body Properties


General Settings[edit]

Rigid body properties listed under the Properties pane

Name[edit]

Allows a custom name to be assigned to the rigid body. Default is "Rigid Body X" where x is the Rigid Body ID.

Active[edit]

Enables/Disables tracking of the selected rigid body. Disabled rigid bodies will not be tracked, and its data will not be included in the exported or streamed tracking data.

Streaming ID[edit]

User definable ID for the selected rigid body. When working with capture data in the external pipeline, this value can be used to address specific rigid bodies in the scene.

Min Marker Count[edit]

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

Max Deflection[edit]

The maximum distance, in millimeters, that a marker may deviate from its expected position before it is not considered as a part of the rigid body. Lower deflection settings force the solver to be more strict with marker positions, creating a more accurate solve but with a higher risk of gaps in the data. Higher deflection settings can allow for more continuous data, but with the potential for less accuracy in the rigid body tracking.

Smoothing[edit]

Applies double exponential smoothing to translation and rotation of the rigid body. Increasing this setting may help smooth out noise in the rigid body tracking, but excessive smoothing can introduce a lag. Valid range is 0 to 100. Default is 0 (disabled).

Forward Prediction[edit]

Compensate for system latency when tracking of the corresponding rigid body by predicting its movement into the future. The unit of the input is in milliseconds. Please note that predicting further into the future may impact the tracking stability.

Tracking Algorithm[edit]

Tracking Algorithm determines the way rigid bodies are tracked.
  • Auto-Select: Depending on the system camera count, Motive determines whether to use the marker-based tracking or the the ray-based tracking. For systems with fewer than 5 cameras, or the Duo/Trio Tracking Bars, ray based tracking is used. For systems with higher camera counts, marker based tracking is used.
  • Marker Based: Standard marker based tracking. It uses 3D coordinates obtained by the Point Cloud reconstruction to solve position and orientation of the rigid body.
  • Ray Based: In addition to the standard marker tracking, ray based tracking also utilizes untracked rays and rigid body definitions to solve for the position and orientation of the rigid body. In other words, when a marker is occluded because it did not satisfy the minimum required number of the tracked rays, this tracking algorithm can utilize the remaining untracked rays and the corresponding rigid body asset definition to provide more stable tracking of the rigid body. In order to utilize the Ray Based tracking, the Use Smart Markers setting must be enabled under reconstruction settings. Ray-based tracking is NOT supported for active markers

Enhance Performance[edit]

Localizes rigid body searching algorithm. It is recommended to enable this setting for each rigid body when tracking a high number of objects.

Share Markers[edit]

[Advanced] Allow markers of this rigid body to be used by other rigid bodies.

Unique[edit]

[Advanced] Indicates that this rigid body marker arrangement is not identical to another defined rigid body. When the tracked rigid body has a unique marker placement, setting this to true can improve tracking stability.

Jump Prevention[edit]

[Advanced] When enabled, this setting prevents sudden displacements, or jumps, in the position of the rigid body. This is enabled by default to allow stable tracking. For tracking fast movements (e.g. baseball bat swing), this needs to be disabled.

Calculation Time[edit]

[Advanced] Maximum amount of time to solve the rigid body per frame (ms).

Acquisition Delay[edit]

[Advanced] While rigid body is untracked, only search the Point Cloud every Nth frame.

Static Constraints[edit]

Orientation constraints configuration.

This feature is used to limit rotation of rigid body assets.

To use this, first create the rigid body while the object is in the desired orientation. Then set the Angle value for positive and negative rotation boundaries. After the angle value is defined, change the X/Y/Z values to 1 in order to apply the orientation constraints to only allow the axis to be oriented within the cone shaped boundaries.

For example, if a 30 degree constraint is applied to Y-axis of the rigid body, rotations only up to +/- 30 degrees about the X and Z axes of the rigid body will be allowed, creating a cone-shaped allowed range of rotation with respect to the Y-axis. When the rigid body rotates beyond this boundary, the markers will be unlabeled.

Example: +/-30 degrees of rotation constraint applied about Y-axis

Enforce[edit]

Enable static constraints.

X[edit]

X component of unit vector cone of allowable orientations. No restrictions when set to 0.

Y[edit]

Y component of unit vector cone of allowable orientations. No restrictions when set to 0.

Z[edit]

Z component of unit vector cone of allowable orientations. No restrictions when set to 0.

Angle[edit]

Maximum allowable angular deflection +/- of the unit cone vector (degrees).

Display Settings[edit]

Rigid body asset display properties.
Choosing color for a rigid body.

Color[edit]

Color of the selected rigid body in the 3D Perspective View. Clicking on the box will bring up the color picker for selecting the color.

Label[edit]

Selects whether or not to display the rigid body name in the 3D Perspective View. If selected, a small label in the same color as the rigid body will appear over the centroid in the 3D Perspective View.

Tracked[edit]

Selects whether or not to show the rigid body in the 3D Perspective View when it is tracked.

Untracked[edit]

Selects whether or not to show the last known position of a rigid body in the 3D Perspective View after tracking has been lost. If enabled, the rigid body will appear somewhat remain frozen in the last known position before tracking was lost, until tracking is regained.

Pivot[edit]

Selects whether the pivot point of the rigid body is displayed.

Untracked Markers[edit]

When enabled, all markers that are part of the rigid body definition will be dimmed, but still visible, when not present in the point cloud.

Quality[edit]

Enabling will turn the connecting lines between markers in a rigid body red as the distance between the markers deviates from what was defined during the rigid body creation.

Marker Quality[edit]

Enables ranking of markers and highlights those with higher residuals in red. This setting can be useful in determining marker detection quality and troubleshooting issues based on detection.

Orientation[edit]

Enables the display of a rigid body's local coordinate axes. This option can be useful in visualizing the orientation of the rigid body, and for setting orientation offsets.

Position History[edit]

Shows a history of the rigid body’s position.

Orientation History[edit]

Shows a history of the rigid body’s orientation.

Model Replace[edit]

When a valid geometric model is loaded in the Attached Geometry section, the model will be displayed instead of a rigid body when this entry is set to true.

Attached Geometry[edit]

Loads the OBJ file to replace the rigid body. Scale, positions, and orientations of the attached geometry can be configured under the following Default Attached Geometry section. When a OBJ file is loaded, properties configured in the corresponding MTL files is loaded as well.

Attached Geometry[edit]

A OBJ file of a basketball attached to a rigid body.

Pivot Scale[edit]

Adjusts the size of the rigid body pivot point.

Scale[edit]

Rescales the size of attached object.

Yaw (Y)[edit]

Rotates the attached object in respect to the Y-axis of the rigid body coordinate axis.

Pitch (X)[edit]

Rotates the attached object in respect to the X-axis of the rigid body coordinate axis.

Roll (Z)[edit]

Rotates the attached object in respect to the Z-axis of the rigid body coordinate axis.

X[edit]

Translate the position of attached object in x-axis in respect to the rigid body coordinate.

Y[edit]

Translate the position of attached object in y-axis in respect to the rigid body coordinate.

Z[edit]

Translate the position of attached object in z-axis in respect to the rigid body coordinate.

Opacity[edit]

Sets the opacity of an attached object. An OBJ file typically comes with a corresponding MTL file which defines its properties, and the transparency of the object is defined within these MTL files. The Opacity value under the rigid body properties applies a factor between 0 ~ 1 in order to rescale the loaded property. In other words, you can set the transparency in the MTL file and rescale them using the Opacity property in Motive.

History Settings[edit]

Default history settings.
Rigid body position and orientation tracking history

For visualizing tracking history, Position History and Orientation History must be enabled under the Display Settings section.

History Length[edit]

Sets the number of frames for visualizing position and orientation history. Valid range is 1 to 1000. Default is 500.

Orientation Spread[edit]

Sets the spacing, in frames, between orientation history markers in the 3D Perspective View. Increasing this value will cause the markers to appear less frequently, which can improve visualization if the object is rotating at a slower pace. Valid range is 1 to 100. Default is 5.

Orientation Size[edit]

Sets the size of the orientation history icon in the 3D Perspective View. Valid range is 1 to 100. Default is 1.


Reconstruction[edit]


Multiple marker rays contributing to the reconstruction of a marker.

Info2.png

See Application Settings: Reconstruction Settings page for more information on each setting.

Reconstruction tab contains a list of parameters for the real-time Point Cloud reconstruction engine.

Reconstruction in motion capture is a process of deriving 3D points from 2D coordinate information obtained from captured images, and the Point Cloud is the core engine that runs the reconstruction process. The reconstruction settings in the Application Settings modifies the engine's parameters for real-time reconstructions. These settings can be modified to optimize the quality of reconstructions in Live mode depending on the conditions of the capture and what you're trying to achieve. Use the 2D Mode to live-monitor the reconstruction outcomes from the configured settings.

  • Reconstruction settings for post-processing reconstruction pipelines are configured under the Take properties in the Properties pane.
  • For details on the reconstruction workflow, read through the Reconstruction and 2D Mode page.