Properties Pane: Rigid Body

Rigid body properties determine how the corresponding Rigid Body asset is tracked and displayed in the viewport.

To view related properties, select a Rigid Body asset in the Assets pane or in the 3D viewport, and the corresponding properties will be listed under the Properties pane. These properties can be modified both in Live and Edit mode. Default creation properties are listed under the Application Settings.

Rigid Body Properties

General

Name

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

Active

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

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

The minimum number of markers that must be tracked and labeled in order for a Rigid Body asset, or each Skeleton bone, to be booted or first tracked.

Max Deflection

The maximum displacement a Rigid Body marker ca deviate from its calibrated position before it becomes unlabeled.

Smoothing

Applies double exponential smoothing to translation and rotation of a Rigid Body. Disabled at 0.

Forward Prediction

Compensation for system latency by predicting a Rigid Body's movement into the future. For this feature to work best, smoothing needs to be applied as well.

Tracking Algorithm

Tracking algorithm used for Rigid Body tracking.

Visuals

Color

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

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.

Orientation

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

Shows a history of the Rigid Body’s position. When enabled, you can set the history length and the tracking history will be drawn in the Perspective view.

Orientation History

Show historical orientation axes.

Show Tracked

Shows Rigid Body when tracked.

Untracked Markers

Shows Rigid Body when not tracked.

Pivot

Show Rigid Body's pivot point.

Assigned Markers

Shows Rigid Body's assigned markers.

Pivot Scale

Scales the size of the Rigid Body's pivot point.

Quality

When this is set to true, links drawn between Rigid Body markers will tween to red as deflection approaches max deflection setting.

Maker Quality

When set to true, expected markers of the Rigid Body will change its color to red as it approaches the max deflection setting.

Model Replace

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

Attached Geometry

Attached Geometry setting will be visible if the Model Replace setting is enabled. Here, you can load an OBJ file to replace the Rigid Body. Scale, positions, and orientations of the attached geometry can be configured under the following section also. When a OBJ file is loaded, properties configured in the corresponding MTL files alongside the OBJ file will be loaded as well.

IMU

Active Tag ID

Uplink ID assigned to the Tag or Puck using the Active Batch Programmer. This ID must match with the Uplink ID assigned to the Active Tag or Puck that was used to create the Rigid Body.

Active Tag RF Channel

Radio frequency communication channel configured on the Active Tag, or Puck, that was used to define the corresponding Rigid Body. This must match the RF channel configured on the active component; otherwise, IMU data will not be received.

Smoothing and Damping

Smoothing

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 latency. Default is 0 (disabled).

Forward Prediction

Compensate for system latency when tracking of the corresponding Rigid Body by predicting its movement into the future. Please note that predicting further into the future may impact the tracking stability.

Damping

[Advanced] When needed, you can damp down translational and/or rotational tracking of a Rigid Body or a Skeleton bone on selected axis.