C Specification

The XrTrackableMarkerConfigurationANDROID structure is defined as:

// Provided by XR_ANDROID_trackables_marker
typedef struct XrTrackableMarkerConfigurationANDROID {
    XrStructureType                            type;
    void*                                      next;
    XrTrackableMarkerTrackingModeANDROID       trackingMode;
    uint32_t                                   databaseCount;
    const XrTrackableMarkerDatabaseANDROID*    databases;
} XrTrackableMarkerConfigurationANDROID;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain.

  • trackingMode is an XrTrackableMarkerTrackingModeANDROID indicating the desired mode for tracking.

  • databaseCount is a uint32_t describing the count of elements in the databases array.

  • databases is a pointer to an array of XrTrackableMarkerDatabaseANDROID, each of which contains the desired markers from a given dictionary to track.

Description

The application must set a valid configuration by adding a XrTrackableMarkerConfigurationANDROID to the XrTrackableTrackerCreateInfoANDROID::next chain when calling xrCreateTrackableTrackerANDROID with XrTrackableTrackerCreateInfoANDROID::trackableType set to XR_TRACKABLE_TYPE_MARKER_ANDROID. Otherwise, if the tracker type is set as above but the configuration structure is not present or not valid, the runtime must return XR_ERROR_VALIDATION_FAILURE.

If a runtime supports marker size estimation, the application can set XrTrackableMarkerDatabaseEntryANDROID::edgeSize to 0 in XrTrackableMarkerDatabaseANDROID::entries to indicate the usage of size estimation. Otherwise, the application must set XrTrackableMarkerDatabaseEntryANDROID::edgeSize to a positive value or the runtime must return XR_ERROR_VALIDATION_FAILURE.

The runtime must filter the output from xrGetAllTrackablesANDROID to match the trackingMode and XrTrackableMarkerDatabaseEntryANDROID::edgeSize.

Valid Usage (Implicit)

See Also

XR_ANDROID_trackables_marker, XrStructureType, XrTrackableMarkerDatabaseANDROID, XrTrackableMarkerTrackingModeANDROID, xrCreateTrackableTrackerANDROID

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2025 The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.