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 21.png


Live Reconstruction[edit]


Multiple marker rays contributing to the reconstruction of a marker.

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.

Info2.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.

Texture Streaming[edit]

Disables or enables texture streaming of reference videos on the 2D camera viewport.

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.

Selection Color[edit]

Sets the color of selections 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.

Assigned Markers[edit]

Enables or disables display of assigned markers (also called solved, expected marker positions) on rigid body or skeleton assets

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.

Show Timecode[edit]

Enables or disables timecode values displayed on the 3D viewport. Timecode will be available only when the timecode signal is inputted through the eSync.

Show Marker Infos[edit]

When this is set to true. 3D positions and estimated diameter of selected markers will be displayed on the 3D viewport.
AppSettings MarkerInfo 21.png

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.

Diameter (mm)[edit]

Sets the diameter in millimeters for marker sizes in the 3D Perspective View, if Marker Diameter is set to 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.

[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 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.

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.

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.

Autoscale[edit]

Automatically scales trajectory graphs in the Timeline pane.

Preferred Live Layout[edit]

Preferred Layout to be used for the Live mode graph pane.

Preferred Edit Layout[edit]

Preferred Layout to be used for the Edit mode graph pane.

Scope Duration[edit]

This setting sets the time scope of the plotted graphs in Live mode. By default, this is set to 1000, which means 1000 captured frames of past tracking history will be plotted in Live mode. You can increase this to plot more history data or decrease it to zoom into the tracking history.

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.

Devices Pane[edit]

Maximum Exposrue Display[edit]

Controls the maximum value of the exposure slider in Devices pane.

Calibration Pane Options[edit]

Calibration display options.
Lens Distortion Visuals.

This section covers through the display options for the calibration features. In previous releases, these options existed in the Calibration pane.

Panel Output[edit]

Default: Standard. Decides whether the calibration process is displayed in a list format or a grid format. Grid format allows more camera progresses to be seen in the pane.

Status Ring[edit]

Default: Visualize. Enables the Status Indicator Ring to glow during calibration in order to display the wanding process.

Solver Visualizations[edit]

Default: Show. This toggles the display of wand samples and point cloud calibration visuals in the 2D and 3D view. If you're running on a lower end machine or graphics card with a large system, it is best to turn this feature off. The visual display will in fact eat up some computing power you may want reserved for getting quicker calibration results.

Lens Distortion[edit]

Default: Show. Use this to toggle the display of the lens distortion solution results in the 2D view. The lens distortion will be represented by a square grid that maps the distortion.

Cameras[edit]

Default: Show. This toggles the display of the cameras during the solve.

Wanding Projection[edit]

Default: Show. This toggles the display of wand samples projected in the 3D view. Turn this off if you're calibrating a very large system.

Projection Error[edit]

Default: Show. This toggles the display of error, reported as a color in the projected wand samples and markers. The wand samples will have a color between blue (good sample) and red (poor sample). Make sure the samples you collect are mostly good samples. As will all visual feedback, it may be a good idea to turn this off if you're calibrating a larger system.

Residual Error[edit]

Default: 6 mm. Set the tolerance for the reported error in the projected marker sample during calibration.

Wand Error[edit]

Default: 8 mm. This sets the tolerance for the reported error in the projected wand sample.

Sample Spacing[edit]

Default: 1. Use this to increase the spacing between displayed samples that are projected in the 3D view. Increasing this will skip more samples but will make the visual wand projections easier to see.

Skeletons[edit]


Skeleton Display Properties[edit]

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 Properties: Skeleton page.

Info2.png

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

Advanced Properties[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. For descriptions of the rigid body properties, please read through the Properties: Rigid Body page.

Info2.png

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

Cameras[edit]


This section of the application settings is used for configuring the properties for all of the cameras in the tracking group. The settings include display options, masking properties, but most importantly, the 2D Filter settings for the camera system which basically determines which reflections are considered as marker reflections from the camera view.

Filters (2D Object Filter)[edit]

AppSet Filter.png

When a frame of image is captured by a camera, the 2D Object Filter is applied. By judging on sizes and shapes of the detected reflections, this filter determines which of them can be accepted as marker reflections. Parameters for the 2D Object filter are configured in the Devices pane under the Filters section.

Info2.png

For Motive 2.0 and above. The 2D Object filter settings in the Reconstruction Settings pane have been moved over to the Devices pane.

Filter Type[edit]

Default: Size and Roundness
Toggles 2D object (Size and Roundness) filtering on or off.
This filter is very useful for filtering out extraneous reflections according to their characteristics (size and roundness) rather than blocking pixels using the masking tool or the Block Visible feature. Turn off this setting only when you want to use every 2D pixels above the brightness threshold from camera views. When there are extraneous or flickering reflections in the view, turn on the filter to specify and consider reflections only from markers. There are multiple filtering parameters to distinguish the marker reflections. Given that there are assumed marker characteristics, filtering parameters can be set. The size parameters can be defined to filter out extra-small or extra-large reflections that are most likely from extraneous sources other than markers. Non-circular reflections can be ignored assuming that all reflective markers have circular shapes. Note that even when applying the size and roundness filter, you should always Block Visible when you calibrate.
The size filter applied with a maximum size limit of 200 pixels. Any reflections bigger than 200 pixel-size is omitted from the Point Cloud reconstruction calculation.

Min Thresholded Pixels (pixels)[edit]

Default: 4 pixels
The minimum pixel size of a 2D object, a collection of pixels grouped together, for it 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 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 more than 4 pixels need a group of pixels needs to be greater than 4 for a ray to be generated.

Max Thresholded Pixels (pixels)[edit]

Default: 2000 pixels
The maximum size of a 2D object, in pixels, in order for it to be included in point cloud reconstruction. Default is 2000 pixels which basically means that all of detected large reflections smaller than 2000 pixel-size will be included as a 2D object. Use this to filter out larger markers in a variable marker capture. For instance, if you have 4 mm markers on an actor's face and 14 mm markers on their body, use this setting to filter out the larger markers if the need arises.
The circle filter omitting non-circular reflections from a 2D camera view.

Circularity[edit]

Default: 0.6
This setting 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 can identify marker reflections using the shape, specifically the roundness, of the group of thresholded pixels. Higher circularity setting will filter out all other reflections that are not circular. It is recommended to optimize this setting so that extraneous reflections are efficiently filtered out while not filtering out the marker reflections.
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 as a 2D object from the camera view. Also, this setting may need to be lowered when tracking non-spherical markers in order to avoid filtering the reflections.

Intrusion Band[edit]

Default: 0.5 (Pixels)
The intrusion band feature allows cameras to recognize reflections that are about to be merged and filter them out before it happens. This filter occurs before the circularity filter, and these reflections are rejected before the thresholded pixels merge. This is useful for improving the accuracy of the tracking, because bright pixels from close by reflections may slightly shift the centroid locations. The intrusion band value is added to the calculated radius of detected markers to establish a boundary, and any extraneous reflections intruding the boundary is considered as the intrusion and gets omitted. When an intrusion happens, both intruding reflection and detected marker reflection will be filtered out.

Garyscale Floor[edit]

Default: 48
The grayscale floor setting further darkens pixels with lower brightness intensity values.

Object Margin[edit]

Default: 2 (Pixels)
The object margin adds an additional margin on top of the intrusion band for filtering out merged reflections. Lowering this value will better detect close-by reflections, but may decrease the accuracy of the centroid positions as a tradeoff.

Display Options[edit]

AppSet CameraDisplay 21.png

Name[edit]

Sets the name for the selected camera group.

Camera Color[edit]

Sets the color for camera group members as they appear in the 3D viewport. Color values are input as standard RGB triplets.

Visible Cameras[edit]

Selects whether cameras in the group are displayed in the viewport.

Show All Color Camera[edit]

By default, only the Prime Color cameras that are equipped with the IR filter switcher are shown in the 3D viewport and Prime Color cameras without filter switcher are hidden. When this setting is set to true, all of the Prime Color cameras will show up in the 3D viewport.

Show Capture Volume[edit]

Selects whether the capture volume (defined as capable of tracking a single marker) is displayed in the viewport. Enabling this will allow the volume to be displayed as a wire cage around the ground plane where multiple cameras fields of view intersect. Valid options are True, False (default).

Camera Overlap[edit]

Sets the minimum camera overlap necessary for a region to be visualized as part of the capture volume. Higher numbers represent more camera coverage, but they will tend to reduce the size of the visualized capture volume. Valid range is 1 to 25 (default 3).

Volume Resolution[edit]

Sets the resolution of the capture volume visualization. A higher number represents a more detailed visualization. Valid range is 1 to 120 (default 50).

FOV Intensity[edit]

Sets the opacity of the FOV visualization. A higher value represents a more opaque volume visualization. Valid range is 1 to 100 (default 50).

Opacity[edit]

Sets the opacity of the volume visualization. A value of 1 is transparent and 100 is opaque. Valid range is 1 to 100 (default 100).

Advanced[edit]

AppSet CameraAdvanced.png

Synchronization Control[edit]

Determines how late camera frames are dealt with. Timely Delivery will drop late frames, which is ideal for real-time applications where data completeness is secondary to timeliness. Complete Delivery will hold up processing of frames when a frame is late. Automatic, which is the default and recommended setting, runs in Timely Delivery mode until it gets a non-trivial percentage of late frames, at which point it will automatically switch to Complete Delivery.

Shutter Offset[edit]

Delays the shutter timing of selected tracking camera group for N microseconds.

Mask Regions[edit]

Mask Width (pixels)[edit]

Sets the extra pixel coverage (width) for masking visible markers when the mask visible function is used. A larger number will block a wider grouping of pixels simultaneously. Valid range is determined by the resolution of the cameras.

Mask Height (pixels)[edit]

Sets the extra pixel coverage (height) for masking visible markers when the mask visible function is used. A larger number will block a wider grouping of pixels simultaneously. Valid range is determined by the resolution of the cameras.