Estensione OpenXR XR_ANDROID_passthrough_camera_state

Stringa del nome

XR_ANDROID_passthrough_camera_state

Tipo di estensione

Estensione dell'istanza

Numero di estensione registrato

461

Revisione

1

Dipendenze di estensioni e versioni

OpenXR 1.0

Data ultima modifica

2024-09-05

Collaboratori

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Panoramica

L'avvio della videocamera passthrough può richiedere del tempo e potrebbe non essere immediatamente disponibile. Questa estensione consente alle applicazioni di conoscere lo stato corrente della videocamera passthrough.

Ottenere lo stato attuale della videocamera passthrough

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

Descrizioni dei parametri

  • session è un handle XrSession creato in precedenza con xrCreateSession.
  • getInfo è qualsiasi informazione che influisce sulla determinazione dello stato della videocamera.
  • cameraStateOutput è lo stato attuale della videocamera.

xrGetPassthroughCameraStateANDROID recupera lo stato corrente della fotocamera passthrough.

La struttura XrPassthroughCameraStateGetInfoANDROID è una struttura di input/output che specifica i parametri della richiesta relativa allo stato della videocamera. 

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

Descrizioni dei membri

  • type è il XrStructureType di questa struttura.
  • next è NULL o un puntatore alla struttura successiva in una catena di strutture.

L'enumerazione XrPassthroughCameraStateANDROID identifica diversi stati in cui può trovarsi la videocamera passthrough. 

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;

Gli enum hanno i seguenti significati:

Enum

Descrizione

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

La fotocamera è stata disattivata da un'app, dal sistema o dall'utente.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

La videocamera è ancora in fase di aggiornamento e non è ancora pronta per l'uso.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

La fotocamera è pronta per l'uso.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

La videocamera è in uno stato di errore irreversibile.

Nuovi tipi di oggetti

Nuovi tipi di indicatori

Nuove costanti enum

L'enumerazione XrStructureType è stata estesa con:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Nuovi enum

Nuove strutture

Nuove funzioni

Problemi

Cronologia delle versioni

  • Revisione 1, 05/09/2024 (Spencer Quin)
  • Versione iniziale.