התוסף XR_ANDROID_passthrough_camera_state ל-OpenXR

מחרוזת שם

XR_ANDROID_passthrough_camera_state

סוג התוסף

תוסף למכונה

מספר תוסף רשום

461

גרסה

1

תלות בתוספים ובגרסאות

OpenXR 1.0

תאריך השינוי האחרון

2024-09-05

שותפים ביצירת התוכן

ספנסר קווין (Spencer Quin), Google

Jared Finder, ‏ Google

Kevin Moule, ‏ Google

Nihav Jain, ‏ Google

סקירה כללית

יכול להיות שיחלוף זמן מה עד שהמצלמה שתומכת ב-Passthrough תופעל, ויכול להיות שהיא לא תהיה זמינה באופן מיידי. התוסף הזה מאפשר לאפליקציות לדעת מה הסטטוס הנוכחי של המצלמה עם העברת הנתונים.

אחזור המצב הנוכחי של מצלמת העברה

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;

למאפייני enum יש את המשמעויות הבאות:

טיפוסים בני מנייה (enum)

תיאור

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

המצלמה הושבתה על ידי אפליקציה, המערכת או המשתמש.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

המצלמה עדיין לא מחוברת לאינטרנט ולא מוכנה לשימוש.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

המצלמה מוכנה לשימוש.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

המצלמה נמצאת במצב שגיאה שלא ניתן לשחזר.

סוגי אובייקטים חדשים

סוגי דגלים חדשים

קבועים חדשים של Enum

המניין XrStructureType הורחב עם:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

משתני Enum חדשים

מבנים חדשים

פונקציות חדשות

בעיות

היסטוריית הגרסאות

  • גרסה 1, 5 בספטמבר 2024 (Spencer Quin)
  • הגרסה הראשונית.