התוסף XR_ANDROID_depth_texture של OpenXR

Name String

XR_ANDROID_depth_texture

סוג התוסף

תוסף למכונה

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

703

גרסה

1

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

OpenXR 1.0

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

2024-09-11

סטטוס כתובת ה-IP

לא ידוע על תלונות על הפרת זכויות יוצרים בנושא כתובת IP.

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

Sushant Kulkarni, ‏ Google

קארן אוברטורף (Cairn Overturf), Google

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

לונן צ'ן, Google

סקירה כללית

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

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

בדיקת יכולות המערכת

המבנה XrSystemDepthTrackingPropertiesANDROID מוגדר כך:

typedef struct XrSystemDepthTrackingPropertiesANDROID {
    XrStructureType    type;
    const void*        next;
    XrBool32           supportsDepthTracking;
} XrSystemDepthTrackingPropertiesANDROID;

תיאורי חברים

  • type הוא XrStructureType של המבנה הזה.
  • next הוא NULL או הפניה למבנה הבא בשרשרת המבנים. אין מבנים כאלה מוגדרים ב-OpenXR או בתוסף הזה.
  • supportsDepthTracking הוא XrBool32 שמציין אם המערכת הנוכחית תומכת במעקב עומק.

כדי לבדוק אם המערכת מסוגלת לעקוב אחרי עומק, אפליקציה יכולה להרחיב את המבנה XrSystemProperties באמצעות המבנה XrSystemDepthTrackingPropertiesANDROID בזמן הקריאה ל-xrGetSystemProperties.

שימוש תקין (מרומז)

רזולוציות של עומק שאילתות

הפונקציה xrEnumerateDepthResolutionsANDROID מוגדרת באופן הבא:

XrResult xrEnumerateDepthResolutionsANDROID(
    XrSession                                   session,
    uint32_t                                    resolutionCapacityInput,
    uint32_t*                                   resolutionCountOutput,
    XrDepthCameraResolutionANDROID*             resolutions);

תיאורי פרמטרים

  • session הוא XrSession שמפרט את רזולוציות העומק הנתמכות.
  • resolutionCapacityInput היא הקיבולת של resolutions, או 0 כדי לאחזר את הקיבולת הנדרשת.
  • resolutionCountOutput הוא הפניה למספר ה-uint64_t resolutions שנכתבו, או הפניה לקיבולת הנדרשת במקרה ש-resolutionCapacityInput לא מספיק.
  • resolutions הוא מצביע למערך של XrDepthCameraResolutionANDROID, אבל יכול להיות NULL אם resolutionCapacityInput הוא 0.
  • בקטע פרמטרים של גודל מאגר מפורט תיאור של אחזור הגודל הנדרש של resolutions.

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

שימוש תקין (מרומז)

קודי החזרה

הצלחה

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

כישלון

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_VALIDATION_FAILURE
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_SESSION_LOST
  • XR_ERROR_SIZE_INSUFFICIENT

המאפיין המסווג XrDepthCameraResolutionANDROID מתאר את רזולוציות העומק הנתמכות כשיוצרים XrDepthSwapchainANDROID. 

typedef enum XrDepthCameraResolutionANDROID {
    XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID = 0,
    XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID = 1,
    XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID = 2
    } XrDepthCameraResolutionANDROID;

תיאורים של ערכים ממוספרים

  • XR_DEPTH_CAMERA_RESOLUTION_80x80_ANDROID — הרזולוציה של תמונות העומק והתמונות של רמת הסמך היא 80x80.
  • XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID – הרזולוציה של תמונות העומק והתמונות של רמת האמון היא 160x160.
  • XR_DEPTH_CAMERA_RESOLUTION_320x320_ANDROID – הרזולוציה של תמונות העומק והביטחון היא 320x320.

יצירת שרשרת החלפה של עומק

XR_DEFINE_HANDLE(XrDepthSwapchainANDROID)

XrDepthSwapchainANDROID הוא ידית של swapchain עומק.

הפונקציה xrCreateDepthSwapchainANDROID מוגדרת כך: 

XrResult xrCreateDepthSwapchainANDROID(
    XrSession                                   session,
    const XrDepthSwapchainCreateInfoANDROID*    createInfo,
    XrDepthSwapchainANDROID*                    swapchain);

תיאורי פרמטרים

  • session הוא XrSession שיוצר את שרשרת ה-swap של העומק.

  • createInfo הוא הפניה למבנה XrDepthSwapchainCreateInfoANDROID שמכיל פרמטרים שישמשו ליצירת שרשרת ההחלפה.

  • swapchain הוא הפניה למזהה שבו מוחזר הערך שנוצר של XrDepthSwapchainANDROID.

