XR_ANDROID_depth_texture

Name String

XR_ANDROID_depth_texture

نوع الإضافة

إضافة مثيل

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

703

المراجعة

1

حالة التصديق

لم تتم المصادقة

الاعتماديات على الإضافات والإصدارات

OpenXR 1.0

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

2024-09-11

حالة عنوان IP

ما مِن مطالبات معروفة بشأن الملكية الفكرية.

المساهمون

"سوشانت كولكارني"، Google
"كيرن أوفرتوف"، Google
"سبنسر كوين"، Google
"ليفانا تشين"، Google

نظرة عامة

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

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

ملاحظة

يتم إنشاء خرائط العمق بواسطة وقت التشغيل ومشاركتها مع التطبيق باستخدام XrDepthSwapchainANDROID . يجب ألا يغيّر وقت التشغيل دقة صور العمق التي يتم عرضها من خلال xrEnumerateDepthResolutionsANDROID طوال مدة تشغيل التطبيق.

الأذونات

يعرض هذا الامتداد نسيج عمق تم تصغير حجمه للحدّ من المخاوف بشأن معلومات تكشف الهوية الشخصية. يجب أن تتضمّن تطبيقات Android الإذن android.permission.SCENE_UNDERSTANDING_FINE في ملف البيان لأنّ هذه الإضافة تعرض هندسة البيئة. يُعدّ الإذن android.permission.SCENE_UNDERSTANDING_FINE إذنًا خطيرًا. يجب أن يطلب التطبيق الإذن أثناء التشغيل لاستخدام الوظائف التالية:

(مستوى الحماية: خطير)

فحص إمكانات النظام

يتم تعريف بنية XrSystemDepthTrackingPropertiesANDROID على النحو التالي:

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

أوصاف الأعضاء

  • type هو XrStructureType لهذه البنية.
  • next هو NULL أو مؤشر إلى البنية التالية في سلسلة البنية. لم يتم تحديد أي بنى من هذا النوع في OpenXR الأساسية أو في هذه الإضافة.
  • ‫supportsDepthTracking هو XrBool32 يشير إلى ما إذا كان النظام الحالي يتيح تتبُّع العمق.

يمكن لأحد التطبيقات التحقّق مما إذا كان النظام قادرًا على تتبُّع العمق من خلال توسيع XrSystemProperties باستخدام بنية XrSystemDepthTrackingPropertiesANDROID عند استدعاء xrGetSystemProperties .

إذا كانت بيئة التشغيل تعرض XR_FALSE للسمة supportsDepthTracking، يجب أن تعرض بيئة التشغيل XR_ERROR_FEATURE_UNSUPPORTED من xrCreateDepthSwapchainANDROID .

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

حلول لمشاكل عمق طلب البحث

يتم تعريف الدالة 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_ANDROID_depth_texture قبل استدعاء xrEnumerateDepthResolutionsANDROID
  • يجب أن يكون session معرّفًا صالحًا لـ XrSession
  • يجب أن يكون resolutionCountOutput مؤشرًا إلى قيمة uint32_t
  • إذا لم يكن resolutionCapacityInput هو 0 ، resolutions يجب أن يكون مؤشرًا إلى مصفوفة من قيم resolutionCapacityInput XrDepthCameraResolutionANDROID

رموز الإرجاع

ناجحة

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

فشل

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

يصف تعداد 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,
    XR_DEPTH_CAMERA_RESOLUTION_MAX_ENUM_ANDROID = 0x7FFFFFFF
} 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 لإنشاء سلسلة تبديل لبيانات العمق تدير كلاً من صور العمق وصور الثقة.

  • يجب أن تعرض بيئة التشغيل XR_ERROR_FEATURE_UNSUPPORTED إذا كان النظام لا يتيح تتبُّع العمق.
  • يجب أن تعرض بيئة التشغيل القيمة XR_ERROR_PERMISSION_INSUFFICIENT إذا لم يتم منح الأذونات المطلوبة للتطبيق الذي يستدعيها.
  • يجب أن يعرض وقت التشغيل القيمة XR_ERROR_VALIDATION_FAILURE إذا كانت درجة دقة العمق المحدّدة في XrDepthSwapchainCreateInfoANDROID غير متوافقة.
  • يجب أن ينشئ وقت التشغيل صورًا لمدى صحة العمق فقط عند ضبط وحدات البت المقابلة لـ createInfo عند إنشاء سلسلة التبديل.

يمكن استخدام مقبض سلسلة تبديل العمق الذي تم عرضه لاحقًا في طلبات البيانات من واجهة برمجة التطبيقات. يجب تحرير مقبض XrDepthSwapchainANDROID في النهاية من خلال الدالة xrDestroyDepthSwapchainANDROID.

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

رموز الإرجاع

ناجحة

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

فشل

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

