Description

Sets the options for object tracking.

These options match those on the Object Tracking tab in the Processing panel.

Functional area

Data Editing

Command syntax

Syntax

objectTrackingOptions [-reprojectionThreshold float] [-entranceThreshold float] [-minObjectMarkerSeparation integer] [-motionModelEnabled boolean] [-objectTrackingLevel string] [-numThreads integer] [-reset]

Arguments

None

Flags

Name	Argument type	Comments
`reprojectionThreshold`	Float	Max allowable distance (pixels, default 1.25) between a centroid and the projection of a marker into the same camera. Applies only to markers tracked with the Object Tracker. If you need to increase the Environmental Drift Tolerance (see reconstructOptions), increase this value accordingly.
`entranceThreshold`	Float	Max proportion of markers (default 1) that must be visible to the cameras before an object is booted.
`minObjectMarkerSeparation`	Integer	Min allowable separation between objects (mm, default 10) based on the smallest distance between a marker on each object.
`motionModelEnabled`	Boolean	If enabled (default disabled), stationary objects do not have pose jitter arising from image noise.
`objectTrackingLevel`	string	Specifies whether grayscale should be used to improve object tracking (default `UseGrayscale`). Options are: `Standard` `UseGrayscale` (the .x2d must contain grayscale data) `ObjectTrackingOnly` (the .x2d must contain grayscale data and allows lower quality centroids)
`numThreads`	integer	Number of threads used by the object tracker (default 0). For auto settings, set to 0.
`reset`

Return value

void

Examples

// These examples show each of the three values 
// to which you can set objectTrackingLevel.
objectTrackingOptions -objectTrackingLevel "Standard";
objectTrackingOptions -objectTrackingLevel "UseGrayscale";
objectTrackingOptions -objectTrackingLevel "ObjectTrackingOnly";

Additional information

Related commands

reconstructOptions