XR_QCOM_trackables_qr_code_operations

Name String

XR_QCOM_trackables_qr_code_operations

Erweiterungstyp

Instanzerweiterung

Registrierte Durchwahl

315

Revision

1

Ratification Status

Nicht ratifiziert

Erweiterungs- und Versionsabhängigkeiten

XR_ANDROID_trackables_qr_code

Datum der letzten Änderung

2025-12-19

IP-Status

Keine bekannten Ansprüche auf geistiges Eigentum.

Mitwirkende

Maximilian Mayer, Qualcomm

Übersicht

Die Struktur XrSystemQrCodeTrackingOperationsPropertiesQCOM ist so definiert:

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

Mitgliederbeschreibungen

• type
• next
• supportsQrCodeTrackingOperations

Gültige Verwendung (implizit)

• Die Erweiterung XR_QCOM_trackables_qr_code_operations muss aktiviert sein, bevor XrSystemQrCodeTrackingOperationsPropertiesQCOM verwendet werden kann.
• type muss XR_TYPE_SYSTEM_QR_CODE_TRACKING_OPERATIONS_PROPERTIES_QCOM sein
• next muss NULL oder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.

Die Struktur XrTrackableQrCodeVersionFilterQCOM ist so definiert:

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

Mitgliederbeschreibungen

• type
• next
• qrCodeVersionCount
• qrCodeVersions

Gültige Verwendung (implizit)

• Die Erweiterung XR_QCOM_trackables_qr_code_operations muss aktiviert sein, bevor XrTrackableQrCodeVersionFilterQCOM verwendet werden kann.
• type muss XR_TYPE_TRACKABLE_QR_CODE_VERSION_FILTER_QCOM sein
• next muss NULL oder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.
• qrCodeVersions muss ein Zeiger auf ein Array von qrCodeVersionCount uint32_t-Werten sein.
• Der Parameter qrCodeVersionCount muss größer als 0 sein.

Die Struktur XrTrackableQrCodeVersionQCOM ist so definiert:

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

Mitgliederbeschreibungen

• type
• next
• qrVersion

Gültige Verwendung (implizit)

• Die Erweiterung XR_QCOM_trackables_qr_code_operations muss aktiviert sein, bevor XrTrackableQrCodeVersionQCOM verwendet werden kann.
• type muss XR_TYPE_TRACKABLE_QR_CODE_VERSION_QCOM sein
• next muss NULL oder ein gültiger Zeiger auf die nächste Struktur in einer Strukturkette sein.

Die Funktion xrGetTrackableQrCodeRawDataQCOM ist so definiert:

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

Parameterbeschreibungen

• tracker
• qrCode
• bufferCapacityInput
• bufferCountOutput
• buffer

Gültige Verwendung (implizit)

• Die Erweiterung XR_QCOM_trackables_qr_code_operations muss aktiviert werden, bevor xrGetTrackableQrCodeRawDataQCOM aufgerufen wird.
• tracker muss ein gültiges XrTrackableTrackerANDROID-Handle sein
• bufferCountOutput muss ein Zeiger auf einen uint32_t-Wert sein
• Wenn bufferCapacityInput nicht 0 ist, muss buffer ein Zeiger auf ein Array von bufferCapacityInput-uint8_t-Werten sein.

Rückgabecodes

Erfolg

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

Fehler

• 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

Die Funktion xrResetTrackableQrCodeTrackingQCOM ist so definiert:

XrResult xrResetTrackableQrCodeTrackingQCOM(
    XrTrackableTrackerANDROID                   tracker,
    XrTrackableANDROID                          qrCode);

Parameterbeschreibungen

• tracker
• qrCode

Gültige Verwendung (implizit)

• Die Erweiterung XR_QCOM_trackables_qr_code_operations muss aktiviert werden, bevor xrResetTrackableQrCodeTrackingQCOM aufgerufen wird.
• tracker muss ein gültiges XrTrackableTrackerANDROID-Handle sein

Rückgabecodes

Erfolg

• XR_SUCCESS
• XR_SESSION_LOSS_PENDING

Fehler

• 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

Versionsverlauf

• Version 1, 19.12.2025

  • Platzhalter