diff --git a/core/java/android/hardware/camera2/CameraCharacteristics.java b/core/java/android/hardware/camera2/CameraCharacteristics.java index a0c12235dea97..0f595b7000132 100644 --- a/core/java/android/hardware/camera2/CameraCharacteristics.java +++ b/core/java/android/hardware/camera2/CameraCharacteristics.java @@ -1467,12 +1467,13 @@ public final class CameraCharacteristics extends CameraMetadata0.0f still represents farthest * focus, and {@link CameraCharacteristics#LENS_INFO_MINIMUM_FOCUS_DISTANCE android.lens.info.minimumFocusDistance} represents the * nearest focus the device can achieve.

- *

Possible values: + *

Possible values:

*

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -1495,12 +1496,13 @@ public final class CameraCharacteristics extends CameraMetadataDirection the camera faces relative to * device screen.

- *

Possible values: + *

Possible values:

*

+ * + * *

This key is available on all devices.

* @see #LENS_FACING_FRONT * @see #LENS_FACING_BACK @@ -1726,12 +1728,13 @@ public final class CameraCharacteristics extends CameraMetadata *

Different calibration methods and use cases can produce better or worse results * depending on the selected coordinate origin.

- *

Possible values: + *

Possible values:

*

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Permission {@link android.Manifest.permission#CAMERA } is needed to access this property

* @@ -2057,7 +2060,7 @@ public final class CameraCharacteristics extends CameraMetadata *

Other capabilities may be available on either FULL or LIMITED * devices, but the application should query this key to be sure.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE BACKWARD_COMPATIBLE}
    • *
  • {@link #REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR MANUAL_SENSOR}
    • @@ -2075,7 +2078,8 @@ public final class CameraCharacteristics extends CameraMetadata{@link #REQUEST_AVAILABLE_CAPABILITIES_SECURE_IMAGE_DATA SECURE_IMAGE_DATA} *
  • {@link #REQUEST_AVAILABLE_CAPABILITIES_SYSTEM_CAMERA SYSTEM_CAMERA}
    • *
  • {@link #REQUEST_AVAILABLE_CAPABILITIES_OFFLINE_PROCESSING OFFLINE_PROCESSING}
    • - *

+ * + * *

This key is available on all devices.

* * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL @@ -2777,11 +2781,12 @@ public final class CameraCharacteristics extends CameraMetadata * *

LEGACY capability devices will only support CENTER_ONLY cropping.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #SCALER_CROPPING_TYPE_CENTER_ONLY CENTER_ONLY}
    • *
  • {@link #SCALER_CROPPING_TYPE_FREEFORM FREEFORM}
    • - *

+ * + * *

This key is available on all devices.

* * @see CaptureRequest#CONTROL_ZOOM_RATIO @@ -2966,7 +2971,7 @@ public final class CameraCharacteristics extends CameraMetadata - *

Possible values: + *

Possible values:

*
    *
  • {@link #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGGB RGGB}
    • *
  • {@link #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GRBG GRBG}
    • @@ -2975,7 +2980,8 @@ public final class CameraCharacteristics extends CameraMetadata{@link #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGB RGB} *
  • {@link #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_MONO MONO}
    • *
  • {@link #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_NIR NIR}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Full capability - * Present on all camera devices that report being {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_FULL HARDWARE_LEVEL_FULL} devices in the @@ -3117,11 +3123,12 @@ public final class CameraCharacteristics extends CameraMetadata *

This characteristic defines the source for the timestamps, and therefore whether they * can be compared against other system time sources/timestamps.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #SENSOR_INFO_TIMESTAMP_SOURCE_UNKNOWN UNKNOWN}
    • *
  • {@link #SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME REALTIME}
    • - *

+ * + * *

This key is available on all devices.

* @see #SENSOR_INFO_TIMESTAMP_SOURCE_UNKNOWN * @see #SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME @@ -3231,7 +3238,7 @@ public final class CameraCharacteristics extends CameraMetadata *

Starting from Android Q, this key will not be present for a MONOCHROME camera, even if * the camera device has RAW capability.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT DAYLIGHT}
    • *
  • {@link #SENSOR_REFERENCE_ILLUMINANT1_FLUORESCENT FLUORESCENT}
    • @@ -3252,7 +3259,8 @@ public final class CameraCharacteristics extends CameraMetadata{@link #SENSOR_REFERENCE_ILLUMINANT1_D75 D75} *
  • {@link #SENSOR_REFERENCE_ILLUMINANT1_D50 D50}
    • *
  • {@link #SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN ISO_STUDIO_TUNGSTEN}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Permission {@link android.Manifest.permission#CAMERA } is needed to access this property

* @@ -3727,10 +3735,11 @@ public final class CameraCharacteristics extends CameraMetadataA list of camera LEDs that are available on this system.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #LED_AVAILABLE_LEDS_TRANSMIT TRANSMIT}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

* @see #LED_AVAILABLE_LEDS_TRANSMIT * @hide @@ -3799,14 +3808,15 @@ public final class CameraCharacteristics extends CameraMetadata * - *

Possible values: + *

Possible values:

*
    *
  • {@link #INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED}
    • *
  • {@link #INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL}
    • *
  • {@link #INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY LEGACY}
    • *
  • {@link #INFO_SUPPORTED_HARDWARE_LEVEL_3 3}
    • *
  • {@link #INFO_SUPPORTED_HARDWARE_LEVEL_EXTERNAL EXTERNAL}
    • - *

+ * + * *

This key is available on all devices.

* * @see CameraCharacteristics#CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES @@ -3850,11 +3860,12 @@ public final class CameraCharacteristics extends CameraMetadata *

Units: Frame counts

- *

Possible values: + *

Possible values:

*
    *
  • {@link #SYNC_MAX_LATENCY_PER_FRAME_CONTROL PER_FRAME_CONTROL}
    • *
  • {@link #SYNC_MAX_LATENCY_UNKNOWN UNKNOWN}
    • - *

+ * + * *

Available values for this device:
* A positive value, PER_FRAME_CONTROL, or UNKNOWN.

*

This key is available on all devices.

@@ -4102,11 +4113,12 @@ public final class CameraCharacteristics extends CameraMetadata *

This tag is only applicable if the logical camera device supports concurrent physical * streams from different physical cameras.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_APPROXIMATE APPROXIMATE}
    • *
  • {@link #LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_CALIBRATED CALIBRATED}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the diff --git a/core/java/android/hardware/camera2/CaptureRequest.java b/core/java/android/hardware/camera2/CaptureRequest.java index d85bcbd15e509..d7aee10a5b938 100644 --- a/core/java/android/hardware/camera2/CaptureRequest.java +++ b/core/java/android/hardware/camera2/CaptureRequest.java @@ -1028,12 +1028,13 @@ public final class CaptureRequest extends CameraMetadata> * *

Both the input and output value ranges must match. Overflow/underflow * values are clipped to fit within the range.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #COLOR_CORRECTION_MODE_TRANSFORM_MATRIX TRANSFORM_MATRIX}
    • *
  • {@link #COLOR_CORRECTION_MODE_FAST FAST}
    • *
  • {@link #COLOR_CORRECTION_MODE_HIGH_QUALITY HIGH_QUALITY}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Full capability - * Present on all camera devices that report being {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_FULL HARDWARE_LEVEL_FULL} devices in the @@ -1121,12 +1122,13 @@ public final class CaptureRequest extends CameraMetadata> * capture rate. FAST means the camera device will not slow down capture rate when * applying aberration correction.

*

LEGACY devices will always be in FAST mode.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #COLOR_CORRECTION_ABERRATION_MODE_OFF OFF}
    • *
  • {@link #COLOR_CORRECTION_ABERRATION_MODE_FAST FAST}
    • *
  • {@link #COLOR_CORRECTION_ABERRATION_MODE_HIGH_QUALITY HIGH_QUALITY}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES android.colorCorrection.availableAberrationModes}

*

This key is available on all devices.

@@ -1173,13 +1175,14 @@ public final class CaptureRequest extends CameraMetadata> * ensure it selects exposure times that do not cause banding * issues. The {@link CaptureResult#STATISTICS_SCENE_FLICKER android.statistics.sceneFlicker} key can assist * the application in this.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_AE_ANTIBANDING_MODE_OFF OFF}
    • *
  • {@link #CONTROL_AE_ANTIBANDING_MODE_50HZ 50HZ}
    • *
  • {@link #CONTROL_AE_ANTIBANDING_MODE_60HZ 60HZ}
    • *
  • {@link #CONTROL_AE_ANTIBANDING_MODE_AUTO AUTO}
    • - *

+ * + * *

Available values for this device:

*

{@link CameraCharacteristics#CONTROL_AE_AVAILABLE_ANTIBANDING_MODES android.control.aeAvailableAntibandingModes}

*

This key is available on all devices.

@@ -1304,7 +1307,7 @@ public final class CaptureRequest extends CameraMetadata> * camera device auto-exposure routine for the overridden * fields for a given capture will be available in its * CaptureResult.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_AE_MODE_OFF OFF}
    • *
  • {@link #CONTROL_AE_MODE_ON ON}
    • @@ -1312,7 +1315,8 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link #CONTROL_AE_MODE_ON_ALWAYS_FLASH ON_ALWAYS_FLASH}
    • *
  • {@link #CONTROL_AE_MODE_ON_AUTO_FLASH_REDEYE ON_AUTO_FLASH_REDEYE}
    • *
  • {@link #CONTROL_AE_MODE_ON_EXTERNAL_FLASH ON_EXTERNAL_FLASH}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#CONTROL_AE_AVAILABLE_MODES android.control.aeAvailableModes}

*

This key is available on all devices.

@@ -1478,12 +1482,13 @@ public final class CaptureRequest extends CameraMetadata> * example.

*

If both the precapture and the auto-focus trigger are activated on the same request, then * the camera device will complete them in the optimal order for that device.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_AE_PRECAPTURE_TRIGGER_IDLE IDLE}
    • *
  • {@link #CONTROL_AE_PRECAPTURE_TRIGGER_START START}
    • *
  • {@link #CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL CANCEL}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

*

Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -1514,7 +1519,7 @@ public final class CaptureRequest extends CameraMetadata> *

If the lens is controlled by the camera device auto-focus algorithm, * the camera device will report the current AF status in {@link CaptureResult#CONTROL_AF_STATE android.control.afState} * in result metadata.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_AF_MODE_OFF OFF}
    • *
  • {@link #CONTROL_AF_MODE_AUTO AUTO}
    • @@ -1522,7 +1527,8 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link #CONTROL_AF_MODE_CONTINUOUS_VIDEO CONTINUOUS_VIDEO}
    • *
  • {@link #CONTROL_AF_MODE_CONTINUOUS_PICTURE CONTINUOUS_PICTURE}
    • *
  • {@link #CONTROL_AF_MODE_EDOF EDOF}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#CONTROL_AF_AVAILABLE_MODES android.control.afAvailableModes}

*

This key is available on all devices.

@@ -1637,12 +1643,13 @@ public final class CaptureRequest extends CameraMetadata> * focus sweep), the camera device may delay acting on a later trigger until the previous * trigger has been fully handled. This may lead to longer intervals between the trigger and * changes to {@link CaptureResult#CONTROL_AF_STATE android.control.afState}, for example.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_AF_TRIGGER_IDLE IDLE}
    • *
  • {@link #CONTROL_AF_TRIGGER_START START}
    • *
  • {@link #CONTROL_AF_TRIGGER_CANCEL CANCEL}
    • - *

+ * + * *

This key is available on all devices.

* * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER @@ -1710,7 +1717,7 @@ public final class CaptureRequest extends CameraMetadata> * {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform}, * {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} and * {@link CaptureRequest#COLOR_CORRECTION_MODE android.colorCorrection.mode} are ignored.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_AWB_MODE_OFF OFF}
    • *
  • {@link #CONTROL_AWB_MODE_AUTO AUTO}
    • @@ -1721,7 +1728,8 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link #CONTROL_AWB_MODE_CLOUDY_DAYLIGHT CLOUDY_DAYLIGHT}
    • *
  • {@link #CONTROL_AWB_MODE_TWILIGHT TWILIGHT}
    • *
  • {@link #CONTROL_AWB_MODE_SHADE SHADE}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#CONTROL_AWB_AVAILABLE_MODES android.control.awbAvailableModes}

*

This key is available on all devices.

@@ -1835,7 +1843,7 @@ public final class CaptureRequest extends CameraMetadata> * MANUAL_SENSOR. * * MOTION_TRACKING will be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains * MOTION_TRACKING.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_CAPTURE_INTENT_CUSTOM CUSTOM}
    • *
  • {@link #CONTROL_CAPTURE_INTENT_PREVIEW PREVIEW}
    • @@ -1845,7 +1853,8 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link #CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}
    • *
  • {@link #CONTROL_CAPTURE_INTENT_MANUAL MANUAL}
    • *
  • {@link #CONTROL_CAPTURE_INTENT_MOTION_TRACKING MOTION_TRACKING}
    • - *

+ * + * *

This key is available on all devices.

* * @see CaptureRequest#CONTROL_MODE @@ -1872,7 +1881,7 @@ public final class CaptureRequest extends CameraMetadata> * implementor of the camera device, and should not be * depended on to be consistent (or present) across all * devices.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_EFFECT_MODE_OFF OFF}
    • *
  • {@link #CONTROL_EFFECT_MODE_MONO MONO}
    • @@ -1883,7 +1892,8 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link #CONTROL_EFFECT_MODE_WHITEBOARD WHITEBOARD}
    • *
  • {@link #CONTROL_EFFECT_MODE_BLACKBOARD BLACKBOARD}
    • *
  • {@link #CONTROL_EFFECT_MODE_AQUA AQUA}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#CONTROL_AVAILABLE_EFFECTS android.control.availableEffects}

*

This key is available on all devices.

@@ -1922,14 +1932,15 @@ public final class CaptureRequest extends CameraMetadata> * update, as if this frame is never captured. This mode can be used in the scenario * where the application doesn't want a 3A manual control capture to affect * the subsequent auto 3A capture results.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_MODE_OFF OFF}
    • *
  • {@link #CONTROL_MODE_AUTO AUTO}
    • *
  • {@link #CONTROL_MODE_USE_SCENE_MODE USE_SCENE_MODE}
    • *
  • {@link #CONTROL_MODE_OFF_KEEP_STATE OFF_KEEP_STATE}
    • *
  • {@link #CONTROL_MODE_USE_EXTENDED_SCENE_MODE USE_EXTENDED_SCENE_MODE}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#CONTROL_AVAILABLE_MODES android.control.availableModes}

*

This key is available on all devices.

@@ -1959,7 +1970,7 @@ public final class CaptureRequest extends CameraMetadata> * to the implementor of the camera device. Their behavior will not be * consistent across all devices, and any given device may only implement * a subset of these modes.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_SCENE_MODE_DISABLED DISABLED}
    • *
  • {@link #CONTROL_SCENE_MODE_FACE_PRIORITY FACE_PRIORITY}
    • @@ -1980,7 +1991,8 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link #CONTROL_SCENE_MODE_BARCODE BARCODE}
    • *
  • {@link #CONTROL_SCENE_MODE_HIGH_SPEED_VIDEO HIGH_SPEED_VIDEO}
    • *
  • {@link #CONTROL_SCENE_MODE_HDR HDR}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#CONTROL_AVAILABLE_SCENE_MODES android.control.availableSceneModes}

*

This key is available on all devices.

@@ -2041,11 +2053,12 @@ public final class CaptureRequest extends CameraMetadata> * ({@link CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE android.lens.opticalStabilizationMode}), turning both modes on may * produce undesirable interaction, so it is recommended not to enable * both at the same time.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_VIDEO_STABILIZATION_MODE_OFF OFF}
    • *
  • {@link #CONTROL_VIDEO_STABILIZATION_MODE_ON ON}
    • - *

+ * + * *

This key is available on all devices.

* * @see CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE @@ -2155,12 +2168,13 @@ public final class CaptureRequest extends CameraMetadata> * with different field of view. As a result, when bokeh mode is enabled, the camera device * may override {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion} or {@link CaptureRequest#CONTROL_ZOOM_RATIO android.control.zoomRatio}, and the field of * view may be smaller than when bokeh mode is off.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #CONTROL_EXTENDED_SCENE_MODE_DISABLED DISABLED}
    • *
  • {@link #CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE BOKEH_STILL_CAPTURE}
    • *
  • {@link #CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS BOKEH_CONTINUOUS}
    • - *

+ * + * *

Optional - The value for this key may be {@code null} on some devices.

* * @see CaptureRequest#CONTROL_ZOOM_RATIO @@ -2287,13 +2301,14 @@ public final class CaptureRequest extends CameraMetadata> * device will apply FAST/HIGH_QUALITY YUV-domain edge enhancement, respectively. * The camera device may adjust its internal edge enhancement parameters for best * image quality based on the {@link CaptureRequest#REPROCESS_EFFECTIVE_EXPOSURE_FACTOR android.reprocess.effectiveExposureFactor}, if it is set.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #EDGE_MODE_OFF OFF}
    • *
  • {@link #EDGE_MODE_FAST FAST}
    • *
  • {@link #EDGE_MODE_HIGH_QUALITY HIGH_QUALITY}
    • *
  • {@link #EDGE_MODE_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#EDGE_AVAILABLE_EDGE_MODES android.edge.availableEdgeModes}

*

Optional - The value for this key may be {@code null} on some devices.

@@ -2329,12 +2344,13 @@ public final class CaptureRequest extends CameraMetadata> *

When set to TORCH, the flash will be on continuously. This mode can be used * for use cases such as preview, auto-focus assist, still capture, or video recording.

*

The flash status will be reported by {@link CaptureResult#FLASH_STATE android.flash.state} in the capture result metadata.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #FLASH_MODE_OFF OFF}
    • *
  • {@link #FLASH_MODE_SINGLE SINGLE}
    • *
  • {@link #FLASH_MODE_TORCH TORCH}
    • - *

+ * + * *

This key is available on all devices.

* * @see CaptureRequest#CONTROL_AE_MODE @@ -2355,12 +2371,13 @@ public final class CaptureRequest extends CameraMetadata> *

Hotpixel correction interpolates out, or otherwise removes, pixels * that do not accurately measure the incoming light (i.e. pixels that * are stuck at an arbitrary value or are oversensitive).

- *

Possible values: + *

Possible values:

*
    *
  • {@link #HOT_PIXEL_MODE_OFF OFF}
    • *
  • {@link #HOT_PIXEL_MODE_FAST FAST}
    • *
  • {@link #HOT_PIXEL_MODE_HIGH_QUALITY HIGH_QUALITY}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#HOT_PIXEL_AVAILABLE_HOT_PIXEL_MODES android.hotPixel.availableHotPixelModes}

*

Optional - The value for this key may be {@code null} on some devices.

@@ -2688,11 +2705,12 @@ public final class CaptureRequest extends CameraMetadata> *

Not all devices will support OIS; see * {@link CameraCharacteristics#LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION android.lens.info.availableOpticalStabilization} for * available controls.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #LENS_OPTICAL_STABILIZATION_MODE_OFF OFF}
    • *
  • {@link #LENS_OPTICAL_STABILIZATION_MODE_ON ON}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION android.lens.info.availableOpticalStabilization}

*

Optional - The value for this key may be {@code null} on some devices.

@@ -2738,14 +2756,15 @@ public final class CaptureRequest extends CameraMetadata> * will apply FAST/HIGH_QUALITY YUV domain noise reduction, respectively. The camera device * may adjust the noise reduction parameters for best image quality based on the * {@link CaptureRequest#REPROCESS_EFFECTIVE_EXPOSURE_FACTOR android.reprocess.effectiveExposureFactor} if it is set.

- *

Possible values: + *

Possible values:

*
    *
  • {@link #NOISE_REDUCTION_MODE_OFF OFF}
    • *
  • {@link #NOISE_REDUCTION_MODE_FAST FAST}
    • *
  • {@link #NOISE_REDUCTION_MODE_HIGH_QUALITY HIGH_QUALITY}
    • *
  • {@link #NOISE_REDUCTION_MODE_MINIMAL MINIMAL}
    • *
  • {@link #NOISE_REDUCTION_MODE_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}
    • - *

+ * + * *

Available values for this device:
* {@link CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES android.noiseReduction.availableNoiseReductionModes}

*

Optional - The value for this key may be {@code null} on some devices.

@@ -2959,14 +2978,15 @@ public final class CaptureRequest extends CameraMetadata> *
  • 640x480 stream: top-left: (781, 375) on active array, size: (640, 480), downscaled 1.17x from sensor pixels
    • *
  • 1280x720 stream: top-left: (711, 375) on active array, size: (1280, 720), upscaled 1.71x from sensor pixels
    • * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SCALER_ROTATE_AND_CROP_NONE NONE}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_90 90}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_180 180}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_270 270}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_AUTO AUTO}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES android.scaler.availableRotateAndCropModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3166,7 +3186,7 @@ public final class CaptureRequest extends CameraMetadata> * occur (and that the test pattern remain unmodified, since the flash * would not actually affect it).

    *

    Defaults to OFF.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SENSOR_TEST_PATTERN_MODE_OFF OFF}
      • *
    • {@link #SENSOR_TEST_PATTERN_MODE_SOLID_COLOR SOLID_COLOR}
      • @@ -3174,7 +3194,8 @@ public final class CaptureRequest extends CameraMetadata> *
    • {@link #SENSOR_TEST_PATTERN_MODE_COLOR_BARS_FADE_TO_GRAY COLOR_BARS_FADE_TO_GRAY}
      • *
    • {@link #SENSOR_TEST_PATTERN_MODE_PN9 PN9}
      • *
    • {@link #SENSOR_TEST_PATTERN_MODE_CUSTOM1 CUSTOM1}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#SENSOR_AVAILABLE_TEST_PATTERN_MODES android.sensor.availableTestPatternModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3218,12 +3239,13 @@ public final class CaptureRequest extends CameraMetadata> * AWB are in AUTO modes({@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} != OFF and {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode} != * OFF), to get best results, it is recommended that the applications wait for the AE and AWB * to be converged before using the returned shading map data.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SHADING_MODE_OFF OFF}
      • *
    • {@link #SHADING_MODE_FAST FAST}
      • *
    • {@link #SHADING_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#SHADING_AVAILABLE_MODES android.shading.availableModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3252,12 +3274,13 @@ public final class CaptureRequest extends CameraMetadata> *

    Whether face detection is enabled, and whether it * should output just the basic fields or the full set of * fields.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_FACE_DETECT_MODE_OFF OFF}
      • *
    • {@link #STATISTICS_FACE_DETECT_MODE_SIMPLE SIMPLE}
      • *
    • {@link #STATISTICS_FACE_DETECT_MODE_FULL FULL}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_FACE_DETECT_MODES android.statistics.info.availableFaceDetectModes}

    *

    This key is available on all devices.

    @@ -3295,11 +3318,12 @@ public final class CaptureRequest extends CameraMetadata> * android.statistics.lensShadingMap will be provided in * the output result metadata.

    *

    ON is always supported on devices with the RAW capability.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_LENS_SHADING_MAP_MODE_OFF OFF}
      • *
    • {@link #STATISTICS_LENS_SHADING_MAP_MODE_ON ON}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_LENS_SHADING_MAP_MODES android.statistics.info.availableLensShadingMapModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3326,11 +3350,12 @@ public final class CaptureRequest extends CameraMetadata> * at 30fps may have 6-7 OIS samples per capture result. This information can be combined * with the rolling shutter skew to account for lens motion during image exposure in * post-processing algorithms.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_OIS_DATA_MODE_OFF OFF}
      • *
    • {@link #STATISTICS_OIS_DATA_MODE_ON ON}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_OIS_DATA_MODES android.statistics.info.availableOisDataModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3523,14 +3548,15 @@ public final class CaptureRequest extends CameraMetadata> *

    If a request is sent with CONTRAST_CURVE with the camera device's * provided curve in FAST or HIGH_QUALITY, the image's tonemap will be * roughly the same.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #TONEMAP_MODE_CONTRAST_CURVE CONTRAST_CURVE}
      • *
    • {@link #TONEMAP_MODE_FAST FAST}
      • *
    • {@link #TONEMAP_MODE_HIGH_QUALITY HIGH_QUALITY}
      • *
    • {@link #TONEMAP_MODE_GAMMA_VALUE GAMMA_VALUE}
      • *
    • {@link #TONEMAP_MODE_PRESET_CURVE PRESET_CURVE}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#TONEMAP_AVAILABLE_TONE_MAP_MODES android.tonemap.availableToneMapModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3585,11 +3611,12 @@ public final class CaptureRequest extends CameraMetadata> *

    Rec. 709 tonemapping curve

    *

    Note that above figures show a 16 control points approximation of preset * curves. Camera devices may apply a different approximation to the curve.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #TONEMAP_PRESET_CURVE_SRGB SRGB}
      • *
    • {@link #TONEMAP_PRESET_CURVE_REC709 REC709}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    * * @see CaptureRequest#TONEMAP_MODE @@ -3754,12 +3781,13 @@ public final class CaptureRequest extends CameraMetadata> *
  • {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion}
    • *
  • {@link CaptureResult#STATISTICS_FACES android.statistics.faces}
    • * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #DISTORTION_CORRECTION_MODE_OFF OFF}
      • *
    • {@link #DISTORTION_CORRECTION_MODE_FAST FAST}
      • *
    • {@link #DISTORTION_CORRECTION_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#DISTORTION_CORRECTION_AVAILABLE_MODES android.distortionCorrection.availableModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    diff --git a/core/java/android/hardware/camera2/CaptureResult.java b/core/java/android/hardware/camera2/CaptureResult.java index 4424a71ae8372..66d8b50a073e7 100644 --- a/core/java/android/hardware/camera2/CaptureResult.java +++ b/core/java/android/hardware/camera2/CaptureResult.java @@ -449,12 +449,13 @@ public class CaptureResult extends CameraMetadata> { * *

    Both the input and output value ranges must match. Overflow/underflow * values are clipped to fit within the range.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #COLOR_CORRECTION_MODE_TRANSFORM_MATRIX TRANSFORM_MATRIX}
      • *
    • {@link #COLOR_CORRECTION_MODE_FAST FAST}
      • *
    • {@link #COLOR_CORRECTION_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Full capability - * Present on all camera devices that report being {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_FULL HARDWARE_LEVEL_FULL} devices in the @@ -542,12 +543,13 @@ public class CaptureResult extends CameraMetadata> { * capture rate. FAST means the camera device will not slow down capture rate when * applying aberration correction.

    *

    LEGACY devices will always be in FAST mode.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #COLOR_CORRECTION_ABERRATION_MODE_OFF OFF}
      • *
    • {@link #COLOR_CORRECTION_ABERRATION_MODE_FAST FAST}
      • *
    • {@link #COLOR_CORRECTION_ABERRATION_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES android.colorCorrection.availableAberrationModes}

    *

    This key is available on all devices.

    @@ -594,13 +596,14 @@ public class CaptureResult extends CameraMetadata> { * ensure it selects exposure times that do not cause banding * issues. The {@link CaptureResult#STATISTICS_SCENE_FLICKER android.statistics.sceneFlicker} key can assist * the application in this.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AE_ANTIBANDING_MODE_OFF OFF}
      • *
    • {@link #CONTROL_AE_ANTIBANDING_MODE_50HZ 50HZ}
      • *
    • {@link #CONTROL_AE_ANTIBANDING_MODE_60HZ 60HZ}
      • *
    • {@link #CONTROL_AE_ANTIBANDING_MODE_AUTO AUTO}
      • - *

    + * + * *

    Available values for this device:

    *

    {@link CameraCharacteristics#CONTROL_AE_AVAILABLE_ANTIBANDING_MODES android.control.aeAvailableAntibandingModes}

    *

    This key is available on all devices.

    @@ -725,7 +728,7 @@ public class CaptureResult extends CameraMetadata> { * camera device auto-exposure routine for the overridden * fields for a given capture will be available in its * CaptureResult.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AE_MODE_OFF OFF}
      • *
    • {@link #CONTROL_AE_MODE_ON ON}
      • @@ -733,7 +736,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_AE_MODE_ON_ALWAYS_FLASH ON_ALWAYS_FLASH}
      • *
    • {@link #CONTROL_AE_MODE_ON_AUTO_FLASH_REDEYE ON_AUTO_FLASH_REDEYE}
      • *
    • {@link #CONTROL_AE_MODE_ON_EXTERNAL_FLASH ON_EXTERNAL_FLASH}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#CONTROL_AE_AVAILABLE_MODES android.control.aeAvailableModes}

    *

    This key is available on all devices.

    @@ -899,12 +903,13 @@ public class CaptureResult extends CameraMetadata> { * example.

    *

    If both the precapture and the auto-focus trigger are activated on the same request, then * the camera device will complete them in the optimal order for that device.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AE_PRECAPTURE_TRIGGER_IDLE IDLE}
      • *
    • {@link #CONTROL_AE_PRECAPTURE_TRIGGER_START START}
      • *
    • {@link #CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL CANCEL}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -1139,7 +1144,7 @@ public class CaptureResult extends CameraMetadata> { * * * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AE_STATE_INACTIVE INACTIVE}
      • *
    • {@link #CONTROL_AE_STATE_SEARCHING SEARCHING}
      • @@ -1147,7 +1152,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_AE_STATE_LOCKED LOCKED}
      • *
    • {@link #CONTROL_AE_STATE_FLASH_REQUIRED FLASH_REQUIRED}
      • *
    • {@link #CONTROL_AE_STATE_PRECAPTURE PRECAPTURE}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -1184,7 +1190,7 @@ public class CaptureResult extends CameraMetadata> { *

    If the lens is controlled by the camera device auto-focus algorithm, * the camera device will report the current AF status in {@link CaptureResult#CONTROL_AF_STATE android.control.afState} * in result metadata.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AF_MODE_OFF OFF}
      • *
    • {@link #CONTROL_AF_MODE_AUTO AUTO}
      • @@ -1192,7 +1198,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_AF_MODE_CONTINUOUS_VIDEO CONTINUOUS_VIDEO}
      • *
    • {@link #CONTROL_AF_MODE_CONTINUOUS_PICTURE CONTINUOUS_PICTURE}
      • *
    • {@link #CONTROL_AF_MODE_EDOF EDOF}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#CONTROL_AF_AVAILABLE_MODES android.control.afAvailableModes}

    *

    This key is available on all devices.

    @@ -1307,12 +1314,13 @@ public class CaptureResult extends CameraMetadata> { * focus sweep), the camera device may delay acting on a later trigger until the previous * trigger has been fully handled. This may lead to longer intervals between the trigger and * changes to {@link CaptureResult#CONTROL_AF_STATE android.control.afState}, for example.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AF_TRIGGER_IDLE IDLE}
      • *
    • {@link #CONTROL_AF_TRIGGER_START START}
      • *
    • {@link #CONTROL_AF_TRIGGER_CANCEL CANCEL}
      • - *

    + * + * *

    This key is available on all devices.

    * * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER @@ -1708,7 +1716,7 @@ public class CaptureResult extends CameraMetadata> { * * * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AF_STATE_INACTIVE INACTIVE}
      • *
    • {@link #CONTROL_AF_STATE_PASSIVE_SCAN PASSIVE_SCAN}
      • @@ -1717,7 +1725,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_AF_STATE_FOCUSED_LOCKED FOCUSED_LOCKED}
      • *
    • {@link #CONTROL_AF_STATE_NOT_FOCUSED_LOCKED NOT_FOCUSED_LOCKED}
      • *
    • {@link #CONTROL_AF_STATE_PASSIVE_UNFOCUSED PASSIVE_UNFOCUSED}
      • - *

    + * + * *

    This key is available on all devices.

    * * @see CaptureRequest#CONTROL_AF_MODE @@ -1790,7 +1799,7 @@ public class CaptureResult extends CameraMetadata> { * {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform}, * {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} and * {@link CaptureRequest#COLOR_CORRECTION_MODE android.colorCorrection.mode} are ignored.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AWB_MODE_OFF OFF}
      • *
    • {@link #CONTROL_AWB_MODE_AUTO AUTO}
      • @@ -1801,7 +1810,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_AWB_MODE_CLOUDY_DAYLIGHT CLOUDY_DAYLIGHT}
      • *
    • {@link #CONTROL_AWB_MODE_TWILIGHT TWILIGHT}
      • *
    • {@link #CONTROL_AWB_MODE_SHADE SHADE}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#CONTROL_AWB_AVAILABLE_MODES android.control.awbAvailableModes}

    *

    This key is available on all devices.

    @@ -1915,7 +1925,7 @@ public class CaptureResult extends CameraMetadata> { * MANUAL_SENSOR. * * MOTION_TRACKING will be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains * MOTION_TRACKING.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_CAPTURE_INTENT_CUSTOM CUSTOM}
      • *
    • {@link #CONTROL_CAPTURE_INTENT_PREVIEW PREVIEW}
      • @@ -1925,7 +1935,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}
      • *
    • {@link #CONTROL_CAPTURE_INTENT_MANUAL MANUAL}
      • *
    • {@link #CONTROL_CAPTURE_INTENT_MOTION_TRACKING MOTION_TRACKING}
      • - *

    + * + * *

    This key is available on all devices.

    * * @see CaptureRequest#CONTROL_MODE @@ -2061,13 +2072,14 @@ public class CaptureResult extends CameraMetadata> { * * * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AWB_STATE_INACTIVE INACTIVE}
      • *
    • {@link #CONTROL_AWB_STATE_SEARCHING SEARCHING}
      • *
    • {@link #CONTROL_AWB_STATE_CONVERGED CONVERGED}
      • *
    • {@link #CONTROL_AWB_STATE_LOCKED LOCKED}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -2096,7 +2108,7 @@ public class CaptureResult extends CameraMetadata> { * implementor of the camera device, and should not be * depended on to be consistent (or present) across all * devices.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_EFFECT_MODE_OFF OFF}
      • *
    • {@link #CONTROL_EFFECT_MODE_MONO MONO}
      • @@ -2107,7 +2119,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_EFFECT_MODE_WHITEBOARD WHITEBOARD}
      • *
    • {@link #CONTROL_EFFECT_MODE_BLACKBOARD BLACKBOARD}
      • *
    • {@link #CONTROL_EFFECT_MODE_AQUA AQUA}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#CONTROL_AVAILABLE_EFFECTS android.control.availableEffects}

    *

    This key is available on all devices.

    @@ -2146,14 +2159,15 @@ public class CaptureResult extends CameraMetadata> { * update, as if this frame is never captured. This mode can be used in the scenario * where the application doesn't want a 3A manual control capture to affect * the subsequent auto 3A capture results.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_MODE_OFF OFF}
      • *
    • {@link #CONTROL_MODE_AUTO AUTO}
      • *
    • {@link #CONTROL_MODE_USE_SCENE_MODE USE_SCENE_MODE}
      • *
    • {@link #CONTROL_MODE_OFF_KEEP_STATE OFF_KEEP_STATE}
      • *
    • {@link #CONTROL_MODE_USE_EXTENDED_SCENE_MODE USE_EXTENDED_SCENE_MODE}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#CONTROL_AVAILABLE_MODES android.control.availableModes}

    *

    This key is available on all devices.

    @@ -2183,7 +2197,7 @@ public class CaptureResult extends CameraMetadata> { * to the implementor of the camera device. Their behavior will not be * consistent across all devices, and any given device may only implement * a subset of these modes.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_SCENE_MODE_DISABLED DISABLED}
      • *
    • {@link #CONTROL_SCENE_MODE_FACE_PRIORITY FACE_PRIORITY}
      • @@ -2204,7 +2218,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #CONTROL_SCENE_MODE_BARCODE BARCODE}
      • *
    • {@link #CONTROL_SCENE_MODE_HIGH_SPEED_VIDEO HIGH_SPEED_VIDEO}
      • *
    • {@link #CONTROL_SCENE_MODE_HDR HDR}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#CONTROL_AVAILABLE_SCENE_MODES android.control.availableSceneModes}

    *

    This key is available on all devices.

    @@ -2265,11 +2280,12 @@ public class CaptureResult extends CameraMetadata> { * ({@link CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE android.lens.opticalStabilizationMode}), turning both modes on may * produce undesirable interaction, so it is recommended not to enable * both at the same time.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_VIDEO_STABILIZATION_MODE_OFF OFF}
      • *
    • {@link #CONTROL_VIDEO_STABILIZATION_MODE_ON ON}
      • - *

    + * + * *

    This key is available on all devices.

    * * @see CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE @@ -2362,11 +2378,12 @@ public class CaptureResult extends CameraMetadata> { * result. Otherwise the value will be NOT_DETECTED. The threshold for detection is similar * to what would trigger a new passive focus scan to begin in CONTINUOUS autofocus modes.

    *

    This key will be available if the camera device advertises this key via {@link android.hardware.camera2.CameraCharacteristics#getAvailableCaptureResultKeys }.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_AF_SCENE_CHANGE_NOT_DETECTED NOT_DETECTED}
      • *
    • {@link #CONTROL_AF_SCENE_CHANGE_DETECTED DETECTED}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    * @see #CONTROL_AF_SCENE_CHANGE_NOT_DETECTED * @see #CONTROL_AF_SCENE_CHANGE_DETECTED @@ -2402,12 +2419,13 @@ public class CaptureResult extends CameraMetadata> { * with different field of view. As a result, when bokeh mode is enabled, the camera device * may override {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion} or {@link CaptureRequest#CONTROL_ZOOM_RATIO android.control.zoomRatio}, and the field of * view may be smaller than when bokeh mode is off.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #CONTROL_EXTENDED_SCENE_MODE_DISABLED DISABLED}
      • *
    • {@link #CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE BOKEH_STILL_CAPTURE}
      • *
    • {@link #CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS BOKEH_CONTINUOUS}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    * * @see CaptureRequest#CONTROL_ZOOM_RATIO @@ -2534,13 +2552,14 @@ public class CaptureResult extends CameraMetadata> { * device will apply FAST/HIGH_QUALITY YUV-domain edge enhancement, respectively. * The camera device may adjust its internal edge enhancement parameters for best * image quality based on the {@link CaptureRequest#REPROCESS_EFFECTIVE_EXPOSURE_FACTOR android.reprocess.effectiveExposureFactor}, if it is set.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #EDGE_MODE_OFF OFF}
      • *
    • {@link #EDGE_MODE_FAST FAST}
      • *
    • {@link #EDGE_MODE_HIGH_QUALITY HIGH_QUALITY}
      • *
    • {@link #EDGE_MODE_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#EDGE_AVAILABLE_EDGE_MODES android.edge.availableEdgeModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -2576,12 +2595,13 @@ public class CaptureResult extends CameraMetadata> { *

    When set to TORCH, the flash will be on continuously. This mode can be used * for use cases such as preview, auto-focus assist, still capture, or video recording.

    *

    The flash status will be reported by {@link CaptureResult#FLASH_STATE android.flash.state} in the capture result metadata.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #FLASH_MODE_OFF OFF}
      • *
    • {@link #FLASH_MODE_SINGLE SINGLE}
      • *
    • {@link #FLASH_MODE_TORCH TORCH}
      • - *

    + * + * *

    This key is available on all devices.

    * * @see CaptureRequest#CONTROL_AE_MODE @@ -2613,14 +2633,15 @@ public class CaptureResult extends CameraMetadata> { * *

    In all other conditions the state will not be available on * LEGACY devices (i.e. it will be null).

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #FLASH_STATE_UNAVAILABLE UNAVAILABLE}
      • *
    • {@link #FLASH_STATE_CHARGING CHARGING}
      • *
    • {@link #FLASH_STATE_READY READY}
      • *
    • {@link #FLASH_STATE_FIRED FIRED}
      • *
    • {@link #FLASH_STATE_PARTIAL PARTIAL}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -2646,12 +2667,13 @@ public class CaptureResult extends CameraMetadata> { *

    Hotpixel correction interpolates out, or otherwise removes, pixels * that do not accurately measure the incoming light (i.e. pixels that * are stuck at an arbitrary value or are oversensitive).

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #HOT_PIXEL_MODE_OFF OFF}
      • *
    • {@link #HOT_PIXEL_MODE_FAST FAST}
      • *
    • {@link #HOT_PIXEL_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#HOT_PIXEL_AVAILABLE_HOT_PIXEL_MODES android.hotPixel.availableHotPixelModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -2988,11 +3010,12 @@ public class CaptureResult extends CameraMetadata> { *

    Not all devices will support OIS; see * {@link CameraCharacteristics#LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION android.lens.info.availableOpticalStabilization} for * available controls.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #LENS_OPTICAL_STABILIZATION_MODE_OFF OFF}
      • *
    • {@link #LENS_OPTICAL_STABILIZATION_MODE_ON ON}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION android.lens.info.availableOpticalStabilization}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3032,11 +3055,12 @@ public class CaptureResult extends CameraMetadata> { *

    Then this state will always be STATIONARY.

    *

    When the state is MOVING, it indicates that at least one of the lens parameters * is changing.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #LENS_STATE_STATIONARY STATIONARY}
      • *
    • {@link #LENS_STATE_MOVING MOVING}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Limited capability - * Present on all camera devices that report being at least {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED HARDWARE_LEVEL_LIMITED} devices in the @@ -3338,14 +3362,15 @@ public class CaptureResult extends CameraMetadata> { * will apply FAST/HIGH_QUALITY YUV domain noise reduction, respectively. The camera device * may adjust the noise reduction parameters for best image quality based on the * {@link CaptureRequest#REPROCESS_EFFECTIVE_EXPOSURE_FACTOR android.reprocess.effectiveExposureFactor} if it is set.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #NOISE_REDUCTION_MODE_OFF OFF}
      • *
    • {@link #NOISE_REDUCTION_MODE_FAST FAST}
      • *
    • {@link #NOISE_REDUCTION_MODE_HIGH_QUALITY HIGH_QUALITY}
      • *
    • {@link #NOISE_REDUCTION_MODE_MINIMAL MINIMAL}
      • *
    • {@link #NOISE_REDUCTION_MODE_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES android.noiseReduction.availableNoiseReductionModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3622,14 +3647,15 @@ public class CaptureResult extends CameraMetadata> { *
  • 640x480 stream: top-left: (781, 375) on active array, size: (640, 480), downscaled 1.17x from sensor pixels
    • *
  • 1280x720 stream: top-left: (711, 375) on active array, size: (1280, 720), upscaled 1.71x from sensor pixels
    • * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SCALER_ROTATE_AND_CROP_NONE NONE}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_90 90}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_180 180}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_270 270}
      • *
    • {@link #SCALER_ROTATE_AND_CROP_AUTO AUTO}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES android.scaler.availableRotateAndCropModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -3951,7 +3977,7 @@ public class CaptureResult extends CameraMetadata> { * occur (and that the test pattern remain unmodified, since the flash * would not actually affect it).

    *

    Defaults to OFF.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SENSOR_TEST_PATTERN_MODE_OFF OFF}
      • *
    • {@link #SENSOR_TEST_PATTERN_MODE_SOLID_COLOR SOLID_COLOR}
      • @@ -3959,7 +3985,8 @@ public class CaptureResult extends CameraMetadata> { *
    • {@link #SENSOR_TEST_PATTERN_MODE_COLOR_BARS_FADE_TO_GRAY COLOR_BARS_FADE_TO_GRAY}
      • *
    • {@link #SENSOR_TEST_PATTERN_MODE_PN9 PN9}
      • *
    • {@link #SENSOR_TEST_PATTERN_MODE_CUSTOM1 CUSTOM1}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#SENSOR_AVAILABLE_TEST_PATTERN_MODES android.sensor.availableTestPatternModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -4105,12 +4132,13 @@ public class CaptureResult extends CameraMetadata> { * AWB are in AUTO modes({@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} != OFF and {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode} != * OFF), to get best results, it is recommended that the applications wait for the AE and AWB * to be converged before using the returned shading map data.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SHADING_MODE_OFF OFF}
      • *
    • {@link #SHADING_MODE_FAST FAST}
      • *
    • {@link #SHADING_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#SHADING_AVAILABLE_MODES android.shading.availableModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -4139,12 +4167,13 @@ public class CaptureResult extends CameraMetadata> { *

    Whether face detection is enabled, and whether it * should output just the basic fields or the full set of * fields.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_FACE_DETECT_MODE_OFF OFF}
      • *
    • {@link #STATISTICS_FACE_DETECT_MODE_SIMPLE SIMPLE}
      • *
    • {@link #STATISTICS_FACE_DETECT_MODE_FULL FULL}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_FACE_DETECT_MODES android.statistics.info.availableFaceDetectModes}

    *

    This key is available on all devices.

    @@ -4509,12 +4538,13 @@ public class CaptureResult extends CameraMetadata> { * into this metadata field. See * {@link CaptureRequest#CONTROL_AE_ANTIBANDING_MODE android.control.aeAntibandingMode} for more details.

    *

    Reports NONE if there doesn't appear to be flickering illumination.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_SCENE_FLICKER_NONE NONE}
      • *
    • {@link #STATISTICS_SCENE_FLICKER_50HZ 50HZ}
      • *
    • {@link #STATISTICS_SCENE_FLICKER_60HZ 60HZ}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    *

    Full capability - * Present on all camera devices that report being {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_FULL HARDWARE_LEVEL_FULL} devices in the @@ -4578,11 +4608,12 @@ public class CaptureResult extends CameraMetadata> { * android.statistics.lensShadingMap will be provided in * the output result metadata.

    *

    ON is always supported on devices with the RAW capability.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_LENS_SHADING_MAP_MODE_OFF OFF}
      • *
    • {@link #STATISTICS_LENS_SHADING_MAP_MODE_ON ON}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_LENS_SHADING_MAP_MODES android.statistics.info.availableLensShadingMapModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -4609,11 +4640,12 @@ public class CaptureResult extends CameraMetadata> { * at 30fps may have 6-7 OIS samples per capture result. This information can be combined * with the rolling shutter skew to account for lens motion during image exposure in * post-processing algorithms.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #STATISTICS_OIS_DATA_MODE_OFF OFF}
      • *
    • {@link #STATISTICS_OIS_DATA_MODE_ON ON}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_OIS_DATA_MODES android.statistics.info.availableOisDataModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -4881,14 +4913,15 @@ public class CaptureResult extends CameraMetadata> { *

    If a request is sent with CONTRAST_CURVE with the camera device's * provided curve in FAST or HIGH_QUALITY, the image's tonemap will be * roughly the same.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #TONEMAP_MODE_CONTRAST_CURVE CONTRAST_CURVE}
      • *
    • {@link #TONEMAP_MODE_FAST FAST}
      • *
    • {@link #TONEMAP_MODE_HIGH_QUALITY HIGH_QUALITY}
      • *
    • {@link #TONEMAP_MODE_GAMMA_VALUE GAMMA_VALUE}
      • *
    • {@link #TONEMAP_MODE_PRESET_CURVE PRESET_CURVE}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#TONEMAP_AVAILABLE_TONE_MAP_MODES android.tonemap.availableToneMapModes}

    *

    Optional - The value for this key may be {@code null} on some devices.

    @@ -4943,11 +4976,12 @@ public class CaptureResult extends CameraMetadata> { *

    Rec. 709 tonemapping curve

    *

    Note that above figures show a 16 control points approximation of preset * curves. Camera devices may apply a different approximation to the curve.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #TONEMAP_PRESET_CURVE_SRGB SRGB}
      • *
    • {@link #TONEMAP_PRESET_CURVE_REC709 REC709}
      • - *

    + * + * *

    Optional - The value for this key may be {@code null} on some devices.

    * * @see CaptureRequest#TONEMAP_MODE @@ -5048,11 +5082,12 @@ public class CaptureResult extends CameraMetadata> { *

    In other words, results for this current request and up to * {@link CameraCharacteristics#REQUEST_PIPELINE_MAX_DEPTH android.request.pipelineMaxDepth} prior requests may have their * android.sync.frameNumber change to CONVERGING.

    - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #SYNC_FRAME_NUMBER_CONVERGING CONVERGING}
      • *
    • {@link #SYNC_FRAME_NUMBER_UNKNOWN UNKNOWN}
      • - *

    + * + * *

    Available values for this device:
    * Either a non-negative value corresponding to a * frame_number, or one of the two enums (CONVERGING / UNKNOWN).

    @@ -5174,12 +5209,13 @@ public class CaptureResult extends CameraMetadata> { *
  • {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion}
    • *
  • {@link CaptureResult#STATISTICS_FACES android.statistics.faces}
    • * - *

    Possible values: + *

    Possible values:

    *
      *
    • {@link #DISTORTION_CORRECTION_MODE_OFF OFF}
      • *
    • {@link #DISTORTION_CORRECTION_MODE_FAST FAST}
      • *
    • {@link #DISTORTION_CORRECTION_MODE_HIGH_QUALITY HIGH_QUALITY}
      • - *

    + * + * *

    Available values for this device:
    * {@link CameraCharacteristics#DISTORTION_CORRECTION_AVAILABLE_MODES android.distortionCorrection.availableModes}

    *

    Optional - The value for this key may be {@code null} on some devices.