האפליקציה יכולה להשתמש בפונקציה xrCreateDepthSwapchainANDROID כדי ליצור שרשרת תמונות עומק שמנהלת גם תמונות עומק וגם תמונות אמינות.

יכול להיות שבהמשך ייעשה שימוש במזהה של שרשרת ה-swap של העומק שהוחזרה בקריאות ל-API. צריך לפנות את ה-handle של XrDepthSwapchainANDROID בסופו של דבר באמצעות הפונקציה xrDestroyDepthSwapchainANDROID.

שימוש תקין (מרומז)

קודי החזרה

הצלחה

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

כישלון

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_SESSION_LOST
  • XR_ERROR_OUT_OF_MEMORY
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_LIMIT_REACHED

המבנה XrDepthSwapchainCreateInfoANDROID מוגדר כך: 

typedef struct XrDepthSwapchainCreateInfoANDROID {
    XrStructureType                       type;
    const void*                           next;
    XrDepthCameraResolutionANDROID        resolution;
    XrDepthSwapchainCreateFlagsANDROID    createFlags;
} XrDepthSwapchainCreateInfoANDROID;

תיאורי חברים

  • type הוא XrStructureType של המבנה הזה.
  • next הוא NULL או הפניה למבנה הבא בשרשרת המבנים. אין מבנים כאלה מוגדרים ב-OpenXR או בתוסף הזה.
  • resolution הוא הערך של XrDepthCameraResolutionANDROID שבו צריך ליצור את הטקסטורות של העומק והביטחון.
  • הערך של createFlags הוא XrDepthSwapchainCreateFlagsANDROID אחד או יותר.

המבנה XrDepthSwapchainCreateInfoANDROID מספק אפשרויות יצירה ל-XrDepthSwapchainANDROID כשהוא מועבר ל-xrCreateDepthSwapchainANDROID.

שימוש תקין (מרומז)

המאפיין XrDepthSwapchainCreateFlagsANDROID מציין את אפשרויות היצירה של XrDepthSwapchainANDROID. 

typedef XrFlags64 XrDepthSwapchainCreateFlagsANDROID;

הביטים התקינים של XrDepthSwapchainCreateFlagsANDROID מוגדרים על ידי XrDepthSwapchainCreateFlagBitsANDROID, שמוגדר באופן הבא: 

// Flag bits for XrDepthSwapchainCreateFlagsANDROID
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID = 0x00000001;
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID = 0x00000002;
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID = 0x00000004;
static const XrDepthSwapchainCreateFlagsANDROID XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID = 0x00000008;

הפונקציה xrDestroyDepthSwapchainANDROID מוגדרת כך: 

XrResult xrDestroyDepthSwapchainANDROID(
    XrDepthSwapchainANDROID                     swapchain);

תיאורי פרמטרים

  • swapchain הוא אחיזה של XrDepthSwapchainANDROID שנוצרה בעבר על ידי xrCreateDepthSwapchainANDROID.

הפונקציה xrDestroyDepthSwapchainANDROID משמידה את ה-swapchain של העומק.

שימוש תקין (מרומז)

בטיחות בשרשור

  • חובה לסנכרן באופן חיצוני את הגישה ל-swapchain ולכל כינויים משניים

קודי החזרה

הצלחה

  • XR_SUCCESS

כישלון

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_HANDLE_INVALID

גישה לתמונות טקסטורות של עומק

הפונקציה xrEnumerateDepthSwapchainImagesANDROID מוגדרת כך: 

XrResult xrEnumerateDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    uint32_t                                    depthImageCapacityInput,
    uint32_t*                                   depthImageCountOutput,
    XrDepthSwapchainImageANDROID*               depthImages);

תיאורי פרמטרים

  • depthSwapchain הוא XrDepthSwapchainANDROID שממנו מקבלים תמונות.
  • depthImageCapacityInput הוא הקיבולת של מערך depthImages, או 0 כדי לציין בקשה לאחזור הקיבולת הנדרשת.
  • depthImageCountOutput הוא הפניה למספר הפעמים ש-depthImages נכתב, או הפניה לקיבולת הנדרשת במקרה ש-depthImageCapacityInput לא מספיקה.
  • depthImages הוא הפניה למערך של מבנים מסוג XrDepthSwapchainImageANDROID. הערך יכול להיות NULL אם הערך של depthImageCapacityInput הוא 0.
  • בקטע פרמטרים של גודל מאגר מפורט תיאור של אחזור הגודל הנדרש של depthImages.

