C Specification

The XrTrackableQrCodeConfigurationANDROID structure is defined as:

// Provided by XR_ANDROID_trackables_qr_code
typedef struct XrTrackableQrCodeConfigurationANDROID {
    XrStructureType                type;
    void*                          next;
    XrQrCodeTrackingModeANDROID    trackingMode;
    float                          qrCodeEdgeSize;
} XrTrackableQrCodeConfigurationANDROID;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain. No such structures are defined in core OpenXR or this extension.

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

  • qrCodeEdgeSize indicates the size of the QR code edge in meters. If zero, the runtime estimates the QR code size online.

Description

The application must set a valid configuration by adding a XrTrackableQrCodeConfigurationANDROID to the next chain of XrTrackableTrackerCreateInfoANDROID. Otherwise, the runtime must return XR_ERROR_VALIDATION_FAILURE.

If the runtime supports QR code size estimation, the application may set XrTrackableQrCodeConfigurationANDROID::qrCodeEdgeSize to 0.0 to indicate the usage of size estimation.

If the runtime does not support QR code size estimation, the application must set XrTrackableQrCodeConfigurationANDROID::qrCodeEdgeSize to a positive value, otherwise the runtime must return XR_ERROR_VALIDATION_FAILURE.

The runtime must filter the output from xrGetAllTrackablesANDROID to match the trackingMode. If XrTrackableQrCodeConfigurationANDROID::qrCodeEdgeSize is not set to 0.0 the runtime must only return QR codes that match this size. If XrTrackableQrCodeConfigurationANDROID::qrCodeEdgeSize is set to 0.0 the runtime must return all QR codes with estimated size.

Valid Usage (Implicit)

See Also

XR_ANDROID_trackables_qr_code, XrQrCodeTrackingModeANDROID, XrStructureType, 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-2026 The Khronos Group Inc.

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