XR_ANDROID_passthrough_camera_state Расширение OpenXR

Строка имени

XR_ANDROID_passthrough_camera_state

Тип расширения

Расширение экземпляра

Зарегистрированный внутренний номер

461

Редакция

1

Зависимости расширений и версий

ОпенXR 1.0

Дата последнего изменения

05.09.2024

Авторы

Спенсер Куин, Google

Джаред Файндер, Google

Кевин Мул, Google

Нихав Джайн, Google

Обзор

Запуск камеры проходного режима может занять некоторое время, и она может быть доступна не сразу. Это расширение позволяет приложениям узнавать текущее состояние сквозной камеры.

Получить текущее состояние сквозной камеры 

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

Описание параметров

  • session — это дескриптор XrSession, ранее созданный с помощью xrCreateSession .
  • getInfo — это любая информация, которая повлияет на определение состояния камеры.
  • cameraStateOutput — текущее состояние камеры.

xrGetPassthroughCameraStateANDROID извлекает текущее состояние сквозной камеры.

Структура XrPassthroughCameraStateGetInfoANDROID — это структура ввода-вывода, которая определяет параметры запроса состояния камеры.

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

Описания участников

  • type — это XrStructureType этой структуры.
  • next имеет значение NULL или указатель на следующую структуру в цепочке структур.

Перечисление XrPassthroughCameraStateANDROID определяет различные состояния, в которых может находиться сквозная камера.

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;

Перечисления имеют следующие значения:

Перечисление

Описание

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

Камера отключена приложением, системой или пользователем.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

Камера все еще подключена к сети и еще не готова к использованию.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

Камера готова к использованию.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

Камера находится в состоянии неисправимой ошибки.

Новые типы объектов

Новые типы флагов

Новые константы перечисления

Перечисление XrStructureType расширено:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Новые перечисления

Новые структуры

Новые функции

Проблемы

История версий

  • Редакция 1, 5 сентября 2024 г. (Спенсер Куин)
  • Начальная версия.