XR_QCOM_trackables_qr_code_operations

Строка имени

XR_QCOM_trackables_qr_code_operations

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

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

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

315

Пересмотр

1

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

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

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

XR_ANDROID_trackables_qr_code

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

2025-12-19

Статус IP

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

Авторы

Максимилиан Майер, Qualcomm

Обзор

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

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

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

  • type
  • next
  • supportsQrCodeTrackingOperations

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

Структура 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 должен быть указателем на массив значений uint32_t , содержащих qrCodeVersionCount
  • Параметр qrCodeVersionCount должен быть больше 0

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

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

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

  • type
  • next
  • qrVersion

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

Функция 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_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.12.2025

    • Заполнитель