Skip to main content
Version: 12 Dec 2024

CustomProfileSettings

NameSpace: MarkerUnderstanding

The custom settings applied to the marker tracker when a custom profile is used.

Public Attributes

AnalysisInterval

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 MarkerDetectorFullAnalysisInterval AnalysisInterval;

TypeDescription
MarkerDetectorFullAnalysisIntervalIn 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.

CameraHint

A hint to the back-end for what cameras should be used.


public MarkerDetectorCamera CameraHint;

TypeDescription
MarkerDetectorCameraThe MarkerDetectorCamera enum values are used to hint to the camera that should be used. This is set in the CustomProfileSettings structure and this setting currently only applies to the aruco detectors.

CornerRefinement

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 MarkerDetectorCornerRefineMethod CornerRefinement;

TypeDescription
MarkerDetectorCornerRefineMethodThe 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

A hint to the back-end the max frames per second hat should be analyzed.


public MarkerDetectorFPS FPSHint;

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

ResolutionHint

A hint to the back-end the resolution that should be used.


public MarkerDetectorResolution ResolutionHint;

TypeDescription
MarkerDetectorResolutionThe MarkerDetectorResolution enum values are used to hint to the back-end the resolution that should be used. This is set in the CustomProfileSettings 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 bool UseEdgeRefinement;