التقاط سلسلة واسعة

بالنسبة إلى الأجهزة التي تعمل بالإصدار 14 من نظام التشغيل Android أو الإصدارات الأحدث، يقدّم نظام التشغيل Android إمكانية التقاط مجموعة الألوان العريضة Display P3. يمكن للأجهزة التقاط صور ألوان عريضة النطاق بتنسيق JPEG باستخدام فئة ImageReader بدون استخدام النطاق العالي الديناميكية بدقة 10 بت. وتتيح هذه الميزة للأجهزة طلب التقاط كاميرا في مساحة ألوان واسعة النطاق لإطار عمل Camera2 من خلال المَعلمة setColorSpace في SessionConfiguration.

المتطلبات

لتفعيل ميزة التقاط الألوان بدرجة عريضة، يجب أن يكون بالجهاز إمكانية الوصول إلى كاميرا تتضمّن إمكانات ألوان بدرجة عريضة.

التنفيذ

لتلبية طلبات التقاط الصور باستخدام نطاق الألوان الواسع Display P3، عليك اتّباع الخطوات التالية:

• اقرأ حقل colorSpace في Stream.aidl وانطبقه على بث الإخراج.
• نفِّذ إدخال البيانات الوصفية android.request.availableColorSpaceProfilesMap.
• أبلِغ عن إمكانية COLOR_SPACE_PROFILES في android.request.availableCapabilities.

للحصول على مرجع لتنفيذ Camera HAL يتوافق مع التقاط مجموعة الألوان العريضة P3، يُرجى الاطّلاع على ما يلي في /hardware/google/camera/devices/EmulatedCamera/hwl/ configs/emu_camera_back.json:

• android.request.availableCapabilities
• android.request.availableColorSpaceProfilesMap

لمزيد من التفاصيل حول التقاط الألوان العريضة النطاق في Camera HAL، اطّلِع على القيمة التالية في metadata_definitions.xml:

• availableColorSpaceProfiles
• availableColorSpaceProfilesMap
• COLOR_SPACE_PROFILES

واجهات برمجة التطبيقات

بالنسبة إلى الأجهزة التي تعمل بالإصدار Android 14 أو الإصدارات الأحدث والمزوّدة بميزة التقاط الصور بنطاق الألوان الواسع، يمكن لعملاء الكاميرا استخدام واجهات برمجة التطبيقات العامة التالية:

• ColorSpaceProfiles
• setColorSpace

يتم اشتقاق القيم المتوقّعة للمَعلمة ColorSpace من فئة ColorSpace.Named. في Android 14، تتوفّر SRGB وDISPLAY_P3 وBT2020_HLG.

التحقُّق

للتأكّد من صحة عملية التنفيذ لميزة التقاط مجموعة الألوان العريضة Display P3، يمكنك إجراء الاختبارات التالية.

مجموعة أدوات اختبار التوافق (CTS)

• android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test8BitColorSpaceOutputCharacteristics
• android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test10BitColorSpaceOutputCharacteristics
• android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testColorSpaceProfileMap
• android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Jpeg
• android.hardware.camera2.cts.ImageReaderTest#testDisplayP3JpegRepeating
• android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Heic
• android.hardware.camera2.cts.ImageReaderTest#testDisplayP3HeicRepeating

ITS

يمكنك إجراء اختبارات مجموعة اختبارات صور الكاميرا (ITS) للتحقّق مما يلي:

• توفُّر ملف تعريف ICC يتضمّن إحداثيات اللونية الصحيحة
• تحتوي الصورة على بيانات بكسل خارج سلسلة sRGB