Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b7d11309 authored by Android Build Merger (Role)'s avatar Android Build Merger (Role)
Browse files

[automerger] Merge "Camera: codegen doc update" into pi-dev am: 941189bf am: f1558d29 

Change-Id: Iad180583db4457b41dc9c30a6a80ce46ef28a085
parents 1a64e1a1 f1558d29

core/java/android/hardware/camera2/CameraCharacteristics.java

+17 −5
Original line number Diff line number Diff line
@@ -2365,13 +2365,25 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion}, is defined relative to the active array rectangle given in

     * this field, with <code>(0, 0)</code> being the top-left of this rectangle.</p>

     * <p>The active array may be smaller than the full pixel array, since the full array may

     * include black calibration pixels or other inactive regions, and geometric correction

     * resulting in scaling or cropping may have been applied.</p>

     * include black calibration pixels or other inactive regions.</p>

     * <p>For devices that do not support {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the active

     * array must be the same as {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.</p>

     * <p>For devices that support {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the active array must

     * be enclosed by {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}. The difference between

     * pre-correction active array and active array accounts for scaling or cropping caused

     * by lens geometric distortion correction.</p>

     * <p>In general, application should always refer to active array size for controls like

     * metering regions or crop region. Two exceptions are when the application is dealing with

     * RAW image buffers (RAW_SENSOR, RAW10, RAW12 etc), or when application explicitly set

     * {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} to OFF. In these cases, application should refer

     * to {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.</p>

     * <p><b>Units</b>: Pixel coordinates on the image sensor</p>

     * <p>This key is available on all devices.</p>

     *

     * @see CaptureRequest#DISTORTION_CORRECTION_MODE

     * @see CaptureRequest#SCALER_CROP_REGION

     * @see CameraCharacteristics#SENSOR_INFO_PIXEL_ARRAY_SIZE

     * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE

     */

    @PublicKey

    public static final Key<android.graphics.Rect> SENSOR_INFO_ACTIVE_ARRAY_SIZE =
@@ -2616,9 +2628,9 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <ol>

     * <li>{@link CameraCharacteristics#LENS_DISTORTION android.lens.distortion}.</li>

     * </ol>

     * <p>If all of the geometric distortion fields are no-ops, this rectangle will be the same

     * as the post-distortion-corrected rectangle given in

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.</p>

     * <p>If the camera device doesn't support geometric distortion correction, or all of the

     * geometric distortion fields are no-ops, this rectangle will be the same as the

     * post-distortion-corrected rectangle given in {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.</p>

     * <p>This rectangle is defined relative to the full pixel array; (0,0) is the top-left of

     * the full pixel array, and the size of the full pixel array is given by

     * {@link CameraCharacteristics#SENSOR_INFO_PIXEL_ARRAY_SIZE android.sensor.info.pixelArraySize}.</p>

core/java/android/hardware/camera2/CaptureRequest.java

+111 −33
Original line number Diff line number Diff line
@@ -1269,11 +1269,26 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * Otherwise will always be present.</p>

     * <p>The maximum number of regions supported by the device is determined by the value

     * of {@link CameraCharacteristics#CONTROL_MAX_REGIONS_AE android.control.maxRegionsAe}.</p>

     * <p>The coordinate system is based on the active pixel array,

     * with (0,0) being the top-left pixel in the active pixel array, and

     * <p>For devices not supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system always follows that of {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with (0,0) being

     * the top-left pixel in the active pixel array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the

     * bottom-right pixel in the active pixel array.</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the bottom-right pixel in the

     * active pixel array.</p>

     * <p>For devices supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system depends on the mode being set.

     * When the distortion correction mode is OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the pre-correction active array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.height - 1) being the bottom-right

     * pixel in the pre-correction active pixel array.

     * When the distortion correction mode is not OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the active array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the bottom-right pixel in the

     * active pixel array.</p>

     * <p>The weight must be within <code>[0, 1000]</code>, and represents a weight

     * for every pixel in the area. This means that a large metering area

     * with the same weight as a smaller area will have more effect in
@@ -1289,15 +1304,20 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * region and output only the intersection rectangle as the metering region in the result

     * metadata.  If the region is entirely outside the crop region, it will be ignored and

     * not reported in the result metadata.</p>

     * <p><b>Units</b>: Pixel coordinates within {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * <p><b>Units</b>: Pixel coordinates within {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize} depending on

     * distortion correction capability and mode</p>

     * <p><b>Range of valid values:</b><br>

     * Coordinates must be between <code>[(0,0), (width, height))</code> of

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}

     * depending on distortion correction capability and mode</p>

     * <p><b>Optional</b> - This value may be {@code null} on some devices.</p>

     *

     * @see CameraCharacteristics#CONTROL_MAX_REGIONS_AE

     * @see CaptureRequest#DISTORTION_CORRECTION_MODE

     * @see CaptureRequest#SCALER_CROP_REGION

     * @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE

     * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE

     */

    @PublicKey

    public static final Key<android.hardware.camera2.params.MeteringRectangle[]> CONTROL_AE_REGIONS =
@@ -1443,11 +1463,26 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * Otherwise will always be present.</p>

     * <p>The maximum number of focus areas supported by the device is determined by the value

     * of {@link CameraCharacteristics#CONTROL_MAX_REGIONS_AF android.control.maxRegionsAf}.</p>

     * <p>The coordinate system is based on the active pixel array,

     * with (0,0) being the top-left pixel in the active pixel array, and

     * <p>For devices not supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system always follows that of {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with (0,0) being

     * the top-left pixel in the active pixel array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the bottom-right pixel in the

     * active pixel array.</p>

     * <p>For devices supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system depends on the mode being set.

     * When the distortion correction mode is OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the pre-correction active array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.height - 1) being the bottom-right

     * pixel in the pre-correction active pixel array.

     * When the distortion correction mode is not OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the active array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the

     * bottom-right pixel in the active pixel array.</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the bottom-right pixel in the

     * active pixel array.</p>

     * <p>The weight must be within <code>[0, 1000]</code>, and represents a weight

     * for every pixel in the area. This means that a large metering area

     * with the same weight as a smaller area will have more effect in
@@ -1464,15 +1499,20 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * region and output only the intersection rectangle as the metering region in the result

     * metadata. If the region is entirely outside the crop region, it will be ignored and

     * not reported in the result metadata.</p>

     * <p><b>Units</b>: Pixel coordinates within {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * <p><b>Units</b>: Pixel coordinates within {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize} depending on

     * distortion correction capability and mode</p>

     * <p><b>Range of valid values:</b><br>

     * Coordinates must be between <code>[(0,0), (width, height))</code> of

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}

     * depending on distortion correction capability and mode</p>

     * <p><b>Optional</b> - This value may be {@code null} on some devices.</p>

     *

     * @see CameraCharacteristics#CONTROL_MAX_REGIONS_AF

     * @see CaptureRequest#DISTORTION_CORRECTION_MODE

     * @see CaptureRequest#SCALER_CROP_REGION

     * @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE

     * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE

     */

    @PublicKey

    public static final Key<android.hardware.camera2.params.MeteringRectangle[]> CONTROL_AF_REGIONS =
@@ -1612,11 +1652,26 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * Otherwise will always be present.</p>

     * <p>The maximum number of regions supported by the device is determined by the value

     * of {@link CameraCharacteristics#CONTROL_MAX_REGIONS_AWB android.control.maxRegionsAwb}.</p>

     * <p>The coordinate system is based on the active pixel array,

     * with (0,0) being the top-left pixel in the active pixel array, and

     * <p>For devices not supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system always follows that of {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with (0,0) being

     * the top-left pixel in the active pixel array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the

     * bottom-right pixel in the active pixel array.</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the bottom-right pixel in the

     * active pixel array.</p>

     * <p>For devices supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system depends on the mode being set.

     * When the distortion correction mode is OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the pre-correction active array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.height - 1) being the bottom-right

     * pixel in the pre-correction active pixel array.

     * When the distortion correction mode is not OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the active array, and

     * ({@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.width - 1,

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.height - 1) being the bottom-right pixel in the

     * active pixel array.</p>

     * <p>The weight must range from 0 to 1000, and represents a weight

     * for every pixel in the area. This means that a large metering area

     * with the same weight as a smaller area will have more effect in
@@ -1632,15 +1687,20 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * region and output only the intersection rectangle as the metering region in the result

     * metadata.  If the region is entirely outside the crop region, it will be ignored and

     * not reported in the result metadata.</p>

     * <p><b>Units</b>: Pixel coordinates within {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * <p><b>Units</b>: Pixel coordinates within {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize} depending on

     * distortion correction capability and mode</p>

     * <p><b>Range of valid values:</b><br>

     * Coordinates must be between <code>[(0,0), (width, height))</code> of

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}

     * depending on distortion correction capability and mode</p>

     * <p><b>Optional</b> - This value may be {@code null} on some devices.</p>

     *

     * @see CameraCharacteristics#CONTROL_MAX_REGIONS_AWB

     * @see CaptureRequest#DISTORTION_CORRECTION_MODE

     * @see CaptureRequest#SCALER_CROP_REGION

     * @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE

     * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE

     */

    @PublicKey

    public static final Key<android.hardware.camera2.params.MeteringRectangle[]> CONTROL_AWB_REGIONS =
@@ -2433,9 +2493,17 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    /**

     * <p>The desired region of the sensor to read out for this capture.</p>

     * <p>This control can be used to implement digital zoom.</p>

     * <p>The crop region coordinate system is based off

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with <code>(0, 0)</code> being the

     * top-left corner of the sensor active array.</p>

     * <p>For devices not supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system always follows that of {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with <code>(0, 0)</code> being

     * the top-left pixel of the active array.</p>

     * <p>For devices supporting {@link CaptureRequest#DISTORTION_CORRECTION_MODE android.distortionCorrection.mode} control, the coordinate

     * system depends on the mode being set.

     * When the distortion correction mode is OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the pre-correction active array.

     * When the distortion correction mode is not OFF, the coordinate system follows

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}, with

     * <code>(0, 0)</code> being the top-left pixel of the active array.</p>

     * <p>Output streams use this rectangle to produce their output,

     * cropping to a smaller region if necessary to maintain the

     * stream's aspect ratio, then scaling the sensor input to
@@ -2454,20 +2522,30 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * outputs will crop horizontally (pillarbox), and 16:9

     * streams will match exactly. These additional crops will

     * be centered within the crop region.</p>

     * <p>The width and height of the crop region cannot

     * be set to be smaller than

     * <p>If the coordinate system is android.sensor.info.activeArraysSize, the width and height

     * of the crop region cannot be set to be smaller than

     * <code>floor( activeArraySize.width / {@link CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM android.scaler.availableMaxDigitalZoom} )</code> and

     * <code>floor( activeArraySize.height / {@link CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM android.scaler.availableMaxDigitalZoom} )</code>, respectively.</p>

     * <p>If the coordinate system is {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}, the width

     * and height of the crop region cannot be set to be smaller than

     * <code>floor( preCorrectionActiveArraySize.width / {@link CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM android.scaler.availableMaxDigitalZoom} )</code>

     * and

     * <code>floor( preCorrectionActiveArraySize.height / {@link CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM android.scaler.availableMaxDigitalZoom} )</code>,

     * respectively.</p>

     * <p>The camera device may adjust the crop region to account

     * for rounding and other hardware requirements; the final

     * crop region used will be included in the output capture

     * result.</p>

     * <p><b>Units</b>: Pixel coordinates relative to

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</p>

     * {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} or

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize} depending on distortion correction

     * capability and mode</p>

     * <p>This key is available on all devices.</p>

     *

     * @see CaptureRequest#DISTORTION_CORRECTION_MODE

     * @see CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM

     * @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE

     * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE

     */

    @PublicKey

    public static final Key<android.graphics.Rect> SCALER_CROP_REGION =
@@ -3188,13 +3266,12 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * <p>The correction only applies to processed outputs such as YUV, JPEG, or DEPTH16; it is not

     * applied to any RAW output. Metadata coordinates such as face rectangles or metering

     * regions are also not affected by correction.</p>

     * <p>Applications enabling distortion correction need to pay extra attention when converting

     * image coordinates between corrected output buffers and the sensor array. For example, if

     * the app supports tap-to-focus and enables correction, it then has to apply the distortion

     * model described in {@link CameraCharacteristics#LENS_DISTORTION android.lens.distortion} to the image buffer tap coordinates to properly

     * calculate the tap position on the sensor active array to be used with

     * {@link CaptureRequest#CONTROL_AF_REGIONS android.control.afRegions}. The same applies in reverse to detected face rectangles if

     * they need to be drawn on top of the corrected output buffers.</p>

     * <p>This control will be on by default on devices that support this control. Applications

     * disabling distortion correction need to pay extra attention with the coordinate system of

     * metering regions, crop region, and face rectangles. When distortion correction is OFF,

     * metadata coordinates follow the coordinate system of

     * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}. When distortion is not OFF, metadata

     * coordinates follow the coordinate system of {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}.</p>

     * <p><b>Possible values:</b>

     * <ul>

     *   <li>{@link #DISTORTION_CORRECTION_MODE_OFF OFF}</li>
@@ -3205,9 +3282,10 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * {@link CameraCharacteristics#DISTORTION_CORRECTION_AVAILABLE_MODES android.distortionCorrection.availableModes}</p>

     * <p><b>Optional</b> - This value may be {@code null} on some devices.</p>

     *

     * @see CaptureRequest#CONTROL_AF_REGIONS

     * @see CameraCharacteristics#DISTORTION_CORRECTION_AVAILABLE_MODES

     * @see CameraCharacteristics#LENS_DISTORTION

     * @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE

     * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE

     * @see #DISTORTION_CORRECTION_MODE_OFF

     * @see #DISTORTION_CORRECTION_MODE_FAST

     * @see #DISTORTION_CORRECTION_MODE_HIGH_QUALITY