XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

Тип расширения

Расширение экземпляра

Зарегистрированный добавочный номер

315

Revision

1

Статус ратификации

Не ратифицировано

Зависимости расширений и версий

XR_ANDROID_trackables_qr_code

Дата последнего изменения

2025-12-19

Статус IP-адреса

Нет известных претензий в отношении интеллектуальной собственности.

Авторы

Максимилиан Майер (Maximilian Mayer), Qualcomm

Обзор

Структура XrSystemQrCodeTrackingOperationsPropertiesQCOM определяется следующим образом:

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

Описания участников

• type
• next
• supportsQrCodeTrackingOperations

Допустимое использование (неявное)

• Расширение XR_QCOM_trackables_qr_code_operations должно быть включено до использования XrSystemQrCodeTrackingOperationsPropertiesQCOM.
• type должно быть XR_TYPE_SYSTEM_QR_CODE_TRACKING_OPERATIONS_PROPERTIES_QCOM
• next должно быть NULL или действительным указателем на следующую структуру в цепочке структур.

Структура XrTrackableQrCodeVersionFilterQCOM определяется следующим образом:

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

Описания участников

• type
• next
• qrCodeVersionCount
• qrCodeVersions

Допустимое использование (неявное)

• Расширение XR_QCOM_trackables_qr_code_operations должно быть включено до использования XrTrackableQrCodeVersionFilterQCOM.
• type должно быть XR_TYPE_TRACKABLE_QR_CODE_VERSION_FILTER_QCOM
• next должно быть NULL или действительным указателем на следующую структуру в цепочке структур.
• qrCodeVersions должен быть указателем на массив значений qrCodeVersionCount uint32_t.
• Значение параметра qrCodeVersionCount должно быть больше 0.

Структура XrTrackableQrCodeVersionQCOM определяется следующим образом:

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

Описания участников

• type
• next
• qrVersion

Допустимое использование (неявное)

• Перед использованием XrTrackableQrCodeVersionQCOM необходимо включить расширение XR_QCOM_trackables_qr_code_operations.
• type должно быть XR_TYPE_TRACKABLE_QR_CODE_VERSION_QCOM
• next должно быть NULL или действительным указателем на следующую структуру в цепочке структур.

Функция xrGetTrackableQrCodeRawDataQCOM определяется следующим образом:

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

Описание параметров

• tracker
• qrCode
• bufferCapacityInput
• bufferCountOutput
• buffer

Допустимое использование (неявное)

• Расширение XR_QCOM_trackables_qr_code_operations должно быть включено до вызова xrGetTrackableQrCodeRawDataQCOM.
• tracker должен быть действительным дескриптором XrTrackableTrackerANDROID.
• bufferCountOutput должен быть указателем на значение uint32_t.
• Если bufferCapacityInput не равно 0 , buffer должен быть указателем на массив значений bufferCapacityInput uint8_t.

Коды возврата

Выполнено

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

Сбой

• 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

Функция xrResetTrackableQrCodeTrackingQCOM определяется следующим образом:

XrResult xrResetTrackableQrCodeTrackingQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode);

Описание параметров

• tracker
• qrCode

Допустимое использование (неявное)

• Расширение XR_QCOM_trackables_qr_code_operations должно быть включено до вызова xrResetTrackableQrCodeTrackingQCOM.
• tracker должен быть действительным дескриптором XrTrackableTrackerANDROID.

Коды возврата

Выполнено

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

Сбой

• 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

История версий

• Версия 1, 19 декабря 2025 г.

  • Плейсхолдер