From a80b1542c83bc96ff9a6265578bc535d2d1e010f Mon Sep 17 00:00:00 2001 From: Shuzhen Wang Date: Mon, 21 Nov 2022 23:19:58 +0000 Subject: [PATCH] Camera: Fix up STREAM_CONFIGURATION_MAP doc The table within STREAM_CONFIGURATION_MAP wasn't formatted properly. Test: Read Java doc Bug: 259320974 Change-Id: I1c7932eae94b51b455933aea04881481292dba33 --- .../camera2/CameraCharacteristics.java | 358 +++++---- .../hardware/camera2/CaptureResult.java | 760 +++++++++--------- 2 files changed, 584 insertions(+), 534 deletions(-) diff --git a/core/java/android/hardware/camera2/CameraCharacteristics.java b/core/java/android/hardware/camera2/CameraCharacteristics.java index 98a8cbd8a73cc..753d52e440b51 100644 --- a/core/java/android/hardware/camera2/CameraCharacteristics.java +++ b/core/java/android/hardware/camera2/CameraCharacteristics.java @@ -2605,31 +2605,31 @@ public final class CameraCharacteristics extends CameraMetadata * * - * Input Format - * Output Format - * Capability + * Input Format + * Output Format + * Capability * * * * - * {@link android.graphics.ImageFormat#PRIVATE } - * {@link android.graphics.ImageFormat#JPEG } - * PRIVATE_REPROCESSING + * {@link android.graphics.ImageFormat#PRIVATE } + * {@link android.graphics.ImageFormat#JPEG } + * PRIVATE_REPROCESSING * * - * {@link android.graphics.ImageFormat#PRIVATE } - * {@link android.graphics.ImageFormat#YUV_420_888 } - * PRIVATE_REPROCESSING + * {@link android.graphics.ImageFormat#PRIVATE } + * {@link android.graphics.ImageFormat#YUV_420_888 } + * PRIVATE_REPROCESSING * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * {@link android.graphics.ImageFormat#JPEG } - * YUV_REPROCESSING + * {@link android.graphics.ImageFormat#YUV_420_888 } + * {@link android.graphics.ImageFormat#JPEG } + * YUV_REPROCESSING * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * {@link android.graphics.ImageFormat#YUV_420_888 } - * YUV_REPROCESSING + * {@link android.graphics.ImageFormat#YUV_420_888 } + * {@link android.graphics.ImageFormat#YUV_420_888 } + * YUV_REPROCESSING * * * @@ -2646,26 +2646,26 @@ public final class CameraCharacteristics extends CameraMetadata * * - * Input Format - * Output Format - * Capability + * Input Format + * Output Format + * Capability * * * * - * {@link android.graphics.ImageFormat#PRIVATE } - * {@link android.graphics.ImageFormat#Y8 } - * PRIVATE_REPROCESSING + * {@link android.graphics.ImageFormat#PRIVATE } + * {@link android.graphics.ImageFormat#Y8 } + * PRIVATE_REPROCESSING * * - * {@link android.graphics.ImageFormat#Y8 } - * {@link android.graphics.ImageFormat#JPEG } - * YUV_REPROCESSING + * {@link android.graphics.ImageFormat#Y8 } + * {@link android.graphics.ImageFormat#JPEG } + * YUV_REPROCESSING * * - * {@link android.graphics.ImageFormat#Y8 } - * {@link android.graphics.ImageFormat#Y8 } - * YUV_REPROCESSING + * {@link android.graphics.ImageFormat#Y8 } + * {@link android.graphics.ImageFormat#Y8 } + * YUV_REPROCESSING * * * @@ -2701,60 +2701,60 @@ public final class CameraCharacteristics extends CameraMetadata * * - * Format - * Size - * Hardware Level - * Notes + * Format + * Size + * Hardware Level + * Notes * * * * - * JPEG - * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} - * Any - * + * JPEG + * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} + * Any + * * * - * JPEG - * 1920x1080 (1080p) - * Any - * if 1080p <= activeArraySize + * JPEG + * 1920x1080 (1080p) + * Any + * if 1080p <= activeArraySize * * - * JPEG - * 1280x720 (720) - * Any - * if 720p <= activeArraySize + * JPEG + * 1280x720 (720) + * Any + * if 720p <= activeArraySize * * - * JPEG - * 640x480 (480p) - * Any - * if 480p <= activeArraySize + * JPEG + * 640x480 (480p) + * Any + * if 480p <= activeArraySize * * - * JPEG - * 320x240 (240p) - * Any - * if 240p <= activeArraySize + * JPEG + * 320x240 (240p) + * Any + * if 240p <= activeArraySize * * - * YUV_420_888 - * all output sizes available for JPEG - * FULL - * + * YUV_420_888 + * all output sizes available for JPEG + * FULL + * * * - * YUV_420_888 - * all output sizes available for JPEG, up to the maximum video size - * LIMITED - * + * YUV_420_888 + * all output sizes available for JPEG, up to the maximum video size + * LIMITED + * * * - * IMPLEMENTATION_DEFINED - * same as YUV_420_888 - * Any - * + * IMPLEMENTATION_DEFINED + * same as YUV_420_888 + * Any + * * * * @@ -2769,66 +2769,66 @@ public final class CameraCharacteristics extends CameraMetadata * * - * Format - * Size - * Hardware Level - * Notes + * Format + * Size + * Hardware Level + * Notes * * * * - * JPEG - * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} - * Any - * + * JPEG + * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} + * Any + * * * - * JPEG - * 1920x1080 (1080p) - * Any - * if 1080p <= activeArraySize + * JPEG + * 1920x1080 (1080p) + * Any + * if 1080p <= activeArraySize * * - * YUV_420_888 - * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} - * FULL - * + * YUV_420_888 + * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} + * FULL + * * * - * YUV_420_888 - * 1920x1080 (1080p) - * FULL - * if 1080p <= activeArraySize + * YUV_420_888 + * 1920x1080 (1080p) + * FULL + * if 1080p <= activeArraySize * * - * YUV_420_888 - * 1280x720 (720) - * FULL - * if 720p <= activeArraySize + * YUV_420_888 + * 1280x720 (720) + * FULL + * if 720p <= activeArraySize * * - * YUV_420_888 - * 640x480 (480p) - * FULL - * if 480p <= activeArraySize + * YUV_420_888 + * 640x480 (480p) + * FULL + * if 480p <= activeArraySize * * - * YUV_420_888 - * 320x240 (240p) - * FULL - * if 240p <= activeArraySize + * YUV_420_888 + * 320x240 (240p) + * FULL + * if 240p <= activeArraySize * * - * YUV_420_888 - * all output sizes available for FULL hardware level, up to the maximum video size - * LIMITED - * + * YUV_420_888 + * all output sizes available for FULL hardware level, up to the maximum video size + * LIMITED + * * * - * IMPLEMENTATION_DEFINED - * same as YUV_420_888 - * Any - * + * IMPLEMENTATION_DEFINED + * same as YUV_420_888 + * Any + * * * * @@ -2961,17 +2961,67 @@ public final class CameraCharacteristics extends CameraMetadata *

