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

Commit ec99efa0 authored by Eino-Ville Talvala's avatar Eino-Ville Talvala
Browse files

Camera2: Add MOTION_TRACKING capability/intent, and lens poseReference 

- MOTION_TRACKING capability defines a camera with accurate lens calibration
  values, accurate timestamps relative to the inertial sensors, and ability
  to limit exposure time to 20ms max.
- Add android.lens.poseReference for supporting gyroscope-centered lens calibration
  data for MOTION_TRACKING.
- Minor changes to some docs formatting.

Test: Builds
Bug: 63629224
Change-Id: Ic303240890c709725f60e69dfff76beea4a0ef91
parent bf1b0b04

api/current.txt

+7 −0
Original line number Diff line number Diff line
@@ -15530,6 +15530,7 @@ package android.hardware.camera2 { 
    field public static final android.hardware.camera2.CameraCharacteristics.Key<java.lang.Float> LENS_INFO_HYPERFOCAL_DISTANCE;

    field public static final android.hardware.camera2.CameraCharacteristics.Key<java.lang.Float> LENS_INFO_MINIMUM_FOCUS_DISTANCE;

    field public static final android.hardware.camera2.CameraCharacteristics.Key<float[]> LENS_INTRINSIC_CALIBRATION;

    field public static final android.hardware.camera2.CameraCharacteristics.Key<java.lang.Integer> LENS_POSE_REFERENCE;

    field public static final android.hardware.camera2.CameraCharacteristics.Key<float[]> LENS_POSE_ROTATION;

    field public static final android.hardware.camera2.CameraCharacteristics.Key<float[]> LENS_POSE_TRANSLATION;

    field public static final android.hardware.camera2.CameraCharacteristics.Key<float[]> LENS_RADIAL_DISTORTION;
@@ -15602,6 +15603,8 @@ package android.hardware.camera2 { 
    method public abstract void createReprocessableCaptureSessionByConfigurations(android.hardware.camera2.params.InputConfiguration, java.util.List<android.hardware.camera2.params.OutputConfiguration>, android.hardware.camera2.CameraCaptureSession.StateCallback, android.os.Handler) throws android.hardware.camera2.CameraAccessException;

    method public abstract java.lang.String getId();

    field public static final int TEMPLATE_MANUAL = 6; // 0x6

    field public static final int TEMPLATE_MOTION_TRACKING_BEST = 8; // 0x8

    field public static final int TEMPLATE_MOTION_TRACKING_PREVIEW = 7; // 0x7

    field public static final int TEMPLATE_PREVIEW = 1; // 0x1

    field public static final int TEMPLATE_RECORD = 3; // 0x3

    field public static final int TEMPLATE_STILL_CAPTURE = 2; // 0x2
@@ -15704,6 +15707,7 @@ package android.hardware.camera2 { 
    field public static final int CONTROL_AWB_STATE_SEARCHING = 1; // 0x1

    field public static final int CONTROL_CAPTURE_INTENT_CUSTOM = 0; // 0x0

    field public static final int CONTROL_CAPTURE_INTENT_MANUAL = 6; // 0x6

    field public static final int CONTROL_CAPTURE_INTENT_MOTION_TRACKING = 7; // 0x7

    field public static final int CONTROL_CAPTURE_INTENT_PREVIEW = 1; // 0x1

    field public static final int CONTROL_CAPTURE_INTENT_STILL_CAPTURE = 2; // 0x2

    field public static final int CONTROL_CAPTURE_INTENT_VIDEO_RECORD = 3; // 0x3
@@ -15770,6 +15774,8 @@ package android.hardware.camera2 { 
    field public static final int LENS_INFO_FOCUS_DISTANCE_CALIBRATION_UNCALIBRATED = 0; // 0x0

    field public static final int LENS_OPTICAL_STABILIZATION_MODE_OFF = 0; // 0x0

    field public static final int LENS_OPTICAL_STABILIZATION_MODE_ON = 1; // 0x1

    field public static final int LENS_POSE_REFERENCE_GYROSCOPE = 1; // 0x1

    field public static final int LENS_POSE_REFERENCE_PRIMARY_CAMERA = 0; // 0x0

    field public static final int LENS_STATE_MOVING = 1; // 0x1

    field public static final int LENS_STATE_STATIONARY = 0; // 0x0

    field public static final int NOISE_REDUCTION_MODE_FAST = 1; // 0x1
@@ -15783,6 +15789,7 @@ package android.hardware.camera2 { 
    field public static final int REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT = 8; // 0x8

    field public static final int REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING = 2; // 0x2

    field public static final int REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR = 1; // 0x1

    field public static final int REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING = 10; // 0xa

    field public static final int REQUEST_AVAILABLE_CAPABILITIES_PRIVATE_REPROCESSING = 4; // 0x4

    field public static final int REQUEST_AVAILABLE_CAPABILITIES_RAW = 3; // 0x3

    field public static final int REQUEST_AVAILABLE_CAPABILITIES_READ_SENSOR_SETTINGS = 5; // 0x5

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

+48 −27
Original line number Diff line number Diff line
@@ -1149,36 +1149,33 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
    /**

     * <p>Position of the camera optical center.</p>

     * <p>The position of the camera device's lens optical center,

     * as a three-dimensional vector <code>(x,y,z)</code>, relative to the

     * optical center of the largest camera device facing in the

     * same direction as this camera, in the {@link android.hardware.SensorEvent Android sensor coordinate

     * axes}. Note that only the axis definitions are shared with

     * the sensor coordinate system, but not the origin.</p>

     * <p>If this device is the largest or only camera device with a

     * given facing, then this position will be <code>(0, 0, 0)</code>; a

     * camera device with a lens optical center located 3 cm from

     * the main sensor along the +X axis (to the right from the

     * user's perspective) will report <code>(0.03, 0, 0)</code>.</p>

     * <p>To transform a pixel coordinates between two cameras

     * facing the same direction, first the source camera

     * {@link CameraCharacteristics#LENS_RADIAL_DISTORTION android.lens.radialDistortion} must be corrected for.  Then

     * the source camera {@link CameraCharacteristics#LENS_INTRINSIC_CALIBRATION android.lens.intrinsicCalibration} needs

     * to be applied, followed by the {@link CameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation}

     * of the source camera, the translation of the source camera

     * relative to the destination camera, the

     * {@link CameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation} of the destination camera, and

     * finally the inverse of {@link CameraCharacteristics#LENS_INTRINSIC_CALIBRATION android.lens.intrinsicCalibration}

     * of the destination camera. This obtains a

     * radial-distortion-free coordinate in the destination

     * camera pixel coordinates.</p>

     * <p>To compare this against a real image from the destination

     * camera, the destination camera image then needs to be

     * corrected for radial distortion before comparison or

     * sampling.</p>

     * as a three-dimensional vector <code>(x,y,z)</code>.</p>

     * <p>Prior to Android P, or when {@link CameraCharacteristics#LENS_POSE_REFERENCE android.lens.poseReference} is PRIMARY_CAMERA, this position

     * is relative to the optical center of the largest camera device facing in the same

     * direction as this camera, in the {@link android.hardware.SensorEvent Android sensor

     * coordinate axes}. Note that only the axis definitions are shared with the sensor

     * coordinate system, but not the origin.</p>

     * <p>If this device is the largest or only camera device with a given facing, then this

     * position will be <code>(0, 0, 0)</code>; a camera device with a lens optical center located 3 cm

     * from the main sensor along the +X axis (to the right from the user's perspective) will

     * report <code>(0.03, 0, 0)</code>.</p>

     * <p>To transform a pixel coordinates between two cameras facing the same direction, first

     * the source camera {@link CameraCharacteristics#LENS_RADIAL_DISTORTION android.lens.radialDistortion} must be corrected for.  Then the source

     * camera {@link CameraCharacteristics#LENS_INTRINSIC_CALIBRATION android.lens.intrinsicCalibration} needs to be applied, followed by the

     * {@link CameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation} of the source camera, the translation of the source camera

     * relative to the destination camera, the {@link CameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation} of the destination

     * camera, and finally the inverse of {@link CameraCharacteristics#LENS_INTRINSIC_CALIBRATION android.lens.intrinsicCalibration} of the destination

     * camera. This obtains a radial-distortion-free coordinate in the destination camera pixel

     * coordinates.</p>

     * <p>To compare this against a real image from the destination camera, the destination camera

     * image then needs to be corrected for radial distortion before comparison or sampling.</p>

     * <p>When {@link CameraCharacteristics#LENS_POSE_REFERENCE android.lens.poseReference} is GYROSCOPE, then this position is relative to

     * the center of the primary gyroscope on the device.</p>

     * <p><b>Units</b>: Meters</p>

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

     *

     * @see CameraCharacteristics#LENS_INTRINSIC_CALIBRATION

     * @see CameraCharacteristics#LENS_POSE_REFERENCE

     * @see CameraCharacteristics#LENS_POSE_ROTATION

     * @see CameraCharacteristics#LENS_RADIAL_DISTORTION

     */
@@ -1288,6 +1285,28 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
    public static final Key<float[]> LENS_RADIAL_DISTORTION =

            new Key<float[]>("android.lens.radialDistortion", float[].class);



    /**

     * <p>The origin for {@link CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation}.</p>

     * <p>Different calibration methods and use cases can produce better or worse results

     * depending on the selected coordinate origin.</p>

     * <p>For devices designed to support the MOTION_TRACKING capability, the GYROSCOPE origin

     * makes device calibration and later usage by applications combining camera and gyroscope

     * information together simpler.</p>

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

     * <ul>

     *   <li>{@link #LENS_POSE_REFERENCE_PRIMARY_CAMERA PRIMARY_CAMERA}</li>

     *   <li>{@link #LENS_POSE_REFERENCE_GYROSCOPE GYROSCOPE}</li>

     * </ul></p>

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

     *

     * @see CameraCharacteristics#LENS_POSE_TRANSLATION

     * @see #LENS_POSE_REFERENCE_PRIMARY_CAMERA

     * @see #LENS_POSE_REFERENCE_GYROSCOPE

     */

    @PublicKey

    public static final Key<Integer> LENS_POSE_REFERENCE =

            new Key<Integer>("android.lens.poseReference", int.class);



    /**

     * <p>List of noise reduction modes for {@link CaptureRequest#NOISE_REDUCTION_MODE android.noiseReduction.mode} that are supported

     * by this camera device.</p>
@@ -1559,6 +1578,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     *   <li>{@link #REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING YUV_REPROCESSING}</li>

     *   <li>{@link #REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT DEPTH_OUTPUT}</li>

     *   <li>{@link #REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO CONSTRAINED_HIGH_SPEED_VIDEO}</li>

     *   <li>{@link #REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING MOTION_TRACKING}</li>

     * </ul></p>

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

     *
@@ -1573,6 +1593,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * @see #REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING

     * @see #REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT

     * @see #REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO

     * @see #REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING

     */

    @PublicKey

    public static final Key<int[]> REQUEST_AVAILABLE_CAPABILITIES =
@@ -1643,7 +1664,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * time-consuming hardware re-configuration or internal camera pipeline

     * change. For performance reasons we advise clients to pass their initial

     * values as part of

     * {@link SessionConfiguration#setSessionParameters }.i

     * {@link SessionConfiguration#setSessionParameters }.

     * Once the camera capture session is enabled it is also recommended to avoid

     * changing them from their initial values set in

     * {@link SessionConfiguration#setSessionParameters }.

core/java/android/hardware/camera2/CameraDevice.java

+49 −0
Original line number Diff line number Diff line
@@ -144,6 +144,37 @@ public abstract class CameraDevice implements AutoCloseable { 
     */

    public static final int TEMPLATE_MANUAL = 6;



    /**

     * A template for selecting camera parameters that match TEMPLATE_PREVIEW as closely as

     * possible while improving the camera output for motion tracking use cases.

     *

     * <p>This template is best used by applications that are frequently switching between motion

     * tracking use cases and regular still capture use cases, to minimize the IQ changes

     * when swapping use cases.</p>

     *

     * <p>This template is guaranteed to be supported on camera devices that support the

     * {@link CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING MOTION_TRACKING}

     * capability.</p>

     *

     * @see #createCaptureRequest

     */

    public static final int TEMPLATE_MOTION_TRACKING_PREVIEW = 7;



    /**

     * A template for selecting camera parameters that maximize the quality of camera output for

     * motion tracking use cases.

     *

     * <p>This template is best used by applications dedicated to motion tracking applications,

     * which aren't concerned about fast switches between motion tracking and other use cases.</p>

     *

     * <p>This template is guaranteed to be supported on camera devices that support the

     * {@link CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING MOTION_TRACKING}

     * capability.</p>

     *

     * @see #createCaptureRequest

     */

    public static final int TEMPLATE_MOTION_TRACKING_BEST = 8;



     /** @hide */

     @Retention(RetentionPolicy.SOURCE)

     @IntDef(prefix = {"TEMPLATE_"}, value =
@@ -386,6 +417,24 @@ public abstract class CameraDevice implements AutoCloseable { 
     * </table><br>

     * </p>

     *

     * <p>MOTION_TRACKING-capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES}

     * includes

     * {@link CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING MOTION_TRACKING})

     * devices support at least the below stream combinations in addition to those for

     * {@link CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED} devices. The

     * {@code FULL FOV 640} entry means that the device will support a resolution that's 640 pixels

     * wide, with the height set so that the resolution aspect ratio matches the MAXIMUM output

     * aspect ratio.  So for a device with a 4:3 image sensor, this will be 640x480, and for a

     * device with a 16:9 sensor, this will be 640x360, and so on.

     *

     * <table>

     * <tr><th colspan="7">MOTION_TRACKING-capability additional guaranteed configurations</th></tr>

     * <tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th><th rowspan="2">Sample use case(s)</th> </tr>

     * <tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr>

     * <tr> <td>{@code PRIV}</td><td id="rb">{@code PREVIEW}</td> <td>{@code YUV }</td><td id="rb">{@code FULL FOV 640}</td> <td>{@code YUV }</td><td id="rb">{@code MAXIMUM}</td> <td>Live preview with a tracking YUV output and a maximum-resolution YUV for still captures.</td> </tr>

     * </table><br>

     * </p>

     *

     * <p>BURST-capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES} includes

     * {@link CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE BURST_CAPTURE}) devices

     * support at least the below stream combinations in addition to those for

core/java/android/hardware/camera2/CameraMetadata.java

+81 −0
Original line number Diff line number Diff line
@@ -335,6 +335,30 @@ public abstract class CameraMetadata<TKey> { 
     */

    public static final int LENS_FACING_EXTERNAL = 2;



    //

    // Enumeration values for CameraCharacteristics#LENS_POSE_REFERENCE

    //



    /**

     * <p>The value of {@link CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation} is relative to the optical center of

     * the largest camera device facing the same direction as this camera.</p>

     * <p>This default value for API levels before Android P.</p>

     *

     * @see CameraCharacteristics#LENS_POSE_TRANSLATION

     * @see CameraCharacteristics#LENS_POSE_REFERENCE

     */

    public static final int LENS_POSE_REFERENCE_PRIMARY_CAMERA = 0;



    /**

     * <p>The value of {@link CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation} is relative to the position of the

     * primary gyroscope of this Android device.</p>

     * <p>This is the value reported by all devices that support the MOTION_TRACKING capability.</p>

     *

     * @see CameraCharacteristics#LENS_POSE_TRANSLATION

     * @see CameraCharacteristics#LENS_POSE_REFERENCE

     */

    public static final int LENS_POSE_REFERENCE_GYROSCOPE = 1;



    //

    // Enumeration values for CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES

    //
@@ -665,6 +689,7 @@ public abstract class CameraMetadata<TKey> { 
     * </ul>

     * </li>

     * <li>The {@link CameraCharacteristics#DEPTH_DEPTH_IS_EXCLUSIVE android.depth.depthIsExclusive} entry is listed by this device.</li>

     * <li>As of Android P, the {@link CameraCharacteristics#LENS_POSE_REFERENCE android.lens.poseReference} entry is listed by this device.</li>

     * <li>A LIMITED camera with only the DEPTH_OUTPUT capability does not have to support

     *   normal YUV_420_888, JPEG, and PRIV-format outputs. It only has to support the DEPTH16

     *   format.</li>
@@ -680,6 +705,7 @@ public abstract class CameraMetadata<TKey> { 
     * @see CameraCharacteristics#DEPTH_DEPTH_IS_EXCLUSIVE

     * @see CameraCharacteristics#LENS_FACING

     * @see CameraCharacteristics#LENS_INTRINSIC_CALIBRATION

     * @see CameraCharacteristics#LENS_POSE_REFERENCE

     * @see CameraCharacteristics#LENS_POSE_ROTATION

     * @see CameraCharacteristics#LENS_POSE_TRANSLATION

     * @see CameraCharacteristics#LENS_RADIAL_DISTORTION
@@ -774,6 +800,51 @@ public abstract class CameraMetadata<TKey> { 
     */

    public static final int REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO = 9;



    /**

     * <p>The device supports controls and metadata required for accurate motion tracking for

     * use cases such as augmented reality, electronic image stabilization, and so on.</p>

     * <p>This means this camera device has accurate optical calibration and timestamps relative

     * to the inertial sensors.</p>

     * <p>This capability requires the camera device to support the following:</p>

     * <ul>

     * <li>Capture request templates {@link android.hardware.camera2.CameraDevice#TEMPLATE_MOTION_TRACKING_PREVIEW } and {@link android.hardware.camera2.CameraDevice#TEMPLATE_MOTION_TRACKING_BEST } are defined.</li>

     * <li>The stream configurations listed in {@link android.hardware.camera2.CameraDevice#createCaptureSession } for MOTION_TRACKING are

     *   supported, either at 30 or 60fps maximum frame rate.</li>

     * <li>The following camera characteristics and capture result metadata are provided:<ul>

     * <li>{@link CameraCharacteristics#LENS_INTRINSIC_CALIBRATION android.lens.intrinsicCalibration}</li>

     * <li>{@link CameraCharacteristics#LENS_RADIAL_DISTORTION android.lens.radialDistortion}</li>

     * <li>{@link CameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation}</li>

     * <li>{@link CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation}</li>

     * <li>{@link CameraCharacteristics#LENS_POSE_REFERENCE android.lens.poseReference} with value GYROSCOPE</li>

     * </ul>

     * </li>

     * <li>The {@link CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE android.sensor.info.timestampSource} field has value <code>REALTIME</code>. When compared to

     *   timestamps from the device's gyroscopes, the clock difference for events occuring at

     *   the same actual time instant will be less than 1 ms.</li>

     * <li>The value of the {@link CaptureResult#SENSOR_ROLLING_SHUTTER_SKEW android.sensor.rollingShutterSkew} field is accurate to within 1 ms.</li>

     * <li>The value of {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime} is guaranteed to be available in the

     *   capture result.</li>

     * <li>The {@link CaptureRequest#CONTROL_CAPTURE_INTENT android.control.captureIntent} control supports MOTION_TRACKING to limit maximum

     *   exposure to 20 milliseconds.</li>

     * <li>The stream configurations required for MOTION_TRACKING (listed at {@link android.hardware.camera2.CameraDevice#createCaptureSession }) can operate at least at

     *   30fps; optionally, they can operate at 60fps, and '[60, 60]' is listed in

     *   {@link CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES android.control.aeAvailableTargetFpsRanges}.</li>

     * </ul>

     *

     * @see CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES

     * @see CaptureRequest#CONTROL_CAPTURE_INTENT

     * @see CameraCharacteristics#LENS_INTRINSIC_CALIBRATION

     * @see CameraCharacteristics#LENS_POSE_REFERENCE

     * @see CameraCharacteristics#LENS_POSE_ROTATION

     * @see CameraCharacteristics#LENS_POSE_TRANSLATION

     * @see CameraCharacteristics#LENS_RADIAL_DISTORTION

     * @see CaptureRequest#SENSOR_EXPOSURE_TIME

     * @see CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE

     * @see CaptureResult#SENSOR_ROLLING_SHUTTER_SKEW

     * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES

     */

    public static final int REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING = 10;



    //

    // Enumeration values for CameraCharacteristics#SCALER_CROPPING_TYPE

    //
@@ -1661,6 +1732,16 @@ public abstract class CameraMetadata<TKey> { 
     */

    public static final int CONTROL_CAPTURE_INTENT_MANUAL = 6;



    /**

     * <p>This request is for a motion tracking use case, where

     * the application will use camera and inertial sensor data to

     * locate and track objects in the world.</p>

     * <p>The camera device auto-exposure routine will limit the exposure time

     * of the camera to no more than 20 milliseconds, to minimize motion blur.</p>

     * @see CaptureRequest#CONTROL_CAPTURE_INTENT

     */

    public static final int CONTROL_CAPTURE_INTENT_MOTION_TRACKING = 7;



    //

    // Enumeration values for CaptureRequest#CONTROL_EFFECT_MODE

    //

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

+9 −4
Original line number Diff line number Diff line
@@ -1487,10 +1487,13 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * strategy.</p>

     * <p>This control (except for MANUAL) is only effective if

     * <code>{@link CaptureRequest#CONTROL_MODE android.control.mode} != OFF</code> and any 3A routine is active.</p>

     * <p>ZERO_SHUTTER_LAG will be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities}

     * contains PRIVATE_REPROCESSING or YUV_REPROCESSING. MANUAL will be supported if

     * {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains MANUAL_SENSOR. Other intent values are

     * always supported.</p>

     * <p>All intents are supported by all devices, except that:

     *   * ZERO_SHUTTER_LAG will be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains

     * PRIVATE_REPROCESSING or YUV_REPROCESSING.

     *   * MANUAL will be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains

     * MANUAL_SENSOR.

     *   * MOTION_TRACKING will be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains

     * MOTION_TRACKING.</p>

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

     * <ul>

     *   <li>{@link #CONTROL_CAPTURE_INTENT_CUSTOM CUSTOM}</li>
@@ -1500,6 +1503,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     *   <li>{@link #CONTROL_CAPTURE_INTENT_VIDEO_SNAPSHOT VIDEO_SNAPSHOT}</li>

     *   <li>{@link #CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG ZERO_SHUTTER_LAG}</li>

     *   <li>{@link #CONTROL_CAPTURE_INTENT_MANUAL MANUAL}</li>

     *   <li>{@link #CONTROL_CAPTURE_INTENT_MOTION_TRACKING MOTION_TRACKING}</li>

     * </ul></p>

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

     *
@@ -1512,6 +1516,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * @see #CONTROL_CAPTURE_INTENT_VIDEO_SNAPSHOT

     * @see #CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG

     * @see #CONTROL_CAPTURE_INTENT_MANUAL

     * @see #CONTROL_CAPTURE_INTENT_MOTION_TRACKING

     */

    @PublicKey

    public static final Key<Integer> CONTROL_CAPTURE_INTENT =