Skip to main content
Version: 20 Mar 2024

MLMarkerTrackerResult

Module: Fiducial Marker Tracking

Represents the result for a single marker. More...

#include <ml_marker_tracking.h>

Public Attributes

TypeName
MLMarkerTrackerDecodedDatadecoded_data
The data which was encoded in the marker.
MLMarkerTrackerDetectorTypedetector_type
The detector type that created this result.
boolvalid_pose
This indicates if coord_frame_marker holds a valid pose.
MLCoordinateFrameUIDcoord_frame_marker
MLCoordinateFrameUID of the marker.
floatreprojection_err
The reprojection error of this marker detection in meters.

Detailed Description

struct MLMarkerTrackerResult;

Represents the result for a single marker.

A list of these detections will be returned by the Marker Tracker, after processing a camera frame succesfully.

Deprecated

Deprecated since 1.6.0. Scheduled for removal.

API Level:

  • 20

Public Attributes Documentation

decoded_data

MLMarkerTrackerDecodedData decoded_data;

The data which was encoded in the marker.

TypeDescription
MLMarkerTrackerDecodedDataRepresents the decoded data.

detector_type

MLMarkerTrackerDetectorType detector_type;

The detector type that created this result.

TypeDescription
MLMarkerTrackerDetectorTypeRepresents the different detector types supported by the API.

valid_pose

bool valid_pose;

This indicates if coord_frame_marker holds a valid pose.

If false do not use coord_frame_marker.


coord_frame_marker

MLCoordinateFrameUID coord_frame_marker;

MLCoordinateFrameUID of the marker.

When valid_pose is true, this can be passed to the MLSnapshotGetTransform() function to get the 6 DOF pose of the marker.


reprojection_err

float reprojection_err;

The reprojection error of this marker detection in meters.

A high reprojection error means that the estimated pose of the marker doesn't match well with the 2D detection on the processed video frame and thus the pose might be inaccurate. The error is given in meters, representing the displacement between real marker and its estimated pose. This means this is a normalized number, independent of marker distance or length.