XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

Extension Type

Instance extension

Registered Extension Number

315

Revision

1

Ratification Status

Not ratified

Extension and Version Dependencies

XR_ANDROID_trackables_qr_code

Last Modified Date

2025-12-19

IP Status

No known IP claims.

Contributors

Maximilian Mayer, Qualcomm

Overview

The XrSystemQrCodeTrackingOperationsPropertiesQCOM structure is defined as:

typedef struct XrSystemQrCodeTrackingOperationsPropertiesQCOM {
    XrStructureType    type;
    void*              next;
    XrBool32           supportsQrCodeTrackingOperations;
} XrSystemQrCodeTrackingOperationsPropertiesQCOM;

Member Descriptions

• type
• next
• supportsQrCodeTrackingOperations

Valid Usage (Implicit)

• The XR_QCOM_trackables_qr_code_operations extension must be enabled prior to using XrSystemQrCodeTrackingOperationsPropertiesQCOM
• type must be XR_TYPE_SYSTEM_QR_CODE_TRACKING_OPERATIONS_PROPERTIES_QCOM
• next must be NULL or a valid pointer to the next structure in a structure chain

The XrTrackableQrCodeVersionFilterQCOM structure is defined as:

typedef struct XrTrackableQrCodeVersionFilterQCOM {
    XrStructureType    type;
    const void*        next;
    uint32_t           qrCodeVersionCount;
    uint32_t*          qrCodeVersions;
} XrTrackableQrCodeVersionFilterQCOM;

Member Descriptions

• type
• next
• qrCodeVersionCount
• qrCodeVersions

Valid Usage (Implicit)

• The XR_QCOM_trackables_qr_code_operations extension must be enabled prior to using XrTrackableQrCodeVersionFilterQCOM
• type must be XR_TYPE_TRACKABLE_QR_CODE_VERSION_FILTER_QCOM
• next must be NULL or a valid pointer to the next structure in a structure chain
• qrCodeVersions must be a pointer to an array of qrCodeVersionCount uint32_t values
• The qrCodeVersionCount parameter must be greater than 0

The XrTrackableQrCodeVersionQCOM structure is defined as:

typedef struct XrTrackableQrCodeVersionQCOM {
    XrStructureType    type;
    void*              next;
    uint32_t           qrVersion;
} XrTrackableQrCodeVersionQCOM;

Member Descriptions

• type
• next
• qrVersion

Valid Usage (Implicit)

• The XR_QCOM_trackables_qr_code_operations extension must be enabled prior to using XrTrackableQrCodeVersionQCOM
• type must be XR_TYPE_TRACKABLE_QR_CODE_VERSION_QCOM
• next must be NULL or a valid pointer to the next structure in a structure chain

The xrGetTrackableQrCodeRawDataQCOM function is defined as:

XrResult xrGetTrackableQrCodeRawDataQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode,
    uint32_t                                    bufferCapacityInput,
    uint32_t*                                   bufferCountOutput,
    uint8_t*                                    buffer);

Parameter Descriptions

• tracker
• qrCode
• bufferCapacityInput
• bufferCountOutput
• buffer

Valid Usage (Implicit)

• The XR_QCOM_trackables_qr_code_operations extension must be enabled prior to calling xrGetTrackableQrCodeRawDataQCOM
• tracker must be a valid XrTrackableTrackerANDROID handle
• bufferCountOutput must be a pointer to a uint32_t value
• If bufferCapacityInput is not 0 , buffer must be a pointer to an array of bufferCapacityInput uint8_t values

Return Codes

Success

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

Failure

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_SIZE_INSUFFICIENT
• XR_ERROR_VALIDATION_FAILURE

The xrResetTrackableQrCodeTrackingQCOM function is defined as:

XrResult xrResetTrackableQrCodeTrackingQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode);

Parameter Descriptions

• tracker
• qrCode

Valid Usage (Implicit)

• The XR_QCOM_trackables_qr_code_operations extension must be enabled prior to calling xrResetTrackableQrCodeTrackingQCOM
• tracker must be a valid XrTrackableTrackerANDROID handle

Return Codes

Success

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

Failure

• XR_ERROR_FUNCTION_UNSUPPORTED
• XR_ERROR_HANDLE_INVALID
• XR_ERROR_INSTANCE_LOST
• XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
• XR_ERROR_RUNTIME_FAILURE
• XR_ERROR_SESSION_LOST
• XR_ERROR_VALIDATION_FAILURE

Version History

• Revision 1, 2025-12-19

  • Placeholder