התוסף 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

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

• XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

משתני Enum חדשים

• XrPassthroughCameraStateANDROID

מבנים חדשים

• XrPassthroughCameraStateGetInfoANDROID

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

• xrGetPassthroughCameraStateANDROID

בעיות

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

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