廣色域捕捉

對於運行 Android 14 或更高版本的設備,Android 提供對 Display P3 廣色域捕獲的支援。設備可以使用ImageReader類別擷取 JPEG 格式的廣色域彩色影像,而無需使用10 位元 HDR 。此功能可讓裝置透過SessionConfiguration中的setColorSpace參數向 Camera2 框架請求寬色域色彩空間中的相機擷取。

要求

為了支援廣色域捕捉,設備必須能夠使用具有廣色域色彩功能的相機。

執行

若要支援 Display P3 廣色域擷取請求,請執行下列操作:

  • 讀取Stream.aidl中的colorSpace欄位並將其套用到輸出流。
  • 實作android.request.availableColorSpaceProfilesMap元資料條目。
  • android.request.availableCapabilities中報告COLOR_SPACE_PROFILES功能。

有關支援 P3 廣色域捕獲的參考相機 HAL 實現,請參閱/hardware/google/camera/devices/EmulatedCamera/hwl/ configs/emu_camera_back.json中的以下內容:

有關相機 HAL 中廣色域捕獲的更多詳細信息,請參閱metadata_definitions.xml中的以下值:

蜜蜂

對於運行 Android 14 或更高版本且支援廣色域捕捉的設備,相機用戶端可以使用以下公共 API:

ColorSpace參數的預期值派生自ColorSpace.Named類別。在 Android 14 中,支援SRGBDISPLAY_P3BT2020_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)測試來驗證以下內容:

  • 存在具有正確色度座標的 ICC 配置文件
  • 影像包含 sRGB 色域之外的像素數據