Skip to main content
Version: 20 Mar 2024

MLMarkerTrackerCustomProfile

Module: Fiducial Marker Tracking

Marker Tracker Custom Profile. More...

#include <ml_marker_tracking.h>

Public Attributes

TypeName
MLMarkerTrackingFpsHintfps_hint
Framerate hint used for all detectors. See MLMarkerTrackingFpsHint for details.
MLMarkerTrackingResolutionHintresolution_hint
The resolution hint. See MLMarkerTrackingResolutionHint for details.
MLMarkerTrackerCameraHintcamera_hint
Camera hint used for all detectors. See MLMarkerTrackerCameraHint for details.
MLMarkerTrackerCornerRefineMethodcorner_refine_method
Corner refinement method for Aruco/April tag detector.
booluse_edge_refinement
Activate Edge Refinement. 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.
MLMarkerTrackerFullAnalysisIntervalHintfull_analysis_interval_hint
Time interval between fully analyzed frames.

Detailed Description

struct MLMarkerTrackerCustomProfile;

Marker Tracker Custom Profile.

Marker Tracker system provides a set of standard tracking profiles (see MLMarkerTrackerProfile) to configure the tracker settings. If this does not meet the application's needs then the application can choose to define a custom tracker profile using MLMarkerTrackerCustomProfile.

Deprecated

Deprecated since 1.6.0. Scheduled for removal.


Public Attributes Documentation

fps_hint

MLMarkerTrackingFpsHint fps_hint;

Framerate hint used for all detectors. See MLMarkerTrackingFpsHint for details.

TypeDescription
MLMarkerTrackingFpsHintMarker tracker FPS hint.

resolution_hint

MLMarkerTrackingResolutionHint resolution_hint;

The resolution hint. See MLMarkerTrackingResolutionHint for details.

TypeDescription
MLMarkerTrackingResolutionHintMarker tracker resolution hint.

camera_hint

MLMarkerTrackerCameraHint camera_hint;

Camera hint used for all detectors. See MLMarkerTrackerCameraHint for details.

TypeDescription
MLMarkerTrackerCameraHintMarker tracker camera hint.

corner_refine_method

MLMarkerTrackerCornerRefineMethod corner_refine_method;

Corner refinement method for Aruco/April tag detector.

TypeDescription
MLMarkerTrackerCornerRefineMethodCorner Refinement Method.

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.

See MLMarkerTrackerCornerRefineMethod for details.


use_edge_refinement

bool use_edge_refinement;

Activate Edge Refinement. 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.

note

Recommended in combination with Contour Corner Refine method for best balance between performance and accuracy.


full_analysis_interval_hint

MLMarkerTrackerFullAnalysisIntervalHint full_analysis_interval_hint;

Time interval between fully analyzed frames.

TypeDescription
MLMarkerTrackerFullAnalysisIntervalHintFull Frame Analysis Time Interval.

For faster tracking not every single frame is fully analyzed. Increasing this time will improve tracking speed but negatively impact detection latency of new markers.