اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
التقاط الألوان على نطاق واسع
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بالنسبة إلى الأجهزة التي تعمل بالإصدار 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:
لمزيد من التفاصيل حول التقاط الألوان العريضة النطاق في Camera HAL، اطّلِع على القيمة التالية
في metadata_definitions.xml:
واجهات برمجة التطبيقات
بالنسبة إلى الأجهزة التي تعمل بالإصدار Android 14 أو الإصدارات الأحدث والمزوّدة بميزة التقاط الصور بنطاق الألوان الواسع، يمكن لعملاء الكاميرا استخدام واجهات برمجة التطبيقات العامة التالية:
يتم اشتقاق القيم المتوقّعة للمَعلمة ColorSpace من فئة
ColorSpace.Named. في Android 14، تتوفّر اللغات SRGB وDISPLAY_P3
وBT2020_HLG.
التحقُّق
للتأكّد من صحة عملية التنفيذ لميزة التقاط مجموعة الألوان العريضة Display P3، يمكنك إجراء
الاختبارات التالية.
CTS
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test8BitColorSpaceOutputCharacteristicsandroid.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test10BitColorSpaceOutputCharacteristicsandroid.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testColorSpaceProfileMapandroid.hardware.camera2.cts.ImageReaderTest#testDisplayP3Jpegandroid.hardware.camera2.cts.ImageReaderTest#testDisplayP3JpegRepeatingandroid.hardware.camera2.cts.ImageReaderTest#testDisplayP3Heicandroid.hardware.camera2.cts.ImageReaderTest#testDisplayP3HeicRepeating
ITS
يمكنك إجراء اختبارات
مجموعة اختبارات صور الكاميرا (ITS)
للتحقّق مما يلي:
- توفُّر ملف تعريف ICC يتضمّن إحداثيات اللونية الصحيحة
- تحتوي الصورة على بيانات بكسل خارج نطاق sRGB
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Wide gamut capture\n\nFor devices running Android 14 or higher, Android\nprovides support for Display P3 wide gamut capture. Devices can capture wide\ngamut color images in JPEG format with the `ImageReader` class without\nusing [10-bit HDR](/docs/core/camera/10-bit-camera-output). This feature lets\ndevices\nrequest camera capture in a wide gamut color space to the Camera2 framework\nthrough the [`setColorSpace`](https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration#setColorSpace(android.graphics.ColorSpace.Named)) parameter in `SessionConfiguration`.\n\nRequirements\n------------\n\nTo support wide gamut capture, the device must have access to a camera with wide\ngamut color capabilities.\n\nImplementation\n--------------\n\nTo support Display P3 wide gamut capture requests, do the following:\n\n- Read the `colorSpace` field in [`Stream.aidl`](https://android.googlesource.com/platform/hardware/interfaces/+/refs/heads/android16-release/camera/device/aidl/android/hardware/camera/device/Stream.aidl) and apply it to the output stream.\n- Implement the `android.request.availableColorSpaceProfilesMap` metadata entry.\n- Report the `COLOR_SPACE_PROFILES` capability in `android.request.availableCapabilities`.\n\nFor a reference Camera HAL implementation supporting P3 wide gamut capture,\nsee the following in `/hardware/google/camera/devices/EmulatedCamera/hwl/\nconfigs/emu_camera_back.json`:\n\n- [`android.request.availableCapabilities`](https://android.googlesource.com/platform/hardware/google/camera/+/refs/heads/android16-release/devices/EmulatedCamera/hwl/configs/emu_camera_back.json#183)\n- [`android.request.availableColorSpaceProfilesMap`](https://android.googlesource.com/platform/hardware/google/camera/+/refs/heads/android16-release/devices/EmulatedCamera/hwl/configs/emu_camera_back.json#211)\n\nFor further details on wide gamut capture in the Camera HAL, see the following\nvalues in `metadata_definitions.xml`:\n\n- [`availableColorSpaceProfiles`](https://android.googlesource.com/platform/system/media/+/refs/heads/android16-release/camera/docs/metadata_definitions.xml#7163)\n- [`availableColorSpaceProfilesMap`](https://android.googlesource.com/platform/system/media/+/refs/heads/android16-release/camera/docs/metadata_definitions.xml#7184)\n- [`COLOR_SPACE_PROFILES`](https://android.googlesource.com/platform/system/media/+/refs/heads/android16-release/camera/docs/metadata_definitions.xml#6610)\n\n### APIs\n\nFor devices running Android 14 or higher with support\nfor wide gamut capture, camera clients can use the following public APIs:\n\n- [`ColorSpaceProfiles`](https://developer.android.com/reference/android/hardware/camera2/params/ColorSpaceProfiles)\n- [`setColorSpace`](https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration#setColorSpace(android.graphics.ColorSpace.Named))\n\nThe expected values for the `ColorSpace` parameter are derived from the\n[`ColorSpace.Named`](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.Named)\nclass. In Android 14, `SRGB`, `DISPLAY_P3`,\nand `BT2020_HLG` are supported.\n\nValidation\n----------\n\nTo validate your implementation of Display P3 wide gamut capture support, run\nthe following tests.\n\n### CTS\n\n- `android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test8BitColorSpaceOutputCharacteristics`\n- `android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test10BitColorSpaceOutputCharacteristics`\n- `android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testColorSpaceProfileMap`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Jpeg`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3JpegRepeating`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Heic`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3HeicRepeating`\n\n### ITS\n\nRun the\n[Camera Image Test Suite (ITS)](/docs/compatibility/cts/camera-its)\ntests to validate the following:\n\n- Presence of an ICC profile with correct chromaticity coordinates\n- Image contains pixel data outside the sRGB gamut"]]
