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

Commit 486ed088 authored by Eino-Ville Talvala's avatar Eino-Ville Talvala Committed by Android (Google) Code Review
Browse files

Merge "Camera2: Misc + enum value documentation updates" into lmp-preview-dev

parents 8fe0d0c8 e600d6ad

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

+28 −30
Original line number Diff line number Diff line
@@ -30,7 +30,7 @@ import java.util.List; 
 *

 * <p>These properties are fixed for a given CameraDevice, and can be queried

 * through the {@link CameraManager CameraManager}

 * interface in addition to through the CameraDevice interface.</p>

 * interface with {@link CameraManager#getCameraCharacteristics}.</p>

 *

 * <p>{@link CameraCharacteristics} objects are immutable.</p>

 *
@@ -555,7 +555,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <p>List containing a subset of the optical image

     * stabilization (OIS) modes specified in

     * {@link CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE android.lens.opticalStabilizationMode}.</p>

     * <p>If OIS is not implemented for a given camera device, this should

     * <p>If OIS is not implemented for a given camera device, this will

     * contain only OFF.</p>

     *

     * @see CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE
@@ -612,7 +612,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 


    /**

     * <p>Direction the camera faces relative to

     * device screen</p>

     * device screen.</p>

     * @see #LENS_FACING_FRONT

     * @see #LENS_FACING_BACK

     */
@@ -622,7 +622,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
    /**

     * <p>The set of noise reduction modes supported by this camera device.</p>

     * <p>This tag lists the valid modes for {@link CaptureRequest#NOISE_REDUCTION_MODE android.noiseReduction.mode}.</p>

     * <p>Full-capability camera devices must laways support OFF and FAST.</p>

     * <p>Full-capability camera devices must always support OFF and FAST.</p>

     *

     * @see CaptureRequest#NOISE_REDUCTION_MODE

     */
@@ -778,18 +778,20 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
            new Key<Byte>("android.request.pipelineMaxDepth", byte.class);



    /**

     * <p>Optional. Defaults to 1. Defines how many sub-components

     * <p>Defines how many sub-components

     * a result will be composed of.</p>

     * <p>In order to combat the pipeline latency, partial results

     * may be delivered to the application layer from the camera device as

     * soon as they are available.</p>

     * <p>A value of 1 means that partial results are not supported.</p>

     * <p>Optional; defaults to 1. A value of 1 means that partial

     * results are not supported, and only the final TotalCaptureResult will

     * be produced by the camera device.</p>

     * <p>A typical use case for this might be: after requesting an

     * auto-focus (AF) lock the new AF state might be available 50%

     * of the way through the pipeline.  The camera device could

     * then immediately dispatch this state via a partial result to

     * the framework/application layer, and the rest of the

     * metadata via later partial results.</p>

     * the application, and the rest of the metadata via later

     * partial results.</p>

     */

    public static final Key<Integer> REQUEST_PARTIAL_RESULT_COUNT =

            new Key<Integer>("android.request.partialResultCount", int.class);
@@ -806,8 +808,6 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * to do this query each of android.request.availableRequestKeys,

     * android.request.availableResultKeys,

     * android.request.availableCharacteristicsKeys.</p>

     * <p>XX: Maybe these should go into {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}

     * as a table instead?</p>

     * <p>The following capabilities are guaranteed to be available on

     * {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel} <code>==</code> FULL devices:</p>

     * <ul>
@@ -815,14 +815,11 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <li>MANUAL_POST_PROCESSING</li>

     * </ul>

     * <p>Other capabilities may be available on either FULL or LIMITED

     * devices, but the app. should query this field to be sure.</p>

     * devices, but the application should query this field to be sure.</p>

     *

     * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL

     * @see #REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE

     * @see #REQUEST_AVAILABLE_CAPABILITIES_OPTIONAL

     * @see #REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR

     * @see #REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING

     * @see #REQUEST_AVAILABLE_CAPABILITIES_ZSL

     * @see #REQUEST_AVAILABLE_CAPABILITIES_DNG

     */

    public static final Key<int[]> REQUEST_AVAILABLE_CAPABILITIES =
@@ -838,7 +835,6 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * at a more granular level than capabilities. This is especially

     * important for optional keys that are not listed under any capability

     * in {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities}.</p>

     * <p>TODO: This should be used by #getAvailableCaptureRequestKeys.</p>

     *

     * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES

     * @hide
@@ -863,7 +859,6 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * at a more granular level than capabilities. This is especially

     * important for optional keys that are not listed under any capability

     * in {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities}.</p>

     * <p>TODO: This should be used by #getAvailableCaptureResultKeys.</p>

     *

     * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES

     * @see CaptureRequest#STATISTICS_LENS_SHADING_MAP_MODE
@@ -879,7 +874,6 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * android.request.availableResultKeys (except that it applies for

     * CameraCharacteristics instead of CaptureResult). See above for more

     * details.</p>

     * <p>TODO: This should be used by CameraCharacteristics#getKeys.</p>

     * @hide

     */

    public static final Key<int[]> REQUEST_AVAILABLE_CHARACTERISTICS_KEYS =
@@ -927,10 +921,15 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
            new Key<android.util.Size[]>("android.scaler.availableJpegSizes", android.util.Size[].class);



    /**

     * <p>The maximum ratio between active area width

     * and crop region width, or between active area height and

     * crop region height, if the crop region height is larger

     * than width</p>

     * <p>The maximum ratio between both active area width

     * and crop region width, and active area height and

     * crop region height.</p>

     * <p>This represents the maximum amount of zooming possible by

     * the camera device, or equivalently, the minimum cropping

     * window size.</p>

     * <p>Crop regions that have a width or height that is smaller

     * than this ratio allows will be rounded up to the minimum

     * allowed size by the camera device.</p>

     */

    public static final Key<Float> SCALER_AVAILABLE_MAX_DIGITAL_ZOOM =

            new Key<Float>("android.scaler.availableMaxDigitalZoom", float.class);
@@ -1339,9 +1338,9 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
            new Key<android.util.Range<Integer>>("android.sensor.info.sensitivityRange", new TypeReference<android.util.Range<Integer>>() {{ }});



    /**

     * <p>Arrangement of color filters on sensor;

     * <p>The arrangement of color filters on sensor;

     * represents the colors in the top-left 2x2 section of

     * the sensor, in reading order</p>

     * the sensor, in reading order.</p>

     * @see #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGGB

     * @see #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GRBG

     * @see #SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GBRG
@@ -1666,10 +1665,9 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
            new Key<int[]>("android.sensor.availableTestPatternModes", int[].class);



    /**

     * <p>Which face detection modes are available,

     * if any.</p>

     * <p>OFF means face detection is disabled, it must

     * be included in the list.</p>

     * <p>The face detection modes that are available

     * for this camera device.</p>

     * <p>OFF is always supported.</p>

     * <p>SIMPLE means the device supports the

     * android.statistics.faceRectangles and

     * android.statistics.faceScores outputs.</p>
@@ -1681,8 +1679,8 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
            new Key<int[]>("android.statistics.info.availableFaceDetectModes", int[].class);



    /**

     * <p>Maximum number of simultaneously detectable

     * faces</p>

     * <p>The maximum number of simultaneously detectable

     * faces.</p>

     */

    public static final Key<Integer> STATISTICS_INFO_MAX_FACE_COUNT =

            new Key<Integer>("android.statistics.info.maxFaceCount", int.class);
@@ -1691,7 +1689,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <p>The set of hot pixel map output modes supported by this camera device.</p>

     * <p>This tag lists valid output modes for {@link CaptureRequest#STATISTICS_HOT_PIXEL_MAP_MODE android.statistics.hotPixelMapMode}.</p>

     * <p>If no hotpixel map is available for this camera device, this will contain

     * only OFF.  If the hotpixel map is available, this should include both

     * only OFF.  If the hotpixel map is available, this will include both

     * the ON and OFF options.</p>

     *

     * @see CaptureRequest#STATISTICS_HOT_PIXEL_MAP_MODE

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

+329 −185

File changed.

Preview size limit exceeded, changes collapsed.

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

+58 −30
Original line number Diff line number Diff line
@@ -733,8 +733,16 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * included at all in the request settings. When included and

     * set to START, the camera device will trigger the autoexposure

     * precapture metering sequence.</p>

     * <p>The effect of auto-exposure (AE) precapture trigger depends

     * on the current AE mode and state; see

     * <p>The precapture sequence should triggered before starting a

     * high-quality still capture for final metering decisions to

     * be made, and for firing pre-capture flash pulses to estimate

     * scene brightness and required final capture flash power, when

     * the flash is enabled.</p>

     * <p>Normally, this entry should be set to START for only a

     * single request, and the application should wait until the

     * sequence completes before starting a new one.</p>

     * <p>The exact effect of auto-exposure (AE) precapture trigger

     * depends on the current AE mode and state; see

     * {@link CaptureResult#CONTROL_AE_STATE android.control.aeState} for AE precapture state transition

     * details.</p>

     *
@@ -800,7 +808,11 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * autofocus algorithm. If autofocus is disabled, this trigger has no effect.</p>

     * <p>When set to CANCEL, the camera device will cancel any active trigger,

     * and return to its initial AF state.</p>

     * <p>See {@link CaptureResult#CONTROL_AF_STATE android.control.afState} for what that means for each AF mode.</p>

     * <p>Generally, applications should set this entry to START or CANCEL for only a

     * single capture, and then return it to IDLE (or not set at all). Specifying

     * START for multiple captures in a row means restarting the AF operation over

     * and over again.</p>

     * <p>See {@link CaptureResult#CONTROL_AF_STATE android.control.afState} for what the trigger means for each AF mode.</p>

     *

     * @see CaptureResult#CONTROL_AF_STATE

     * @see #CONTROL_AF_TRIGGER_IDLE
@@ -813,9 +825,11 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    /**

     * <p>Whether auto-white balance (AWB) is currently locked to its

     * latest calculated values.</p>

     * <p>Note that AWB lock is only meaningful for AUTO

     * mode; in other modes, AWB is already fixed to a specific

     * setting.</p>

     * <p>Note that AWB lock is only meaningful when

     * {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode} is in the AUTO mode; in other modes,

     * AWB is already fixed to a specific setting.</p>

     *

     * @see CaptureRequest#CONTROL_AWB_MODE

     */

    public static final Key<Boolean> CONTROL_AWB_LOCK =

            new Key<Boolean>("android.control.awbLock", boolean.class);
@@ -825,17 +839,21 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * transform fields, and what its illumination target

     * is.</p>

     * <p>This control is only effective if {@link CaptureRequest#CONTROL_MODE android.control.mode} is AUTO.</p>

     * <p>When set to the ON mode, the camera device's auto white balance

     * <p>When set to the ON mode, the camera device's auto-white balance

     * routine is enabled, overriding the application's selected

     * {@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}.</p>

     * <p>When set to the OFF mode, the camera device's auto white balance

     * <p>When set to the OFF mode, the camera device's auto-white balance

     * routine is disabled. The application manually controls the white

     * balance by {@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}.</p>

     * <p>When set to any other modes, the camera device's auto white balance

     * routine is disabled. The camera device uses each particular illumination

     * target for white balance adjustment.</p>

     * <p>When set to any other modes, the camera device's auto-white

     * balance routine is disabled. The camera device uses each

     * particular illumination target for white balance

     * adjustment. The application's values for

     * {@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.</p>

     *

     * @see CaptureRequest#COLOR_CORRECTION_GAINS

     * @see CaptureRequest#COLOR_CORRECTION_MODE
@@ -886,8 +904,8 @@ 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 must be supported if {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities}

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

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

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

     * contains MANUAL_SENSOR.</p>

     *

     * @see CaptureRequest#CONTROL_MODE
@@ -962,7 +980,9 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * <p>This is the mode that that is active when

     * <code>{@link CaptureRequest#CONTROL_MODE android.control.mode} == USE_SCENE_MODE</code>. Aside from FACE_PRIORITY,

     * these modes will disable {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode},

     * {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode}, and {@link CaptureRequest#CONTROL_AF_MODE android.control.afMode} while in use.</p>

     * {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode}, and {@link CaptureRequest#CONTROL_AF_MODE android.control.afMode} while in use.

     * The scene modes available for a given camera device are listed in

     * {@link CameraCharacteristics#CONTROL_AVAILABLE_SCENE_MODES android.control.availableSceneModes}.</p>

     * <p>The interpretation and implementation of these scene modes is left

     * to the implementor of the camera device. Their behavior will not be

     * consistent across all devices, and any given device may only implement
@@ -970,6 +990,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     *

     * @see CaptureRequest#CONTROL_AE_MODE

     * @see CaptureRequest#CONTROL_AF_MODE

     * @see CameraCharacteristics#CONTROL_AVAILABLE_SCENE_MODES

     * @see CaptureRequest#CONTROL_AWB_MODE

     * @see CaptureRequest#CONTROL_MODE

     * @see #CONTROL_SCENE_MODE_DISABLED
@@ -996,6 +1017,8 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    /**

     * <p>Whether video stabilization is

     * active.</p>

     * <p>Video stabilization automatically translates and scales images from the camera

     * in order to stabilize motion between consecutive frames.</p>

     * <p>If enabled, video stabilization can modify the

     * {@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion} to keep the video stream

     * stabilized</p>
@@ -1110,14 +1133,14 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    /**

     * <p>Compression quality of the final JPEG

     * image.</p>

     * <p>85-95 is typical usage range</p>

     * <p>85-95 is typical usage range.</p>

     */

    public static final Key<Byte> JPEG_QUALITY =

            new Key<Byte>("android.jpeg.quality", byte.class);



    /**

     * <p>Compression quality of JPEG

     * thumbnail</p>

     * thumbnail.</p>

     */

    public static final Key<Byte> JPEG_THUMBNAIL_QUALITY =

            new Key<Byte>("android.jpeg.thumbnailQuality", byte.class);
@@ -1229,12 +1252,18 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    /**

     * <p>Sets whether the camera device uses optical image stabilization (OIS)

     * when capturing images.</p>

     * <p>OIS is used to compensate for motion blur due to small movements of

     * the camera during capture. Unlike digital image stabilization, OIS makes

     * use of mechanical elements to stabilize the camera sensor, and thus

     * allows for longer exposure times before camera shake becomes

     * apparent.</p>

     * <p>This is not expected to be supported on most devices.</p>

     * <p>OIS is used to compensate for motion blur due to small

     * movements of the camera during capture. Unlike digital image

     * stabilization ({@link CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE android.control.videoStabilizationMode}), OIS

     * makes use of mechanical elements to stabilize the camera

     * sensor, and thus allows for longer exposure times before

     * camera shake becomes apparent.</p>

     * <p>Not all devices will support OIS; see

     * {@link CameraCharacteristics#LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION android.lens.info.availableOpticalStabilization} for

     * available controls.</p>

     *

     * @see CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE

     * @see CameraCharacteristics#LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION

     * @see #LENS_OPTICAL_STABILIZATION_MODE_OFF

     * @see #LENS_OPTICAL_STABILIZATION_MODE_ON

     */
@@ -1242,16 +1271,15 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
            new Key<Integer>("android.lens.opticalStabilizationMode", int.class);



    /**

     * <p>Mode of operation for the noise reduction.

     * algorithm</p>

     * <p>Mode of operation for the noise reduction algorithm.</p>

     * <p>Noise filtering control. OFF means no noise reduction

     * will be applied by the camera device.</p>

     * <p>This must be set to a valid mode in

     * <p>This must be set to a valid mode from

     * {@link CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES android.noiseReduction.availableNoiseReductionModes}.</p>

     * <p>FAST/HIGH_QUALITY both mean camera device determined noise filtering

     * will be applied. HIGH_QUALITY mode indicates that the camera device

     * will use the highest-quality noise filtering algorithms,

     * even if it slows down capture rate. FAST means the camera device should not

     * even if it slows down capture rate. FAST means the camera device will not

     * slow down capture rate when applying noise filtering.</p>

     *

     * @see CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES
@@ -1435,7 +1463,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * <p>When enabled, the sensor sends a test pattern instead of

     * doing a real exposure from the camera.</p>

     * <p>When a test pattern is enabled, all manual sensor controls specified

     * by android.sensor.* should be ignored. All other controls should

     * by android.sensor.* will be ignored. All other controls should

     * work as normal.</p>

     * <p>For example, if manual flash is enabled, flash firing should still

     * occur (and that the test pattern remain unmodified, since the flash
@@ -1490,7 +1518,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
            new Key<Integer>("android.shading.mode", int.class);



    /**

     * <p>State of the face detector

     * <p>Control for the face detector

     * unit.</p>

     * <p>Whether face detection is enabled, and whether it

     * should output just the basic fields or the full set of
@@ -1508,7 +1536,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
    /**

     * <p>Operating mode for hotpixel map generation.</p>

     * <p>If set to ON, a hotpixel map is returned in {@link CaptureResult#STATISTICS_HOT_PIXEL_MAP android.statistics.hotPixelMap}.

     * If set to OFF, no hotpixel map should be returned.</p>

     * If set to OFF, no hotpixel map will be returned.</p>

     * <p>This must be set to a valid mode from {@link CameraCharacteristics#STATISTICS_INFO_AVAILABLE_HOT_PIXEL_MAP_MODES android.statistics.info.availableHotPixelMapModes}.</p>

     *

     * @see CaptureResult#STATISTICS_HOT_PIXEL_MAP
@@ -1521,7 +1549,7 @@ public final class CaptureRequest extends CameraMetadata<CaptureRequest.Key<?>> 
     * <p>Whether the camera device will output the lens

     * shading map in output result metadata.</p>

     * <p>When set to ON,

     * android.statistics.lensShadingMap must be provided in

     * android.statistics.lensShadingMap will be provided in

     * the output result metadata.</p>

     * @see #STATISTICS_LENS_SHADING_MAP_MODE_OFF

     * @see #STATISTICS_LENS_SHADING_MAP_MODE_ON

core/java/android/hardware/camera2/CaptureResult.java

+96 −52

File changed.

Preview size limit exceeded, changes collapsed.

core/java/android/hardware/camera2/params/StreamConfiguration.java

+2 −1
Original line number Diff line number Diff line
@@ -30,7 +30,8 @@ import android.util.Size; 
 * Immutable class to store the available stream

 * {@link CameraCharacteristics#SCALER_AVAILABLE_STREAM_CONFIGURATIONS configurations} to set up

 * {@link android.view.Surface Surfaces} for creating a {@link CameraCaptureSession capture session}

 * with {@link CameraDevice#createCaptureSession}.  <!-- TODO: link to input stream configuration -->

 * with {@link CameraDevice#createCaptureSession}.

 * <!-- TODO: link to input stream configuration -->

 *

 * <p>This is the authoritative list for all input/output formats (and sizes respectively

 * for that format) that are supported by a camera device.</p>