For applications targeting SDK version older than 31, the following table * describes the minimum required output stream configurations based on the - * hardware level ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}): - * Format | Size | Hardware Level | Notes - * :-------------------------------------------------:|:--------------------------------------------:|:--------------:|:--------------: - * {@link android.graphics.ImageFormat#JPEG } | {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} (*1) | Any | - * {@link android.graphics.ImageFormat#JPEG } | 1920x1080 (1080p) | Any | if 1080p <= activeArraySize - * {@link android.graphics.ImageFormat#JPEG } | 1280x720 (720p) | Any | if 720p <= activeArraySize - * {@link android.graphics.ImageFormat#JPEG } | 640x480 (480p) | Any | if 480p <= activeArraySize - * {@link android.graphics.ImageFormat#JPEG } | 320x240 (240p) | Any | if 240p <= activeArraySize - * {@link android.graphics.ImageFormat#YUV_420_888 } | all output sizes available for JPEG | FULL | - * {@link android.graphics.ImageFormat#YUV_420_888 } | all output sizes available for JPEG, up to the maximum video size | LIMITED | - * {@link android.graphics.ImageFormat#PRIVATE } | same as YUV_420_888 | Any |

+ * hardware level ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}):

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
FormatSizeHardware LevelNotes
{@link android.graphics.ImageFormat#JPEG }{@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} (*1)Any
{@link android.graphics.ImageFormat#JPEG }1920x1080 (1080p)Anyif 1080p <= activeArraySize
{@link android.graphics.ImageFormat#JPEG }1280x720 (720p)Anyif 720p <= activeArraySize
{@link android.graphics.ImageFormat#JPEG }640x480 (480p)Anyif 480p <= activeArraySize
{@link android.graphics.ImageFormat#JPEG }320x240 (240p)Anyif 240p <= activeArraySize
{@link android.graphics.ImageFormat#YUV_420_888 }all output sizes available for JPEGFULL
{@link android.graphics.ImageFormat#YUV_420_888 }all output sizes available for JPEG, up to the maximum video sizeLIMITED
{@link android.graphics.ImageFormat#PRIVATE }same as YUV_420_888Any
*

For applications targeting SDK version 31 or newer, if the mobile device declares to be * media performance class 12 or higher by setting * {@link android.os.Build.VERSION#MEDIA_PERFORMANCE_CLASS } to be 31 or larger, @@ -2983,66 +3033,66 @@ public final class CameraCharacteristics extends CameraMetadata * * - * Format - * Size - * Hardware Level - * Notes + * Format + * Size + * Hardware Level + * Notes * * * * - * {@link android.graphics.ImageFormat#JPEG } - * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} (*1) - * Any - * + * {@link android.graphics.ImageFormat#JPEG } + * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} (*1) + * Any + * * * - * {@link android.graphics.ImageFormat#JPEG } - * 1920x1080 (1080p) - * Any - * if 1080p <= activeArraySize + * {@link android.graphics.ImageFormat#JPEG } + * 1920x1080 (1080p) + * Any + * if 1080p <= activeArraySize * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} - * FULL - * + * {@link android.graphics.ImageFormat#YUV_420_888 } + * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} + * FULL + * * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * 1920x1080 (1080p) - * FULL - * if 1080p <= activeArraySize + * {@link android.graphics.ImageFormat#YUV_420_888 } + * 1920x1080 (1080p) + * FULL + * if 1080p <= activeArraySize * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * 1280x720 (720) - * FULL - * if 720p <= activeArraySize + * {@link android.graphics.ImageFormat#YUV_420_888 } + * 1280x720 (720) + * FULL + * if 720p <= activeArraySize * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * 640x480 (480p) - * FULL - * if 480p <= activeArraySize + * {@link android.graphics.ImageFormat#YUV_420_888 } + * 640x480 (480p) + * FULL + * if 480p <= activeArraySize * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * 320x240 (240p) - * FULL - * if 240p <= activeArraySize + * {@link android.graphics.ImageFormat#YUV_420_888 } + * 320x240 (240p) + * FULL + * if 240p <= activeArraySize * * - * {@link android.graphics.ImageFormat#YUV_420_888 } - * all output sizes available for FULL hardware level, up to the maximum video size - * LIMITED - * + * {@link android.graphics.ImageFormat#YUV_420_888 } + * all output sizes available for FULL hardware level, up to the maximum video size + * LIMITED + * * * - * {@link android.graphics.ImageFormat#PRIVATE } - * same as YUV_420_888 - * Any - * + * {@link android.graphics.ImageFormat#PRIVATE } + * same as YUV_420_888 + * Any + * * * * diff --git a/core/java/android/hardware/camera2/CaptureResult.java b/core/java/android/hardware/camera2/CaptureResult.java index 3e1deb27584e3..1a15596af5667 100644 --- a/core/java/android/hardware/camera2/CaptureResult.java +++ b/core/java/android/hardware/camera2/CaptureResult.java @@ -990,18 +990,18 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVEINACTIVECamera device auto exposure algorithm is disabledINACTIVEINACTIVECamera device auto exposure algorithm is disabled
@@ -1009,120 +1009,120 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVECamera device initiates AE scanSEARCHINGValues changingINACTIVECamera device initiates AE scanSEARCHINGValues changing
INACTIVE{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues lockedINACTIVE{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues locked
SEARCHINGCamera device finishes AE scanCONVERGEDGood values, not changingSEARCHINGCamera device finishes AE scanCONVERGEDGood values, not changing
SEARCHINGCamera device finishes AE scanFLASH_REQUIREDConverged but too dark w/o flashSEARCHINGCamera device finishes AE scanFLASH_REQUIREDConverged but too dark w/o flash
SEARCHING{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues lockedSEARCHING{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues locked
CONVERGEDCamera device initiates AE scanSEARCHINGValues changingCONVERGEDCamera device initiates AE scanSEARCHINGValues changing
CONVERGED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues lockedCONVERGED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues locked
FLASH_REQUIREDCamera device initiates AE scanSEARCHINGValues changingFLASH_REQUIREDCamera device initiates AE scanSEARCHINGValues changing
FLASH_REQUIRED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues lockedFLASH_REQUIRED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDValues locked
LOCKED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFSEARCHINGValues not good after unlockLOCKED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFSEARCHINGValues not good after unlock
LOCKED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFCONVERGEDValues good after unlockLOCKED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFCONVERGEDValues good after unlock
LOCKED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFFLASH_REQUIREDExposure good, but too darkLOCKED{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFFLASH_REQUIREDExposure good, but too dark
PRECAPTURESequence done. {@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFCONVERGEDReady for high-quality capturePRECAPTURESequence done. {@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is OFFCONVERGEDReady for high-quality capture
PRECAPTURESequence done. {@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDReady for high-quality capturePRECAPTURESequence done. {@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock} is ONLOCKEDReady for high-quality capture
LOCKEDaeLock is ON and aePrecaptureTrigger is STARTLOCKEDPrecapture trigger is ignored when AE is already lockedLOCKEDaeLock is ON and aePrecaptureTrigger is STARTLOCKEDPrecapture trigger is ignored when AE is already locked
LOCKEDaeLock is ON and aePrecaptureTrigger is CANCELLOCKEDPrecapture trigger is ignored when AE is already lockedLOCKEDaeLock is ON and aePrecaptureTrigger is CANCELLOCKEDPrecapture trigger is ignored when AE is already locked
Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is STARTPRECAPTUREStart AE precapture metering sequenceAny state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is STARTPRECAPTUREStart AE precapture metering sequence
Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is CANCELINACTIVECurrently active precapture metering sequence is canceledAny state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is CANCELINACTIVECurrently active precapture metering sequence is canceled
@@ -1138,54 +1138,54 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVECamera device finished AE scanCONVERGEDValues are already good, transient states are skipped by camera device.INACTIVECamera device finished AE scanCONVERGEDValues are already good, transient states are skipped by camera device.
Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is START, sequence doneFLASH_REQUIREDConverged but too dark w/o flash after a precapture sequence, transient states are skipped by camera device.Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is START, sequence doneFLASH_REQUIREDConverged but too dark w/o flash after a precapture sequence, transient states are skipped by camera device.
Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is START, sequence doneCONVERGEDConverged after a precapture sequence, transient states are skipped by camera device.Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is START, sequence doneCONVERGEDConverged after a precapture sequence, transient states are skipped by camera device.
Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is CANCEL, convergedFLASH_REQUIREDConverged but too dark w/o flash after a precapture sequence is canceled, transient states are skipped by camera device.Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is CANCEL, convergedFLASH_REQUIREDConverged but too dark w/o flash after a precapture sequence is canceled, transient states are skipped by camera device.
Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is CANCEL, convergedCONVERGEDConverged after a precapture sequences canceled, transient states are skipped by camera device.Any state (excluding LOCKED){@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is CANCEL, convergedCONVERGEDConverged after a precapture sequences canceled, transient states are skipped by camera device.
CONVERGEDCamera device finished AE scanFLASH_REQUIREDConverged but too dark w/o flash after a new scan, transient states are skipped by camera device.CONVERGEDCamera device finished AE scanFLASH_REQUIREDConverged but too dark w/o flash after a new scan, transient states are skipped by camera device.
FLASH_REQUIREDCamera device finished AE scanCONVERGEDConverged after a new scan, transient states are skipped by camera device.FLASH_REQUIREDCamera device finished AE scanCONVERGEDConverged after a new scan, transient states are skipped by camera device.
@@ -1413,18 +1413,18 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVEINACTIVENever changesINACTIVEINACTIVENever changes
@@ -1432,66 +1432,66 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVEAF_TRIGGERACTIVE_SCANStart AF sweep, Lens now movingINACTIVEAF_TRIGGERACTIVE_SCANStart AF sweep, Lens now moving
ACTIVE_SCANAF sweep doneFOCUSED_LOCKEDFocused, Lens now lockedACTIVE_SCANAF sweep doneFOCUSED_LOCKEDFocused, Lens now locked
ACTIVE_SCANAF sweep doneNOT_FOCUSED_LOCKEDNot focused, Lens now lockedACTIVE_SCANAF sweep doneNOT_FOCUSED_LOCKEDNot focused, Lens now locked
ACTIVE_SCANAF_CANCELINACTIVECancel/reset AF, Lens now lockedACTIVE_SCANAF_CANCELINACTIVECancel/reset AF, Lens now locked
FOCUSED_LOCKEDAF_CANCELINACTIVECancel/reset AFFOCUSED_LOCKEDAF_CANCELINACTIVECancel/reset AF
FOCUSED_LOCKEDAF_TRIGGERACTIVE_SCANStart new sweep, Lens now movingFOCUSED_LOCKEDAF_TRIGGERACTIVE_SCANStart new sweep, Lens now moving
NOT_FOCUSED_LOCKEDAF_CANCELINACTIVECancel/reset AFNOT_FOCUSED_LOCKEDAF_CANCELINACTIVECancel/reset AF
NOT_FOCUSED_LOCKEDAF_TRIGGERACTIVE_SCANStart new sweep, Lens now movingNOT_FOCUSED_LOCKEDAF_TRIGGERACTIVE_SCANStart new sweep, Lens now moving
Any stateMode changeINACTIVEAny stateMode changeINACTIVE
@@ -1504,36 +1504,36 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVEAF_TRIGGERFOCUSED_LOCKEDFocus is already good or good after a scan, lens is now locked.INACTIVEAF_TRIGGERFOCUSED_LOCKEDFocus is already good or good after a scan, lens is now locked.
INACTIVEAF_TRIGGERNOT_FOCUSED_LOCKEDFocus failed after a scan, lens is now locked.INACTIVEAF_TRIGGERNOT_FOCUSED_LOCKEDFocus failed after a scan, lens is now locked.
FOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDFocus is already good or good after a scan, lens is now locked.FOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDFocus is already good or good after a scan, lens is now locked.
NOT_FOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDFocus is good after a scan, lens is not locked.NOT_FOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDFocus is good after a scan, lens is not locked.
@@ -1541,102 +1541,102 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVECamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now movingINACTIVECamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now moving
INACTIVEAF_TRIGGERNOT_FOCUSED_LOCKEDAF state query, Lens now lockedINACTIVEAF_TRIGGERNOT_FOCUSED_LOCKEDAF state query, Lens now locked
PASSIVE_SCANCamera device completes current scanPASSIVE_FOCUSEDEnd AF scan, Lens now lockedPASSIVE_SCANCamera device completes current scanPASSIVE_FOCUSEDEnd AF scan, Lens now locked
PASSIVE_SCANCamera device fails current scanPASSIVE_UNFOCUSEDEnd AF scan, Lens now lockedPASSIVE_SCANCamera device fails current scanPASSIVE_UNFOCUSEDEnd AF scan, Lens now locked
PASSIVE_SCANAF_TRIGGERFOCUSED_LOCKEDImmediate transition, if focus is good. Lens now lockedPASSIVE_SCANAF_TRIGGERFOCUSED_LOCKEDImmediate transition, if focus is good. Lens now locked
PASSIVE_SCANAF_TRIGGERNOT_FOCUSED_LOCKEDImmediate transition, if focus is bad. Lens now lockedPASSIVE_SCANAF_TRIGGERNOT_FOCUSED_LOCKEDImmediate transition, if focus is bad. Lens now locked
PASSIVE_SCANAF_CANCELINACTIVEReset lens position, Lens now lockedPASSIVE_SCANAF_CANCELINACTIVEReset lens position, Lens now locked
PASSIVE_FOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now movingPASSIVE_FOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now moving
PASSIVE_UNFOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now movingPASSIVE_UNFOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now moving
PASSIVE_FOCUSEDAF_TRIGGERFOCUSED_LOCKEDImmediate transition, lens now lockedPASSIVE_FOCUSEDAF_TRIGGERFOCUSED_LOCKEDImmediate transition, lens now locked
PASSIVE_UNFOCUSEDAF_TRIGGERNOT_FOCUSED_LOCKEDImmediate transition, lens now lockedPASSIVE_UNFOCUSEDAF_TRIGGERNOT_FOCUSED_LOCKEDImmediate transition, lens now locked
FOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDNo effectFOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDNo effect
FOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scanFOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scan
NOT_FOCUSED_LOCKEDAF_TRIGGERNOT_FOCUSED_LOCKEDNo effectNOT_FOCUSED_LOCKEDAF_TRIGGERNOT_FOCUSED_LOCKEDNo effect
NOT_FOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scanNOT_FOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scan
@@ -1644,102 +1644,102 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVECamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now movingINACTIVECamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now moving
INACTIVEAF_TRIGGERNOT_FOCUSED_LOCKEDAF state query, Lens now lockedINACTIVEAF_TRIGGERNOT_FOCUSED_LOCKEDAF state query, Lens now locked
PASSIVE_SCANCamera device completes current scanPASSIVE_FOCUSEDEnd AF scan, Lens now lockedPASSIVE_SCANCamera device completes current scanPASSIVE_FOCUSEDEnd AF scan, Lens now locked
PASSIVE_SCANCamera device fails current scanPASSIVE_UNFOCUSEDEnd AF scan, Lens now lockedPASSIVE_SCANCamera device fails current scanPASSIVE_UNFOCUSEDEnd AF scan, Lens now locked
PASSIVE_SCANAF_TRIGGERFOCUSED_LOCKEDEventual transition once the focus is good. Lens now lockedPASSIVE_SCANAF_TRIGGERFOCUSED_LOCKEDEventual transition once the focus is good. Lens now locked
PASSIVE_SCANAF_TRIGGERNOT_FOCUSED_LOCKEDEventual transition if cannot find focus. Lens now lockedPASSIVE_SCANAF_TRIGGERNOT_FOCUSED_LOCKEDEventual transition if cannot find focus. Lens now locked
PASSIVE_SCANAF_CANCELINACTIVEReset lens position, Lens now lockedPASSIVE_SCANAF_CANCELINACTIVEReset lens position, Lens now locked
PASSIVE_FOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now movingPASSIVE_FOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now moving
PASSIVE_UNFOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now movingPASSIVE_UNFOCUSEDCamera device initiates new scanPASSIVE_SCANStart AF scan, Lens now moving
PASSIVE_FOCUSEDAF_TRIGGERFOCUSED_LOCKEDImmediate trans. Lens now lockedPASSIVE_FOCUSEDAF_TRIGGERFOCUSED_LOCKEDImmediate trans. Lens now locked
PASSIVE_UNFOCUSEDAF_TRIGGERNOT_FOCUSED_LOCKEDImmediate trans. Lens now lockedPASSIVE_UNFOCUSEDAF_TRIGGERNOT_FOCUSED_LOCKEDImmediate trans. Lens now locked
FOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDNo effectFOCUSED_LOCKEDAF_TRIGGERFOCUSED_LOCKEDNo effect
FOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scanFOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scan
NOT_FOCUSED_LOCKEDAF_TRIGGERNOT_FOCUSED_LOCKEDNo effectNOT_FOCUSED_LOCKEDAF_TRIGGERNOT_FOCUSED_LOCKEDNo effect
NOT_FOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scanNOT_FOCUSED_LOCKEDAF_CANCELINACTIVERestart AF scan
@@ -1751,30 +1751,30 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
any stateCAF-->AUTO mode switchINACTIVEMode switch without trigger, initial state must be INACTIVEany stateCAF-->AUTO mode switchINACTIVEMode switch without trigger, initial state must be INACTIVE
any stateCAF-->AUTO mode switch with AF_TRIGGERtrigger-reachable states from INACTIVEMode switch with trigger, INACTIVE is skippedany stateCAF-->AUTO mode switch with AF_TRIGGERtrigger-reachable states from INACTIVEMode switch with trigger, INACTIVE is skipped
any stateAUTO-->CAF mode switchpassively reachable states from INACTIVEMode switch without trigger, passive transient state is skippedany stateAUTO-->CAF mode switchpassively reachable states from INACTIVEMode switch without trigger, passive transient state is skipped
@@ -2053,18 +2053,18 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVEINACTIVECamera device auto white balance algorithm is disabledINACTIVEINACTIVECamera device auto white balance algorithm is disabled
@@ -2072,54 +2072,54 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVECamera device initiates AWB scanSEARCHINGValues changingINACTIVECamera device initiates AWB scanSEARCHINGValues changing
INACTIVE{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is ONLOCKEDValues lockedINACTIVE{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is ONLOCKEDValues locked
SEARCHINGCamera device finishes AWB scanCONVERGEDGood values, not changingSEARCHINGCamera device finishes AWB scanCONVERGEDGood values, not changing
SEARCHING{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is ONLOCKEDValues lockedSEARCHING{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is ONLOCKEDValues locked
CONVERGEDCamera device initiates AWB scanSEARCHINGValues changingCONVERGEDCamera device initiates AWB scanSEARCHINGValues changing
CONVERGED{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is ONLOCKEDValues lockedCONVERGED{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is ONLOCKEDValues locked
LOCKED{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is OFFSEARCHINGValues not good after unlockLOCKED{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is OFFSEARCHINGValues not good after unlock
@@ -2132,24 +2132,24 @@ public class CaptureResult extends CameraMetadata> { * * * - * - * - * - * + * + * + * + * * * * * - * - * - * - * + * + * + * + * * * - * - * - * - * + * + * + * + * * * *
StateTransition CauseNew StateNotesStateTransition CauseNew StateNotes
INACTIVECamera device finished AWB scanCONVERGEDValues are already good, transient states are skipped by camera device.INACTIVECamera device finished AWB scanCONVERGEDValues are already good, transient states are skipped by camera device.
LOCKED{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is OFFCONVERGEDValues good after unlock, transient states are skipped by camera device.LOCKED{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock} is OFFCONVERGEDValues good after unlock, transient states are skipped by camera device.