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

• XrPassthroughCameraStateANDROID

Nuove strutture

• XrPassthroughCameraStateGetInfoANDROID

Nuove funzioni

• xrGetPassthroughCameraStateANDROID

Problemi

Cronologia delle versioni

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