From 7e2b88237a15562a197d7ec009098316ba48aa9b Mon Sep 17 00:00:00 2001 From: Shuzhen Wang Date: Thu, 15 Apr 2021 16:11:13 -0700 Subject: [PATCH] Camera: Update streamConfigurationMap doc for 1080p min JPEG size Camera devices meeting performance class requirement will not advertise JPEG sizes smaller than 1080p. Test: Build doc Bug: 184687664 Change-Id: If9a76cb7f80c01a43cd5ba9e91c1f543b81d4d54 --- .../camera2/CameraCharacteristics.java | 72 ++++++++++++++++++- 1 file changed, 71 insertions(+), 1 deletion(-) diff --git a/core/java/android/hardware/camera2/CameraCharacteristics.java b/core/java/android/hardware/camera2/CameraCharacteristics.java index 6654c2c710497..c7a7e71a701de 100644 --- a/core/java/android/hardware/camera2/CameraCharacteristics.java +++ b/core/java/android/hardware/camera2/CameraCharacteristics.java @@ -2513,7 +2513,7 @@ public final class CameraCharacteristics extends CameraMetadata *

The following table describes the minimum required output stream * configurations based on the hardware level - * ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}):

+ * ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}), prior to Android 12:

* * * @@ -2574,6 +2574,76 @@ public final class CameraCharacteristics extends CameraMetadata * *
+ *

Starting from Android 12, the camera device may not support JPEG sizes smaller than the + * minimum of 1080p and the camera sensor active array size. The requirements for + * IMPLEMENTATION_DEFINED and YUV_420_888 stay the same. This new minimum required output + * stream configurations are illustrated by the table below:

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
FormatSizeHardware LevelNotes
JPEG{@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}Any
JPEG1920x1080 (1080p)Anyif 1080p <= activeArraySize
YUV_420_888{@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}FULL
YUV_420_8881920x1080 (1080p)FULLif 1080p <= activeArraySize
YUV_420_8881280x720 (720)FULLif 720p <= activeArraySize
YUV_420_888640x480 (480p)FULLif 480p <= activeArraySize
YUV_420_888320x240 (240p)FULLif 240p <= activeArraySize
YUV_420_888all output sizes available for FULL hardware level, up to the maximum video sizeLIMITED
IMPLEMENTATION_DEFINEDsame as YUV_420_888Any
*

Refer to {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} for additional * mandatory stream configurations on a per-capability basis.

*

Exception on 176x144 (QCIF) resolution: camera devices usually have a fixed capability for