Skip to main content
Version: 12 Dec 2024

MLMarkerTrackerCustomProfile

Marker Tracker system provides a set of standard tracking profiles (see MLMarkerTracker.Profile enum) to configure the tracker settings. This is the structure that defines a custom tracker profile.

Public Methods

MLMarkerTrackerCustomProfile

Sets the native structures from the user facing properties.

public MLMarkerTrackerCustomProfile(
TrackerSettings.CustomProfile customProfile
)

Parameters

TypeNameDescription
TrackerSettings.CustomProfilecustomProfile

Public Attributes

CameraHint

The camera hint for all detectors.


public readonly CameraHint CameraHint;

TypeDescription
readonly CameraHintThe CameraHint enum values are used to hint to the camera that should be used. This is set in the MLMarkerTracker.CustomProfile structure and this setting currently only applies to the aruco detectors.

CornerRefineMethod

This option provides control over corner refinement methods and a way to balance detection rate, speed and pose accuracy. Always available and applicable for Aruco and April tags.


public readonly CornerRefineMethod CornerRefineMethod;

TypeDescription
readonly CornerRefineMethodThe Aruco/April tag detector comes with several corner refinement methods. Choosing the right corner refinement method has an impact on the accuracy and speed trade-off that comes with each detection pipeline. Corner refinement only applies to Aruco and April tags, not QR codes.

FPSHint

Hint used for all detectors.


public readonly FPSHint FPSHint;

TypeDescription
readonly FPSHintUsed to hint to the back-end the max frames per second that should be analyzed. This is set in the MLMarkerTrackerCustomProfile structure and this setting applies to all enabled trackers.

FullAnalysisIntervalHint

In order to improve performance, the detectors don't always run on the full frame.Full frame analysis is however necessary to detect new markers that weren't detected before. Use this option to control how often the detector may detect new markers and its impact on tracking performance.


public readonly FullAnalysisIntervalHint FullAnalysisIntervalHint;

TypeDescription
readonly FullAnalysisIntervalHintIn order to improve performance, the detectors don't always run on the full frame. Full frame analysis is however necessary to detect new markers that weren't detected before. Use this option to control how often the detector may detect new markers and its impact on tracking performance.

ResolutionHint

The resolution hint for all detectors.


public readonly ResolutionHint ResolutionHint;

TypeDescription
readonly ResolutionHintThe ResolutionHint enum values are used to hint to the back-end the resolution that should be used. This is set in the MLMarkerTracker.CustomProfile structure and this setting currently only applies to the QR, UPC and EAN detectors.

UseEdgeRefinement

Run refinement step that uses marker edges to generate even more accurate corners, but slow down tracking rate overall by consuming more compute. Aruco/April tags only.


public readonly bool UseEdgeRefinement;