החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
צילום בטווח רחב של צבעים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במכשירים עם Android מגרסה 14 ואילך, מערכת Android תומכת בצילומים בטווח רחב של צבעים (Display P3). מכשירים יכולים לצלם תמונות צבעוניות עם מגוון רחב של צבעים בפורמט JPEG עם הכיתה ImageReader, בלי להשתמש בHDR של 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:
לפרטים נוספים על צילום בטווח רחב ב-HAL של המצלמה, ראו את הערכים הבאים ב-metadata_definitions.xml:
ממשקי API
במכשירים עם Android מגרסה 14 ואילך עם תמיכה בצילומים בטווח רחב של צבעים, לקוחות המצלמה יכולים להשתמש בממשקי ה-API הציבוריים הבאים:
הערכים הצפויים לפרמטר 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
מריצים את הבדיקות של Camera Image Test Suite (ITS) כדי לאמת את הדברים הבאים:
- נוכחות של פרופיל ICC עם קואורדינטות צבעיות נכונות
- התמונה מכילה נתוני פיקסלים מחוץ לטווח הצבעים של sRGB
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],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"]]
