Camera2: Misc + enum value documentation updates (e600d6ad) · Commits · e / os / android_frameworks_base

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>