Rozszerzenie OpenXR XR_ANDROID_passthrough_camera_state

Ciąg znaków nazwy

XR_ANDROID_passthrough_camera_state

Typ rozszerzenia

Rozszerzenie instancji

Zarejestrowany numer wewnętrzny

461

Weryfikacja

1

Zależności rozszerzenia i wersji

OpenXR 1.0

Data ostatniej modyfikacji

2024-09-05

Twórcy

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Omówienie

Uruchomienie kamery może zająć trochę czasu i może się okazać, że nie będzie ona od razu dostępna. To rozszerzenie informuje aplikacje o bieżącym stanie kamery z przekierowaniem.

Pobieranie bieżącego stanu kamery przelotowej

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

Opisy parametrów

  • session to identyfikator XrSession utworzony wcześniej za pomocą funkcji xrCreateSession.
  • getInfo to dowolne informacje, które wpłyną na sposób określania stanu kamery.
  • cameraStateOutput to bieżący stan kamery.

xrGetPassthroughCameraStateANDROID zwraca bieżący stan kamery przelotowej.

Struktura XrPassthroughCameraStateGetInfoANDROID to struktura wejścia/wyjścia, która określa parametry żądania stanu kamery. 

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

Opisy członków

  • type to XrStructureType tej struktury.
  • next to NULL lub wskaźnik do następnej struktury w łańcuchu struktur.

Wyliczenie XrPassthroughCameraStateANDROID identyfikuje różne stany, w których może się znajdować kamera przezroczysta. 

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;

Wykazy te mają następujące znaczenia:

Wyliczenie

Opis

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

Aparat został wyłączony przez aplikację, system lub użytkownika.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

Kamera jest nadal podłączana do sieci i nie jest jeszcze gotowa do użycia.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

Kamera jest gotowa do użycia.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

Kamera jest w stanie nieodwracalnego błędu.

Nowe typy obiektów

Nowe typy flag

Nowe stałe typu wyliczeniowego

Wyliczenie XrStructureType zostało rozszerzone o:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Nowe wartości w polu enum

Nowe struktury

Nowe funkcje

Problemy

Historia wersji

  • Wersja 1 z 5.09.2024 (Spencer Quin)
  • Wersja początkowa.