Skip to main content
Version: 31 Aug 2023

Marker Tracking

The Magic Leap allows you to detect two-dimensional icons from a marker dataset and then continuously track the targets' locations and orientations as you or the markers move through the environment. You can also place and anchor digital content based on the presence and dimensions of a physical marker.

The Marker Tracking API can be used to track fiducial markers like QR codes, April tags and ArUco markers. For fiducial markers, Magic Leap provides 6DOF poses, and the encoded information. The scanner supports up to 16 markers. Identical QR codes will be treated as separate targets and reported individually, identical ArUco markers or April tags will lead to a collision and won't be reported separately.

Supported trackable markers (with pose info):

  • ArUco markers
  • AprilTag v2
  • QR codes (model 1 & 2)

List of supported, detectable markers (no pose info):

  • EAN-13 (experimental)
  • UPC-A (experimental)
caution

Due to the 4X4 and the 'Aruco Original' dictionaries suffering from frequent false detections, we discourage their use.

Marker Tracker Profiles

The Marker Tracker API allows developers to select pre-defined Marker Tracker profiles as well define custom ones. The pre-defined profiles are optimized for specific use cases, developers can select from the following:

Marker Tracker ProfileDescription
DefaultA Generic tracker profile. Covers standard use cases.
CustomApplication can define a custom tracker profiler. See MLMarkerTrackerCustomProfile for more details.
SpeedOptimized for speed. Use this profile to reduce the compute load and increase detection/tracker speed. This can result poor poses.
AccuracyOptimized for accuracy. Use this profile to optimize for accurate marker poses. This can cause increased load on the compute.
Small TargetsOptimized for small targets. Use this profile to optimize for markers that are small or for larger markers that need to detected from far.
Large FoVOptimized for felid of view.Use this profile to be able to detect markers across a larger FoV. Marker Tracker system will attempt to use multiple cameras to detect the markers.

Learn More