xrEnumerateDepthSwapchainImagesANDROID ממלא מערך של מבנים מסוג XrDepthSwapchainImageANDROID. המשאבים יהיו קבועים ותוקפים לכל משך החיים של XrDepthSwapchainANDROID. הפונקציה הזו פועלת באופן דומה לפונקציה xrEnumerateSwapchainImages.

שימוש תקין (מרומז)

קודי החזרה

הצלחה

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

כישלון

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_VALIDATION_FAILURE
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_SESSION_LOST
  • XR_ERROR_SIZE_INSUFFICIENT

המבנה XrDepthSwapchainImageANDROID מוגדר כך: 

typedef struct XrDepthSwapchainImageANDROID {
    XrStructureType    type;
    void*              next;
    const float*       rawDepthImage;
    const uint8_t*     rawDepthConfidenceImage;
    const float*       smoothDepthImage;
    const uint8_t*     smoothDepthConfidenceImage;
} XrDepthSwapchainImageANDROID;

תיאורי חברים

  • type הוא XrStructureType של המבנה הזה.
  • next הוא NULL או הפניה למבנה הבא בשרשרת המבנים. אין מבנים כאלה מוגדרים ב-OpenXR או בתוסף הזה.
  • rawDepthImage הוא NULL או המצביע לתמונות עומק גולמיות גם בתצוגה הימנית וגם בתצוגה השמאלית. הערכים הם ביחידות של מטרים. ערכים מיוחדים: הערך 0.0 מציין פיקסל עומק לא חוקי או ריק בעומק הגולמי, והערך Inf מציין עומק ידוע שנמצא למעשה במרחק אינסופי.
  • rawDepthConfidenceImage הוא NULL או המצביע לתמונות עומק גולמיות עם רמת ביטחון, גם בתצוגה השמאלית וגם בתצוגה הימנית.
  • smoothDepthImage הוא NULL או הסמן להחלקת תמונות עומק בשתי התצוגות, שמאלה וימינה. הערכים הם ביחידות של מטרים. ערכים מיוחדים: הערך 0.0 מציין פיקסל עומק לא חוקי או ריק בעומק החלק, והערך Inf מציין עומק ידוע שנמצא למעשה במרחק אינסופי.
  • smoothDepthConfidenceImage הוא NULL או הסמן להחלקת תמונות של רמת האמון של העומק גם בתצוגה השמאלית וגם בתצוגה הימנית.

XrDepthSwapchainImageANDROID מייצג את קובצי התמונה של העומק מ-XrDepthSwapchainANDROID שאפשר לקרוא אותם, שמוקצים כפי שמתואר ב-XrDepthSwapchainCreateInfoANDROID::resolution וב-XrDepthSwapchainCreateInfoANDROID::createFlags בזמן הקריאה ל-xrCreateDepthSwapchainANDROID. לכל קובץ תמונה של עומק:

שימוש תקין (מרומז)

הפונקציה xrAcquireDepthSwapchainImagesANDROID מוגדרת בתור: 

XrResult xrAcquireDepthSwapchainImagesANDROID(
    XrDepthSwapchainANDROID                     depthSwapchain,
    const XrDepthAcquireInfoANDROID*            acquireInfo,
    XrDepthAcquireResultANDROID*                acquireResult);

תיאורי פרמטרים

אפליקציות יכולות להשתמש בפונקציה xrAcquireDepthSwapchainImagesANDROID כדי לקבל את האינדקס העדכני ביותר של תמונה זמינה ב-swapchain, כמו XrDepthAcquireResultANDROID::acquiredIndex, במערך XrDepthSwapchainImageANDROID שמנוהל על ידי xrEnumerateDepthSwapchainImagesANDROID. הערך המוחזר של XrDepthAcquireResultANDROID מכיל גם מידע נוסף, כמו שדה הראייה והתנוחה הנדרשים כדי לפרש את נתוני העומק. אפשר לקרוא מהחריץ שנרכש במערך התמונות בבטחה עד לקריאה הבאה ל-xrAcquireDepthSwapchainImagesANDROID.

אסור לבצע יותר מקריאה אחת ל-xrAcquireDepthSwapchainImagesANDROID בין כל זוג של קריאות תואמות ל-xrBeginFrame ול-xrEndFrame בסשן.

שימוש תקין (מרומז)

קודי החזרה

הצלחה

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

כישלון

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_VALIDATION_FAILURE
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_SESSION_LOST
  • XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID
  • XR_ERROR_CALL_ORDER_INVALID
  • XR_ERROR_LIMIT_REACHED
  • XR_ERROR_TIME_INVALID

המבנה XrDepthAcquireInfoANDROID מוגדר כך: 

