Merge "Camera2: Misc + enum value documentation updates" into lmp-preview-dev
This commit is contained in:
Eino-Ville Talvala
committed by
Android (Google) Code Review
Android (Google) Code Review
commit
486ed08899
@@ -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
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -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
|
||||
|
||||
@@ -579,8 +579,16 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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>
|
||||
*
|
||||
@@ -592,7 +600,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
new Key<Integer>("android.control.aePrecaptureTrigger", int.class);
|
||||
|
||||
/**
|
||||
* <p>Current state of auto-exposure (AE) algorithm.</p>
|
||||
* <p>Current state of the auto-exposure (AE) algorithm.</p>
|
||||
* <p>Switching between or enabling AE modes ({@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode}) always
|
||||
* resets the AE state to INACTIVE. Similarly, switching between {@link CaptureRequest#CONTROL_MODE android.control.mode},
|
||||
* or {@link CaptureRequest#CONTROL_SCENE_MODE android.control.sceneMode} if <code>{@link CaptureRequest#CONTROL_MODE android.control.mode} == USE_SCENE_MODE</code> resets all
|
||||
@@ -844,7 +852,11 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -1034,13 +1046,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
* <td align="center">PASSIVE_SCAN</td>
|
||||
* <td align="center">AF_TRIGGER</td>
|
||||
* <td align="center">FOCUSED_LOCKED</td>
|
||||
* <td align="center">Immediate trans. If focus is good, Lens now locked</td>
|
||||
* <td align="center">Immediate transition, if focus is good. Lens now locked</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td align="center">PASSIVE_SCAN</td>
|
||||
* <td align="center">AF_TRIGGER</td>
|
||||
* <td align="center">NOT_FOCUSED_LOCKED</td>
|
||||
* <td align="center">Immediate trans. if focus is bad, Lens now locked</td>
|
||||
* <td align="center">Immediate transition, if focus is bad. Lens now locked</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td align="center">PASSIVE_SCAN</td>
|
||||
@@ -1064,13 +1076,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
* <td align="center">PASSIVE_FOCUSED</td>
|
||||
* <td align="center">AF_TRIGGER</td>
|
||||
* <td align="center">FOCUSED_LOCKED</td>
|
||||
* <td align="center">Immediate trans. Lens now locked</td>
|
||||
* <td align="center">Immediate transition, lens now locked</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td align="center">PASSIVE_UNFOCUSED</td>
|
||||
* <td align="center">AF_TRIGGER</td>
|
||||
* <td align="center">NOT_FOCUSED_LOCKED</td>
|
||||
* <td align="center">Immediate trans. Lens now locked</td>
|
||||
* <td align="center">Immediate transition, lens now locked</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td align="center">FOCUSED_LOCKED</td>
|
||||
@@ -1137,13 +1149,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
* <td align="center">PASSIVE_SCAN</td>
|
||||
* <td align="center">AF_TRIGGER</td>
|
||||
* <td align="center">FOCUSED_LOCKED</td>
|
||||
* <td align="center">Eventual trans. once focus good, Lens now locked</td>
|
||||
* <td align="center">Eventual transition once the focus is good. Lens now locked</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td align="center">PASSIVE_SCAN</td>
|
||||
* <td align="center">AF_TRIGGER</td>
|
||||
* <td align="center">NOT_FOCUSED_LOCKED</td>
|
||||
* <td align="center">Eventual trans. if cannot focus, Lens now locked</td>
|
||||
* <td align="center">Eventual transition if cannot find focus. Lens now locked</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td align="center">PASSIVE_SCAN</td>
|
||||
@@ -1254,9 +1266,11 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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);
|
||||
@@ -1266,17 +1280,21 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -1327,8 +1345,8 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -1533,7 +1551,9 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -1541,6 +1561,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -1567,6 +1588,8 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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>
|
||||
@@ -1698,14 +1721,14 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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);
|
||||
@@ -1817,12 +1840,18 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
*/
|
||||
@@ -1866,16 +1895,15 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
new Key<Integer>("android.lens.state", 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
|
||||
@@ -2170,7 +2198,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -2225,7 +2253,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -2241,9 +2269,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
new Key<Integer>("android.statistics.faceDetectMode", int.class);
|
||||
|
||||
/**
|
||||
* <p>List of unique IDs for detected
|
||||
* faces</p>
|
||||
* <p>Only available if faceDetectMode == FULL</p>
|
||||
* <p>List of unique IDs for detected faces.</p>
|
||||
* <p>Each detected face is given a unique ID that is valid for as long as the face is visible
|
||||
* to the camera device. A face that leaves the field of view and later returns may be
|
||||
* assigned a new ID.</p>
|
||||
* <p>Only available if {@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode} == FULL</p>
|
||||
*
|
||||
* @see CaptureRequest#STATISTICS_FACE_DETECT_MODE
|
||||
* @hide
|
||||
*/
|
||||
public static final Key<int[]> STATISTICS_FACE_IDS =
|
||||
@@ -2251,8 +2283,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
|
||||
/**
|
||||
* <p>List of landmarks for detected
|
||||
* faces</p>
|
||||
* <p>Only available if faceDetectMode == FULL</p>
|
||||
* faces.</p>
|
||||
* <p>The coordinate system is 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>Only available if {@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode} == FULL</p>
|
||||
*
|
||||
* @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE
|
||||
* @see CaptureRequest#STATISTICS_FACE_DETECT_MODE
|
||||
* @hide
|
||||
*/
|
||||
public static final Key<int[]> STATISTICS_FACE_LANDMARKS =
|
||||
@@ -2260,8 +2297,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
|
||||
/**
|
||||
* <p>List of the bounding rectangles for detected
|
||||
* faces</p>
|
||||
* <p>Only available if faceDetectMode != OFF</p>
|
||||
* faces.</p>
|
||||
* <p>The coordinate system is 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>Only available if {@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode} != OFF</p>
|
||||
*
|
||||
* @see CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE
|
||||
* @see CaptureRequest#STATISTICS_FACE_DETECT_MODE
|
||||
* @hide
|
||||
*/
|
||||
public static final Key<android.graphics.Rect[]> STATISTICS_FACE_RECTANGLES =
|
||||
@@ -2270,8 +2312,9 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
/**
|
||||
* <p>List of the face confidence scores for
|
||||
* detected faces</p>
|
||||
* <p>Only available if faceDetectMode != OFF. The value should be
|
||||
* meaningful (for example, setting 100 at all times is illegal).</p>
|
||||
* <p>Only available if {@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode} != OFF.</p>
|
||||
*
|
||||
* @see CaptureRequest#STATISTICS_FACE_DETECT_MODE
|
||||
* @hide
|
||||
*/
|
||||
public static final Key<byte[]> STATISTICS_FACE_SCORES =
|
||||
@@ -2435,12 +2478,13 @@ public class CaptureResult extends CameraMetadata<CaptureResult.Key<?>> {
|
||||
* The camera device uses this entry to tell the application what the scene
|
||||
* illuminant frequency is.</p>
|
||||
* <p>When manual exposure control is enabled
|
||||
* (<code>{@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} == OFF</code> or <code>{@link CaptureRequest#CONTROL_MODE android.control.mode} == OFF</code>),
|
||||
* the {@link CaptureRequest#CONTROL_AE_ANTIBANDING_MODE android.control.aeAntibandingMode} doesn't do the antibanding, and the
|
||||
* application can ensure it selects exposure times that do not cause banding
|
||||
* issues by looking into this metadata field. See {@link CaptureRequest#CONTROL_AE_ANTIBANDING_MODE android.control.aeAntibandingMode}
|
||||
* for more details.</p>
|
||||
* <p>Report NONE if there doesn't appear to be flickering illumination.</p>
|
||||
* (<code>{@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} == OFF</code> or <code>{@link CaptureRequest#CONTROL_MODE android.control.mode} ==
|
||||
* OFF</code>), the {@link CaptureRequest#CONTROL_AE_ANTIBANDING_MODE android.control.aeAntibandingMode} doesn't perform
|
||||
* antibanding, and the application can ensure it selects
|
||||
* exposure times that do not cause banding issues by looking
|
||||
* into this metadata field. See
|
||||
* {@link CaptureRequest#CONTROL_AE_ANTIBANDING_MODE android.control.aeAntibandingMode} for more details.</p>
|
||||
* <p>Reports NONE if there doesn't appear to be flickering illumination.</p>
|
||||
*
|
||||
* @see CaptureRequest#CONTROL_AE_ANTIBANDING_MODE
|
||||
* @see CaptureRequest#CONTROL_AE_MODE
|
||||
@@ -2455,7 +2499,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
@@ -2483,7 +2527,7 @@ public class CaptureResult extends CameraMetadata<CaptureResult.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
|
||||
|
||||
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user