OpenXR-Erweiterung „XR_ANDROID_passthrough_camera_state“

Namensstring

XR_ANDROID_passthrough_camera_state

Erweiterungstyp

Instanzerweiterung

Registrierte Erweiterungsnummer

461

Revision

1

Erweiterungs- und Versionsabhängigkeiten

OpenXR 1.0

Datum der letzten Änderung

2024-09-05

Mitwirkende

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Übersicht

Das Starten der Kamera kann einige Zeit in Anspruch nehmen und sie ist möglicherweise nicht sofort verfügbar. Mit dieser Erweiterung können Anwendungen den aktuellen Status der Kamera mit Durchlassfunktion erkennen.

Aktuellen Status der Passthrough-Kamera abrufen

XrResult xrGetPassthroughCameraStateANDROID(
    XrSession                                   session,
    const XrPassthroughCameraStateGetInfoANDROID* getInfo,
    XrPassthroughCameraStateANDROID*            cameraStateOutput);

Parameterbeschreibungen

  • session ist ein XrSession-Handle, der zuvor mit xrCreateSession erstellt wurde.
  • getInfo sind alle Informationen, die sich auf die Bestimmung des Kamerastatus auswirken.
  • cameraStateOutput ist der aktuelle Status der Kamera.

xrGetPassthroughCameraStateANDROID ruft den aktuellen Status der Passthrough-Kamera ab.

Die Struktur XrPassthroughCameraStateGetInfoANDROID ist eine Eingabe/Ausgabestruktur, die die Parameter der Kamerastatusanfrage angibt. 

typedef struct XrPassthroughCameraStateGetInfoANDROID {
    XrStructureType    type;
    void*              next;
} XrPassthroughCameraStateGetInfoANDROID;

Beschreibungen von Mitgliedern

  • type ist der XrStructureType dieser Struktur.
  • next ist NULL oder ein Zeiger auf die nächste Struktur in einer Strukturkette.

Die Aufzählung XrPassthroughCameraStateANDROID gibt die verschiedenen Status an, in denen sich die Kamera befindet. 

typedef enum XrPassthroughCameraStateANDROID {
    XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID = 0,
    XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID = 1,
    XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID = 2,
    XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID = 3,
    XR_PASSTHROUGH_CAMERA_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrPassthroughCameraStateANDROID;

Die Enumerationen haben folgende Bedeutungen:

Enum

Beschreibung

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

Die Kamera wurde von einer App, dem System oder dem Nutzer deaktiviert.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

Die Kamera ist noch nicht vollständig online und kann noch nicht verwendet werden.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

Die Kamera ist einsatzbereit.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

Die Kamera befindet sich in einem nicht behebbaren Fehlerstatus.

Neue Objekttypen

Neue Flaggentypen

Neue Enum-Konstanten

Die Aufzählung XrStructureType wurde um folgende Elemente erweitert:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Neue Enums

Neue Strukturen

Neue Funktionen

Probleme

Versionsverlauf

  • Revision 1, 05.09.2024 (Spencer Quin)
  • Erste Version.

OpenXR™ und das OpenXR-Logo sind Marken der Khronos Group Inc. und sind als Marke in China, der Europäischen Union, Japan und dem Vereinigten Königreich eingetragen.