typedef struct XrDepthAcquireInfoANDROID {
    XrStructureType    type;
    const void*        next;
    XrSpace            space;
    XrTime             displayTime;
} XrDepthAcquireInfoANDROID;

תיאורי חברים

  • type הוא XrStructureType של המבנה הזה.
  • next הוא NULL או הפניה למבנה הבא בשרשרת המבנים. אין מבנים כאלה מוגדרים ב-OpenXR או בתוסף הזה.
  • space הוא XrSpace שמגדיר את מסגרת העזר של התנוחה שמוחזרת ב-XrDepthAcquireResultANDROID::views.
  • displayTime הוא XrTime שמציין את הזמן שבו נעשה שימוש כדי לחשב את התנוחה של התנוחה שהוחזרה ב-XrDepthAcquireResultANDROID::views. האפליקציות צריכות לעבור את זמן התצוגה הצפוי שלהן במסגרת הנוכחית.

שימוש תקין (מרומז)

המבנה XrDepthAcquireResultANDROID מוגדר כך: 

typedef struct XrDepthAcquireResultANDROID {
    XrStructureType       type;
    const void*           next;
    uint32_t              acquiredIndex;
    XrTime                exposureTimestamp;
    XrDepthViewANDROID    views[2];
} XrDepthAcquireResultANDROID;

תיאורי חברים

  • type הוא XrStructureType של המבנה הזה.
  • next הוא NULL או הפניה למבנה הבא בשרשרת המבנים. אין מבנים כאלה מוגדרים ב-OpenXR או בתוסף הזה.
  • acquiredIndex הוא האינדקס של הטקסטורה שנרכשה במערך XrDepthSwapchainImageANDROID שממוספר על ידי xrEnumerateDepthSwapchainImagesANDROID.
  • exposureTimestamp הוא XrTime שמציין את הזמן שבו צולמה מפת העומק.
  • views הוא מערך של שני XrDepthViewANDROID, אחד לכל עין, כאשר האינדקס 0 הוא העין השמאלית והאינדקס 1 הוא העין הימנית.

שימוש תקין (מרומז)

המבנה XrDepthViewANDROID מוגדר כך: 

typedef struct XrDepthViewANDROID {
    XrStructureType    type;
    const void*        next;
    XrFovf             fov;
    XrPosef            pose;
} XrDepthViewANDROID;

תיאורי חברים

  • type הוא XrStructureType של המבנה הזה.
  • next הוא NULL או הפניה למבנה הבא בשרשרת המבנים. אין מבנים כאלה מוגדרים ב-OpenXR או בתוסף הזה.
  • fov הוא XrFovf שמציין את שדה הראייה ששימש ליצירת התצוגה הזו. התצוגה אף פעם לא הופכת לרוחב או לאורך.
  • pose הוא XrPosef שמציין את התנוחה שממנה בוצע הרינדור של מפת העומק. מסגרת העזר מצוינה ב-XrDepthAcquireInfoANDROID.

שימוש תקין (מרומז)

קוד לדוגמה למעקב עומק

קוד הדוגמה הבא מדגים איך לצלם תמונות עומק.

XrInstance instance;  // previously initialized
XrSystemId systemId;  // previously initialized
XrSession session; // previously initialized
XrSpace stageSpace; // space created for XR_REFERENCE_SPACE_TYPE_STAGE.

// The function pointers are previously initialized using xrGetInstanceProcAddr.
PFN_xrCreateDepthSwapchainANDROID xrCreateDepthSwapchainANDROID; // previously initialized
PFN_xrDestroyDepthSwapchainANDROID xrDestroyDepthSwapchainANDROID; // previously initialized
PFN_xrEnumerateDepthSwapchainImagesANDROID xrEnumerateDepthSwapchainImagesANDROID; // previously initialized
PFN_xrEnumerateDepthResolutionsANDROID xrEnumerateDepthResolutionsANDROID; // previously initialized
PFN_xrAcquireDepthSwapchainImagesANDROID xrAcquireDepthSwapchainImagesANDROID; // previously initialized

// Inspect system capability
XrSystemProperties properties{XR_TYPE_SYSTEM_PROPERTIES};
XrSystemDepthTrackingPropertiesANDROID depthTrackingProperties{XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID};
properties.next = &depthTrackingProperties;
CHK_XR(xrGetSystemProperties(instance, systemId, &properties));
if (!depthTrackingProperties.supportsDepthTracking) {
  // depth tracking is not supported.
  return;
}

// Query the supported depth resolution.
XrDepthCameraResolutionANDROID supportedDepthResolution;
uint32_t supportedResolutionCount = 0;
CHK_XR(xrEnumerateDepthResolutionsANDROID(
    session, 1, &supportedResolutionCount, &supportedDepthResolution));

