Extension OpenXR XR_ANDROID_passthrough_camera_state

Chaîne de nom

XR_ANDROID_passthrough_camera_state

Type d'extension

Extension d'instance

Numéro d'extension enregistré

461

Révision

1

Dépendances d'extension et de version

OpenXR 1.0

Date de dernière modification

2024-09-05

Contributeurs

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Présentation

Le démarrage de la caméra de passthrough peut prendre du temps et elle n'est pas toujours disponible immédiatement. Cette extension permet aux applications de connaître l'état actuel de la caméra de passthrough.

Obtenir l'état actuel de la caméra de passthrough

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

Descriptions des paramètres

• session est un gestionnaire XrSession précédemment créé avec xrCreateSession.
• getInfo correspond à toute information qui affectera la détermination de l'état de la caméra.
• cameraStateOutput correspond à l'état actuel de la caméra.

xrGetPassthroughCameraStateANDROID récupère l'état actuel de la caméra de passthrough.

La structure XrPassthroughCameraStateGetInfoANDROID est une struct d'entrée/sortie qui spécifie les paramètres de la requête d'état de l'appareil photo.

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

Descriptions des membres

• type est le XrStructureType de cette structure.
• next est NULL ou un pointeur vers la structure suivante d'une chaîne de structures.

L'énumération XrPassthroughCameraStateANDROID identifie les différents états dans lesquels la caméra de passthrough peut se trouver.

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;

Les énumérations ont la signification suivante:

Enum	Description
XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID	L'appareil photo a été désactivé par une application, le système ou l'utilisateur.
XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID	La caméra est en cours de mise en ligne et n'est pas encore prête à être utilisée.
XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID	La caméra est prête à être utilisée.
XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID	La caméra est dans un état d'erreur irrécupérable.

Nouveaux types d'objets

Nouveaux types d'indicateurs

Nouvelles constantes d'énumération

L'énumération XrStructureType est étendue avec:

• XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Nouvelles énumérations

• XrPassthroughCameraStateANDROID

Nouvelles structures

• XrPassthroughCameraStateGetInfoANDROID

Nouvelles fonctions

• xrGetPassthroughCameraStateANDROID

Problèmes

Historique des versions

• Révision 1, 05/09/2024 (Spencer Quin)
• Version initiale.