Extensão OpenXR XR_ANDROID_passthrough_camera_state

String de nome

XR_ANDROID_passthrough_camera_state

Tipo de extensão

Extensão de instância

Número de extensão registrado

461

Revisão

1

Dependências de extensão e versão

OpenXR 1.0

Data da última modificação

2024-09-05

Colaboradores

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Visão geral

A câmera de passagem pode demorar para inicializar e pode não estar disponível imediatamente. Essa extensão informa aos aplicativos o estado atual da câmera de passagem.

Conferir o estado atual da câmera de passagem

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

Descrições dos parâmetros

  • session é um identificador XrSession criado anteriormente com xrCreateSession.
  • getInfo é qualquer informação que afete a determinação do estado da câmera.
  • cameraStateOutput é o estado atual da câmera.

xrGetPassthroughCameraStateANDROID recupera o estado atual da câmera de passagem.

A estrutura XrPassthroughCameraStateGetInfoANDROID é uma estrutura de entrada/saída que especifica os parâmetros da solicitação de estado da câmera. 

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

Descrições dos participantes

  • type é o XrStructureType dessa estrutura.
  • next é NULL ou um ponteiro para a próxima estrutura em uma cadeia de estruturas.

A enumeração XrPassthroughCameraStateANDROID identifica diferentes estados em que a câmera de passagem pode estar. 

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;

Os tipos enumerados têm os seguintes significados:

Tipo enumerado

Descrição

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

A câmera foi desativada por um app, pelo sistema ou pelo usuário.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

A câmera ainda está sendo ativada e não está pronta para uso.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

A câmera está pronta para uso.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

A câmera está em um estado de erro irrecuperável.

Novos tipos de objeto

Novos tipos de flags

Novas constantes de tipo enumerado

A enumeração XrStructureType foi ampliada com:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Novos tipos enumerados

Novas estruturas

Novas funções

Problemas

Histórico de versões

  • Revisão 1, 05/09/2024 (Spencer Quin)
  • Versão inicial.