// Define metadata to access the raw and smooth depth along with confidences.
XrDepthSwapchainCreateInfoANDROID swapchainCreateInfo = {
  .type = XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID,
  .next = nullptr,
  .createFlags =
    XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID |
    XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID |
    XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID |
    XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID,

  // Use the resolution supported by the runtime.
  .resolution = supportedDepthResolution,
};

XrDepthSwapchainANDROID depthSwapchain;
CHK_XR(xrCreateDepthSwapchainANDROID(
    session, &swapchainCreateInfo, &depthSwapchain));

// Enumerate depth images.
uint32_t imageCountOutput = 0;
CHK_XR(xrEnumerateDepthSwapchainImagesANDROID(
    depthSwapchain, 0, &imageCountOutput, nullptr));
std::vector<XrDepthSwapchainImageANDROID> depthImages(imageCountOutput);
for (int i = 0; i < imageCountOutput; i++) {
  depthImages[i].type = XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID;
}
CHK_XR(xrEnumerateDepthSwapchainImagesANDROID(
  depthSwapchain, imageCountOutput, &imageCountOutput, depthImages.data()));

while (1) {
    // ...
    // For every frame in frame loop
    // ...

    XrFrameState frameState;  // previously returned from xrWaitFrame
    const XrTime time = frameState.predictedDisplayTime;

    XrDepthAcquireInfoANDROID acquireInfo = {
        .type = XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID,
        .space = stageSpace,
        .displayTime = time};
    XrDepthAcquireResultANDROID acquireResult = {
        .type = XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID,
    };
    CHK_XR(xrAcquireDepthImagesANDROID(
        depthSwapchain, &acquireInfo, &acquireResult));

    // Each value in a depth image corresponds to a point in the real world.
    // The sample code in this section shows how to find the stageSpace position
    // of the point corresponding to a particular value in the depth image.

    // For this sample code, assume we are using a right handed coordinate system
    // with +X to the right, +Y up and -Z forward.

    XrDepthSwapchainImageANDROID *image =
        &depthImages[acquireResult.acquireIndex];

    // Assume supported resolution is XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID.
    const int imageResolution = 160;
    int imageY = // value in [0, imageResolution)
    int imageX = // value in [0, imageResolution)

    // Get depth value from left eye.
    // A right depth value would be obtained with the following expression:
    // depthR = image->rawDepthImage[imageResolution*imageResolution+i*imageResolution+j]
    float depthL = image->rawDepthImage[imageY*imageResolution + imageX];
    XrDepthViewANDROID viewL = acquireResult.views[0];

    float tanL = tanf(viewL.fov.angleLeft);
    float tanR = tanf(viewL.fov.angleRight);
    float tanU = tanf(viewL.fov.angleUp);
    float tanD = tanf(viewL.fov.angleDown);

    float s = (imageX + 0.5f) / (float)imageResolution;
    float t = (imageY + 0.5f) / (float)imageResolution;

    // Calculate the depth camera space position of the point
    // corresponding to this depth value.
    XrVector3f posInCameraSpace;
    posInCameraSpace.z = -depthL;
    posInCameraSpace.x = (tanL + (tanR - tanL)*s)*depthL;
    posInCameraSpace.y = (tanB + (tanU - tanB)*t)*depthL;

    XrPosef depthCameraPoseL = viewL.pose;
    // Transform posInCameraSpace by depthCameraPoseL

    // ...
    // Finish frame loop
    // ...
}

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

ערכי קבועים חדשים של טיפוס בן מנייה (enum)

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

  • XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID

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

  • XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID

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

  • XR_TYPE_DEPTH_SWAPCHAIN_CREATE_INFO_ANDROID
  • XR_TYPE_DEPTH_VIEW_ANDROID
  • XR_TYPE_DEPTH_ACQUIRE_INFO_ANDROID
  • XR_TYPE_DEPTH_ACQUIRE_RESULT_ANDROID
  • XR_TYPE_SYSTEM_DEPTH_TRACKING_PROPERTIES_ANDROID
  • XR_TYPE_DEPTH_SWAPCHAIN_IMAGE_ANDROID

Enums חדשים

מבנים חדשים

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

בעיות

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

  • גרסה 1, 09 בספטמבר 2024 (Levana Chen)
    • תיאור ראשוני של התוסף

OpenXR™‎ והלוגו של OpenXR הם סימנים מסחריים בבעלות The Khronos Group Inc., והם רשומים כסימנים מסחריים בסין, באיחוד האירופי, ביפן ובבריטניה.