إضافة XR_ANDROID_depth_texture OpenXR

سلسلة الاسم

XR_ANDROID_depth_texture

نوع الإضافة

إضافة مثيل

رقم الإضافة المسجَّل

703

المراجعة

1

التبعيات المتعلّقة بالإصدارات والإضافات

OpenXR 1.0

تاريخ آخر تعديل

2024-09-11

حالة عنوان IP

ما مِن مطالبات معروفة بعناوين IP.

المساهمون

Sushant Kulkarni، Google

"كايرن أوفرتوف"، Google

سبنسر كوين، Google

ليفانا تشين، من Google

نظرة عامة

تسمح هذه الإضافة للتطبيق بطلب خرائط العمق للبيئة الواقعية حول سماعة الرأس وطلبات الاستعلام عن درجات دقة العمق المتوافقة عند الإنشاء.

تهدف هذه الإضافة إلى عرض عمق أولي وسلس للاحتجاب واختبارات التأثير وغيرها من المهام المحددة التي تستخدِم هندسة المشهد الدقيقة، مثل رصد الوجوه المزيفة.

فحص قدرة النظام

يتم تعريف بنية 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 ل retrieving the required capacity.
  • 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 هو معرّف سلسلة تبديل العمق.

يتم تعريف الدالة xrCreateDepthSwapchainANDROID على النحو التالي: 

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

أوصاف المَعلمات

  • session هو XrSession الذي ينشئ سلسلة التبديل للعمق.

  • createInfo هو مؤشر إلى بنية XrDepthSwapchainCreateInfoANDROID التي تحتوي على مَعلمات ستُستخدَم لإنشاء سلسلة التبديل.

  • swapchain هو مؤشر إلى معرّف يتم من خلاله عرض العنصر الذي تم إنشاؤه XrDepthSwapchainANDROID.

يمكن للتطبيق استخدام الدالة xrCreateDepthSwapchainANDROID لإنشاء سلسلة تبديل بيانات العمق التي تدير كلّ من صور العمق واقتناع العميل.

يمكن استخدام معرّف سلسلة التبديل لالتقاط العمق الذي تم إرجاعه لاحقًا في طلبات البيانات من واجهة برمجة التطبيقات. يجب أخيرًا تحرير معرّف 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 وأيّ أسماء معرِّفة فرعية خارجيًا.

رموز الإرجاع

تم بنجاح

  • 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. لكل صورة عمق:

  • يتم ترتيب قيم الصور في الذاكرة بترتيب تنازلي للصفوف، بدون إضافة مسافات بين الصفوف.
  • تظهر القيمة الأولى في أعلى يمين الصفحة، والقيمة الأخيرة في أسفل يمين الصفحة.
  • يتم تحديد حجم الذاكرة التي تتم الإشارة إليها من خلال قيمة xrEnumerateDepthSwapchainImagesANDROID ويتم ضبطها من خلال XrDepthSwapchainCreateInfoANDROID::resolution أثناء استدعاء xrCreateDepthSwapchainANDROID. على سبيل المثال، إذا كان resolution يساوي XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID، سيكون حجم صور العمق هو 2*160*160*sizeof(float).
  • يجب أن تكون قيمة rawDepthImage هي NULL إذا لم يتم ضبط XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID فيXrDepthSwapchainCreateInfoANDROID::createFlags.
  • يجب أن تكون قيمة rawDepthConfidenceImage هي NULL إذا لم يتم ضبط XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID فيXrDepthSwapchainCreateInfoANDROID::createFlags.
  • يجب أن تكون قيمة smoothDepthImage هي NULL إذا لم يتم ضبط XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID فيXrDepthSwapchainCreateInfoANDROID::createFlags.
  • يجب أن تكون قيمة smoothDepthConfidenceImage هي NULL إذا لم يتم ضبط XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID فيXrDepthSwapchainCreateInfoANDROID::createFlags.

الاستخدام الصالح (ضمني)

يتم تعريف الدالة xrAcquireDepthSwapchainImagesANDROID على النحو التالي: 

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

أوصاف المَعلمات

  • depthSwapchain هو معرّف XrDepthSwapchainANDROID لملف الصورة ذات العمق.
  • ‫acquireInfo هو XrDepthAcquireInfoANDROID يحتوي على معلومات عن كيفية الحصول على صورة العمق.
  • acquireResult هو XrDepthAcquireResultANDROID المُعاد الذي يحتوي على معلومات عن صورة العمق التي تم الحصول عليها.

يمكن للتطبيقات استخدام الدالة xrAcquireDepthSwapchainImagesANDROID للحصول على أحدث فهرس متاح لسلسلة التبديل، مثل 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
    // ...
}

أنواع العناصر الجديدة

ثوابت التعداد الجديدة

تم توسيع قائمة 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

عمليات التعداد الجديدة

الهياكل الجديدة

دوال جديدة

المشاكل

سجلّ الإصدارات

  • المراجعة 1، ‎09-09-2024 (ليلى زين)
    • الوصف الأوّلي للإضافة

‫OpenXR™ وشعار OpenXR هما علامتان تجاريتان مملوكتان لشركة The Khronos Group Inc. ومسجَّلتان كعلامتَين تجاريتَين في الصين والاتحاد الأوروبي واليابان والمملكة المتحدة.