إضافة OpenXR‏ XR_ANDROID_passthrough_camera_state

سلسلة الاسم

XR_ANDROID_passthrough_camera_state

نوع الإضافة

إضافة مثيل

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

461

المراجعة

1

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

OpenXR 1.0

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

2024-09-05

المساهمون

سبنسر كوين، Google

جاريد فايندر، Google

كيفن مول، Google

نيهاف جاين، Google

نظرة عامة

قد يستغرق بدء تشغيل كاميرا "العرض المباشر" بعض الوقت وقد لا تكون متاحة على الفور. تتيح هذه الإضافة للتطبيقات معرفة الحالة الحالية لكاميرا العرض المباشر.

الحصول على الحالة الحالية للكاميرا التي تتيح الرؤية من خلال

XrResult xrGetPassthroughCameraStateANDROID(
    XrSession                                   session,
    const XrPassthroughCameraStateGetInfoANDROID* getInfo,
    XrPassthroughCameraStateANDROID*            cameraStateOutput);

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

  • session هو معرّف XrSession تم إنشاؤه سابقًا باستخدام xrCreateSession.
  • getInfo هي أي معلومات ستؤثّر في كيفية تحديد حالة الكاميرا.
  • cameraStateOutput هي الحالة الحالية للكاميرا.

يسترجع xrGetPassthroughCameraStateANDROID الحالة الحالية لكاميرا العرض المباشر.

بنية XrPassthroughCameraStateGetInfoANDROID هي بنية input/output تحدد مَعلمات طلب حالة الكاميرا. 

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;

تحمل قوائم القيم المحدَّدة المعاني التالية:

تعداد

الوصف

XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID

تم إيقاف الكاميرا من خلال تطبيق أو النظام أو المستخدم.

XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID

لا تزال الكاميرا في مرحلة الربط بالإنترنت وليست جاهزة للاستخدام بعد.

XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID

أصبحت الكاميرا جاهزة للاستخدام.

XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID

الكاميرا في حالة خطأ يتعذّر إصلاحه.

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

أنواع الإبلاغ الجديدة

ثوابت قائمة التعداد الجديدة

تمّت إضافة ما يلي إلى التعداد XrStructureType:

  • XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID

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

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

الدوالّ الجديدة

المشاكل

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

  • المراجعة 1، ‎05-09-2024 (سبنسر كوين)
  • الإصدار الأولي