การจับภาพช่วงกว้าง

สำหรับอุปกรณ์ที่ใช้ 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 :

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

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการบันทึกช่วงสีกว้างใน Camera HAL โปรดดูค่าต่อไปนี้ใน metadata_definitions.xml :

• availableColorSpaceProfiles
• availableColorSpaceProfilesMap
• COLOR_SPACE_PROFILES

API

สำหรับอุปกรณ์ที่ใช้ Android 14 หรือสูงกว่าที่รองรับการจับภาพช่วงกว้าง ไคลเอนต์กล้องสามารถใช้ API สาธารณะต่อไปนี้:

• ColorSpaceProfiles
• setColorSpace

ค่าที่คาดหวังสำหรับพารามิเตอร์ ColorSpace ได้มาจากคลาส ColorSpace.Named ใน Android 14 รองรับ SRGB , DISPLAY_P3 และ BT2020_HLG

การตรวจสอบ

หากต้องการตรวจสอบการใช้งานการรองรับการบันทึกขอบเขตสีกว้างของ Display P3 ให้ทำการทดสอบต่อไปนี้

ซีทีเอส

• 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

ของมัน

รันการทดสอบ Camera Image Test Suite (ITS) เพื่อตรวจสอบสิ่งต่อไปนี้:

• การมีอยู่ของโปรไฟล์ ICC พร้อมพิกัดสีที่ถูกต้อง
• รูปภาพมีข้อมูลพิกเซลอยู่นอกช่วง sRGB