يتم تعريف بنية 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;

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

  • ‫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: يشير إلى أنّ سلسلة التبديل ستوفّر صورًا أولية لمدى صحة بيانات العمق.

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

XrResult xrDestroyDepthSwapchainANDROID(
    XrDepthSwapchainANDROID                     swapchain);

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

تدمّر الدالة 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_ANDROID_depth_texture قبل استدعاء xrEnumerateDepthSwapchainImagesANDROID
  • يجب أن يكون depthSwapchain مقودًا صالحًا XrDepthSwapchainANDROID
  • يجب أن يكون depthImageCountOutput مؤشرًا إلى قيمة uint32_t
  • إذا لم يكن depthImageCapacityInput هو 0 ، depthImages يجب أن يكون مؤشرًا إلى مصفوفة من بنى depthImageCapacityInput XrDepthSwapchainImageANDROID

رموز الإرجاع

ناجحة

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

فشل

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

يتم تعريف بنية 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 . على سبيل المثال، إذا كانت قيمة XrDepthSwapchainCreateInfoANDROID :: resolution هي XR_DEPTH_CAMERA_RESOLUTION_160x160_ANDROID ، سيكون حجم صور العمق 2*160*160*sizeof(float) .
  • يجب أن تكون قيمة rawDepthImage هي NULL إذا لم يتضمّن XrDepthSwapchainCreateInfoANDROID :: createFlags القيمة XR_DEPTH_SWAPCHAIN_CREATE_RAW_DEPTH_IMAGE_BIT_ANDROID .
  • يجب أن تكون قيمة rawDepthConfidenceImage هي NULL إذا لم يتضمّن XrDepthSwapchainCreateInfoANDROID :: createFlags القيمة XR_DEPTH_SWAPCHAIN_CREATE_RAW_CONFIDENCE_IMAGE_BIT_ANDROID .
  • يجب أن تكون قيمة smoothDepthImage هي NULL إذا لم يتضمّن XrDepthSwapchainCreateInfoANDROID :: createFlags القيمة XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_DEPTH_IMAGE_BIT_ANDROID .
  • يجب أن تكون قيمة smoothDepthImage هي NULL إذا لم يتضمّن XrDepthSwapchainCreateInfoANDROID :: createFlags القيمة XR_DEPTH_SWAPCHAIN_CREATE_SMOOTH_CONFIDENCE_IMAGE_BIT_ANDROID .

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

يتم تعريف الدالة 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 المتطابقة في إحدى الجلسات.

  • قد يحظر وقت التشغيل إذا كان لا يزال يستخدم صور swapchain التي تم الحصول عليها سابقًا.
  • يجب أن تعرض بيئة التشغيل القيمة XR_ERROR_CALL_ORDER_INVALID إذا تم استدعاء xrAcquireDepthSwapchainImagesANDROID قبل xrBeginFrame أو بعد xrEndFrame .
  • يجب أن تعرض بيئة التشغيل القيمة XR_ERROR_LIMIT_REACHED إذا تم استدعاء xrAcquireDepthSwapchainImagesANDROID أكثر من مرة في كل إطار، أي في جلسة قيد التشغيل، بعد استدعاء xrBeginFrame لم يتم ربطه بـ xrEndFrame.
  • قد تعرض بيئة التشغيل القيمة XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID إذا لم تتوفّر بيانات عمق البيئة بعد. في حال حدوث ذلك، يجب أن يعيد التطبيق استدعاء الدالة xrAcquireDepthSwapchainImagesANDROID في إطار لاحق.

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

رموز الإرجاع

ناجحة

  • XR_SUCCESS
  • XR_SESSION_LOSS_PENDING

فشل

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

يتم تعريف بنية 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

float tanf(float);

// 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,
  // Use the resolution supported by the runtime.
  .resolution = supportedDepthResolution,
  .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,
};

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(xrAcquireDepthSwapchainImagesANDROID(
        depthSwapchain, &acquireInfo, &acquireResult));

    // Each value in a depth image corresponds to a point in the real world.
    // The sample code below 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.acquiredIndex];

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

    // Get depth value from left eye.
    // A right depth value is 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 = (tanD + (tanU - tanD)*t)*depthL;

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

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

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

الأوامر الجديدة

المنشآت الجديدة

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

New Bitmasks

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

  • XR_ANDROID_DEPTH_TEXTURE_EXTENSION_NAME
  • XR_ANDROID_depth_texture_SPEC_VERSION

  • تمديد XrObjectType :

    • XR_OBJECT_TYPE_DEPTH_SWAPCHAIN_ANDROID

  • تمديد XrResult :

    • XR_ERROR_DEPTH_NOT_AVAILABLE_ANDROID

  • توسيع XrStructureType :

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

المشاكل

سجلّ التعديلات

  • المراجعة 1، ‎09-09-2024 (Levana Chen)

    • الوصف الأوّلي للإضافة