Ekstensi OpenXR XR_ANDROID_passthrough_camera_state

String Nama

XR_ANDROID_passthrough_camera_state

Jenis Ekstensi

Ekstensi instance

Registered Extension Number

461

Revisi

1

Dependensi Ekstensi dan Versi

OpenXR 1.0

Tanggal Terakhir Diubah

2024-09-05

Kontributor

Spencer Quin, Google

Jared Finder, Google

Kevin Moule, Google

Nihav Jain, Google

Ringkasan

Kamera passthrough dapat memerlukan waktu untuk memulai dan mungkin tidak langsung tersedia. Ekstensi ini memungkinkan aplikasi mengetahui status kamera passthrough saat ini.

Mendapatkan status kamera passthrough saat ini

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

Deskripsi Parameter

  • session adalah nama sebutan XrSession yang dibuat sebelumnya dengan xrCreateSession.
  • getInfo adalah info apa pun yang akan memengaruhi cara menentukan status kamera.
  • cameraStateOutput adalah status kamera saat ini.

xrGetPassthroughCameraStateANDROID mengambil status saat ini dari kamera passthrough.

Struktur XrPassthroughCameraStateGetInfoANDROID adalah struct input/output yang menentukan parameter permintaan status kamera. 

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

Deskripsi Anggota

  • type adalah XrStructureType dari struktur ini.
  • next adalah NULL atau pointer ke struktur berikutnya dalam rantai struktur.

Enumerasi XrPassthroughCameraStateANDROID mengidentifikasi berbagai status yang dapat dimiliki kamera 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;

Enum memiliki arti berikut:

Enum

Deskripsi

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

Kamera telah dinonaktifkan oleh aplikasi, sistem, atau pengguna.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

Kamera masih online dan belum siap digunakan.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

Kamera siap digunakan.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

Kamera dalam status error yang tidak dapat dipulihkan.

Jenis Objek Baru

Jenis Tanda Baru

Konstanta Enum Baru

Enumerasi XrStructureType diperluas dengan:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

Enum Baru

Struktur Baru

Fungsi Baru

Masalah

Histori Versi

  • Revisi 1, 05-09-2024 (Spencer Quin)
  • Versi awal.