public final class TotalCaptureResult extends CaptureResult
The total assembled results of a single image capture from the image sensor.
Contains the final configuration for the capture hardware (sensor, lens, flash), the processing pipeline, the control algorithms, and the output buffers.
A TotalCaptureResult
is produced by a CameraDevice
after processing a
CaptureRequest
. All properties listed for capture requests can also
be queried on the capture result, to determine the final values used for
capture. The result also includes additional metadata about the state of the
camera device during the capture.
All properties returned by CameraCharacteristics.getAvailableCaptureResultKeys()
are available (that is CaptureResult.get(android.hardware.camera2.CaptureResult.Key<T>)
will return non-null
, if and only if
that key that was enabled by the request. A few keys such as
CaptureResult.STATISTICS_FACES
are disabled by default unless enabled with a switch (such
as CaptureRequest.STATISTICS_FACE_DETECT_MODE
). Refer to each key documentation on
a case-by-case basis.
TotalCaptureResult
objects are immutable.
CameraDevice.CaptureCallback#onCaptureCompleted
CaptureResult.Key<T>
BLACK_LEVEL_LOCK, COLOR_CORRECTION_ABERRATION_MODE, COLOR_CORRECTION_GAINS, COLOR_CORRECTION_MODE, COLOR_CORRECTION_TRANSFORM, CONTROL_AE_ANTIBANDING_MODE, CONTROL_AE_EXPOSURE_COMPENSATION, CONTROL_AE_LOCK, CONTROL_AE_MODE, CONTROL_AE_PRECAPTURE_TRIGGER, CONTROL_AE_REGIONS, CONTROL_AE_STATE, CONTROL_AE_TARGET_FPS_RANGE, CONTROL_AF_MODE, CONTROL_AF_REGIONS, CONTROL_AF_STATE, CONTROL_AF_TRIGGER, CONTROL_AWB_LOCK, CONTROL_AWB_MODE, CONTROL_AWB_REGIONS, CONTROL_AWB_STATE, CONTROL_CAPTURE_INTENT, CONTROL_EFFECT_MODE, CONTROL_MODE, CONTROL_POST_RAW_SENSITIVITY_BOOST, CONTROL_SCENE_MODE, CONTROL_VIDEO_STABILIZATION_MODE, EDGE_MODE, FLASH_MODE, FLASH_STATE, HOT_PIXEL_MODE, JPEG_GPS_COORDINATES, JPEG_GPS_LOCATION, JPEG_GPS_PROCESSING_METHOD, JPEG_GPS_TIMESTAMP, JPEG_ORIENTATION, JPEG_QUALITY, JPEG_THUMBNAIL_QUALITY, JPEG_THUMBNAIL_SIZE, LED_TRANSMIT, LENS_APERTURE, LENS_FILTER_DENSITY, LENS_FOCAL_LENGTH, LENS_FOCUS_DISTANCE, LENS_FOCUS_RANGE, LENS_INTRINSIC_CALIBRATION, LENS_OPTICAL_STABILIZATION_MODE, LENS_POSE_ROTATION, LENS_POSE_TRANSLATION, LENS_RADIAL_DISTORTION, LENS_STATE, NOISE_REDUCTION_MODE, QUIRKS_PARTIAL_RESULT, REPROCESS_EFFECTIVE_EXPOSURE_FACTOR, REQUEST_FRAME_COUNT, REQUEST_ID, REQUEST_PIPELINE_DEPTH, SCALER_CROP_REGION, SENSOR_DYNAMIC_BLACK_LEVEL, SENSOR_DYNAMIC_WHITE_LEVEL, SENSOR_EXPOSURE_TIME, SENSOR_FRAME_DURATION, SENSOR_GREEN_SPLIT, SENSOR_NEUTRAL_COLOR_POINT, SENSOR_NOISE_PROFILE, SENSOR_ROLLING_SHUTTER_SKEW, SENSOR_SENSITIVITY, SENSOR_TEST_PATTERN_DATA, SENSOR_TEST_PATTERN_MODE, SENSOR_TIMESTAMP, SHADING_MODE, STATISTICS_FACE_DETECT_MODE, STATISTICS_FACE_IDS, STATISTICS_FACE_LANDMARKS, STATISTICS_FACE_RECTANGLES, STATISTICS_FACE_SCORES, STATISTICS_FACES, STATISTICS_HOT_PIXEL_MAP, STATISTICS_HOT_PIXEL_MAP_MODE, STATISTICS_LENS_SHADING_CORRECTION_MAP, STATISTICS_LENS_SHADING_MAP, STATISTICS_LENS_SHADING_MAP_MODE, STATISTICS_PREDICTED_COLOR_GAINS, STATISTICS_PREDICTED_COLOR_TRANSFORM, STATISTICS_SCENE_FLICKER, SYNC_FRAME_NUMBER, TONEMAP_CURVE, TONEMAP_CURVE_BLUE, TONEMAP_CURVE_GREEN, TONEMAP_CURVE_RED, TONEMAP_GAMMA, TONEMAP_MODE, TONEMAP_PRESET_CURVE
COLOR_CORRECTION_ABERRATION_MODE_FAST, COLOR_CORRECTION_ABERRATION_MODE_HIGH_QUALITY, COLOR_CORRECTION_ABERRATION_MODE_OFF, COLOR_CORRECTION_MODE_FAST, COLOR_CORRECTION_MODE_HIGH_QUALITY, COLOR_CORRECTION_MODE_TRANSFORM_MATRIX, CONTROL_AE_ANTIBANDING_MODE_50HZ, CONTROL_AE_ANTIBANDING_MODE_60HZ, CONTROL_AE_ANTIBANDING_MODE_AUTO, CONTROL_AE_ANTIBANDING_MODE_OFF, CONTROL_AE_MODE_OFF, CONTROL_AE_MODE_ON, CONTROL_AE_MODE_ON_ALWAYS_FLASH, CONTROL_AE_MODE_ON_AUTO_FLASH, CONTROL_AE_MODE_ON_AUTO_FLASH_REDEYE, CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL, CONTROL_AE_PRECAPTURE_TRIGGER_IDLE, CONTROL_AE_PRECAPTURE_TRIGGER_START, CONTROL_AE_STATE_CONVERGED, CONTROL_AE_STATE_FLASH_REQUIRED, CONTROL_AE_STATE_INACTIVE, CONTROL_AE_STATE_LOCKED, CONTROL_AE_STATE_PRECAPTURE, CONTROL_AE_STATE_SEARCHING, CONTROL_AF_MODE_AUTO, CONTROL_AF_MODE_CONTINUOUS_PICTURE, CONTROL_AF_MODE_CONTINUOUS_VIDEO, CONTROL_AF_MODE_EDOF, CONTROL_AF_MODE_MACRO, CONTROL_AF_MODE_OFF, CONTROL_AF_STATE_ACTIVE_SCAN, CONTROL_AF_STATE_FOCUSED_LOCKED, CONTROL_AF_STATE_INACTIVE, CONTROL_AF_STATE_NOT_FOCUSED_LOCKED, CONTROL_AF_STATE_PASSIVE_FOCUSED, CONTROL_AF_STATE_PASSIVE_SCAN, CONTROL_AF_STATE_PASSIVE_UNFOCUSED, CONTROL_AF_TRIGGER_CANCEL, CONTROL_AF_TRIGGER_IDLE, CONTROL_AF_TRIGGER_START, CONTROL_AWB_MODE_AUTO, CONTROL_AWB_MODE_CLOUDY_DAYLIGHT, CONTROL_AWB_MODE_DAYLIGHT, CONTROL_AWB_MODE_FLUORESCENT, CONTROL_AWB_MODE_INCANDESCENT, CONTROL_AWB_MODE_OFF, CONTROL_AWB_MODE_SHADE, CONTROL_AWB_MODE_TWILIGHT, CONTROL_AWB_MODE_WARM_FLUORESCENT, CONTROL_AWB_STATE_CONVERGED, CONTROL_AWB_STATE_INACTIVE, CONTROL_AWB_STATE_LOCKED, CONTROL_AWB_STATE_SEARCHING, CONTROL_CAPTURE_INTENT_CUSTOM, CONTROL_CAPTURE_INTENT_MANUAL, CONTROL_CAPTURE_INTENT_PREVIEW, CONTROL_CAPTURE_INTENT_STILL_CAPTURE, CONTROL_CAPTURE_INTENT_VIDEO_RECORD, CONTROL_CAPTURE_INTENT_VIDEO_SNAPSHOT, CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG, CONTROL_EFFECT_MODE_AQUA, CONTROL_EFFECT_MODE_BLACKBOARD, CONTROL_EFFECT_MODE_MONO, CONTROL_EFFECT_MODE_NEGATIVE, CONTROL_EFFECT_MODE_OFF, CONTROL_EFFECT_MODE_POSTERIZE, CONTROL_EFFECT_MODE_SEPIA, CONTROL_EFFECT_MODE_SOLARIZE, CONTROL_EFFECT_MODE_WHITEBOARD, CONTROL_MODE_AUTO, CONTROL_MODE_OFF, CONTROL_MODE_OFF_KEEP_STATE, CONTROL_MODE_USE_SCENE_MODE, CONTROL_SCENE_MODE_ACTION, CONTROL_SCENE_MODE_BARCODE, CONTROL_SCENE_MODE_BEACH, CONTROL_SCENE_MODE_CANDLELIGHT, CONTROL_SCENE_MODE_DEVICE_CUSTOM_END, CONTROL_SCENE_MODE_DEVICE_CUSTOM_START, CONTROL_SCENE_MODE_DISABLED, CONTROL_SCENE_MODE_FACE_PRIORITY, CONTROL_SCENE_MODE_FACE_PRIORITY_LOW_LIGHT, CONTROL_SCENE_MODE_FIREWORKS, CONTROL_SCENE_MODE_HDR, CONTROL_SCENE_MODE_HIGH_SPEED_VIDEO, CONTROL_SCENE_MODE_LANDSCAPE, CONTROL_SCENE_MODE_NIGHT, CONTROL_SCENE_MODE_NIGHT_PORTRAIT, CONTROL_SCENE_MODE_PARTY, CONTROL_SCENE_MODE_PORTRAIT, CONTROL_SCENE_MODE_SNOW, CONTROL_SCENE_MODE_SPORTS, CONTROL_SCENE_MODE_STEADYPHOTO, CONTROL_SCENE_MODE_SUNSET, CONTROL_SCENE_MODE_THEATRE, CONTROL_VIDEO_STABILIZATION_MODE_OFF, CONTROL_VIDEO_STABILIZATION_MODE_ON, EDGE_MODE_FAST, EDGE_MODE_HIGH_QUALITY, EDGE_MODE_OFF, EDGE_MODE_ZERO_SHUTTER_LAG, FLASH_MODE_OFF, FLASH_MODE_SINGLE, FLASH_MODE_TORCH, FLASH_STATE_CHARGING, FLASH_STATE_FIRED, FLASH_STATE_PARTIAL, FLASH_STATE_READY, FLASH_STATE_UNAVAILABLE, HOT_PIXEL_MODE_FAST, HOT_PIXEL_MODE_HIGH_QUALITY, HOT_PIXEL_MODE_OFF, INFO_SUPPORTED_HARDWARE_LEVEL_3, INFO_SUPPORTED_HARDWARE_LEVEL_FULL, INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY, INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED, LED_AVAILABLE_LEDS_TRANSMIT, LENS_FACING_BACK, LENS_FACING_EXTERNAL, LENS_FACING_FRONT, LENS_INFO_FOCUS_DISTANCE_CALIBRATION_APPROXIMATE, LENS_INFO_FOCUS_DISTANCE_CALIBRATION_CALIBRATED, LENS_INFO_FOCUS_DISTANCE_CALIBRATION_UNCALIBRATED, LENS_OPTICAL_STABILIZATION_MODE_OFF, LENS_OPTICAL_STABILIZATION_MODE_ON, LENS_STATE_MOVING, LENS_STATE_STATIONARY, NOISE_REDUCTION_MODE_FAST, NOISE_REDUCTION_MODE_HIGH_QUALITY, NOISE_REDUCTION_MODE_MINIMAL, NOISE_REDUCTION_MODE_OFF, NOISE_REDUCTION_MODE_ZERO_SHUTTER_LAG, REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE, REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE, REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO, REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT, REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING, REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR, REQUEST_AVAILABLE_CAPABILITIES_PRIVATE_REPROCESSING, REQUEST_AVAILABLE_CAPABILITIES_RAW, REQUEST_AVAILABLE_CAPABILITIES_READ_SENSOR_SETTINGS, REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING, SCALER_CROPPING_TYPE_CENTER_ONLY, SCALER_CROPPING_TYPE_FREEFORM, SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_BGGR, SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GBRG, SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GRBG, SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGB, SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGGB, SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME, SENSOR_INFO_TIMESTAMP_SOURCE_UNKNOWN, SENSOR_REFERENCE_ILLUMINANT1_CLOUDY_WEATHER, SENSOR_REFERENCE_ILLUMINANT1_COOL_WHITE_FLUORESCENT, SENSOR_REFERENCE_ILLUMINANT1_D50, SENSOR_REFERENCE_ILLUMINANT1_D55, SENSOR_REFERENCE_ILLUMINANT1_D65, SENSOR_REFERENCE_ILLUMINANT1_D75, SENSOR_REFERENCE_ILLUMINANT1_DAY_WHITE_FLUORESCENT, SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT, SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT_FLUORESCENT, SENSOR_REFERENCE_ILLUMINANT1_FINE_WEATHER, SENSOR_REFERENCE_ILLUMINANT1_FLASH, SENSOR_REFERENCE_ILLUMINANT1_FLUORESCENT, SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN, SENSOR_REFERENCE_ILLUMINANT1_SHADE, SENSOR_REFERENCE_ILLUMINANT1_STANDARD_A, SENSOR_REFERENCE_ILLUMINANT1_STANDARD_B, SENSOR_REFERENCE_ILLUMINANT1_STANDARD_C, SENSOR_REFERENCE_ILLUMINANT1_TUNGSTEN, SENSOR_REFERENCE_ILLUMINANT1_WHITE_FLUORESCENT, SENSOR_TEST_PATTERN_MODE_COLOR_BARS, SENSOR_TEST_PATTERN_MODE_COLOR_BARS_FADE_TO_GRAY, SENSOR_TEST_PATTERN_MODE_CUSTOM1, SENSOR_TEST_PATTERN_MODE_OFF, SENSOR_TEST_PATTERN_MODE_PN9, SENSOR_TEST_PATTERN_MODE_SOLID_COLOR, SHADING_MODE_FAST, SHADING_MODE_HIGH_QUALITY, SHADING_MODE_OFF, STATISTICS_FACE_DETECT_MODE_FULL, STATISTICS_FACE_DETECT_MODE_OFF, STATISTICS_FACE_DETECT_MODE_SIMPLE, STATISTICS_LENS_SHADING_MAP_MODE_OFF, STATISTICS_LENS_SHADING_MAP_MODE_ON, STATISTICS_SCENE_FLICKER_50HZ, STATISTICS_SCENE_FLICKER_60HZ, STATISTICS_SCENE_FLICKER_NONE, SYNC_FRAME_NUMBER_CONVERGING, SYNC_FRAME_NUMBER_UNKNOWN, SYNC_MAX_LATENCY_PER_FRAME_CONTROL, SYNC_MAX_LATENCY_UNKNOWN, TONEMAP_MODE_CONTRAST_CURVE, TONEMAP_MODE_FAST, TONEMAP_MODE_GAMMA_VALUE, TONEMAP_MODE_HIGH_QUALITY, TONEMAP_MODE_PRESET_CURVE, TONEMAP_PRESET_CURVE_REC709, TONEMAP_PRESET_CURVE_SRGB
Constructor and Description |
---|
TotalCaptureResult(CameraMetadataNative results,
CaptureRequest parent,
CaptureResultExtras extras,
List<CaptureResult> partials,
int sessionId)
Takes ownership of the passed-in camera metadata and the partial results
|
TotalCaptureResult(CameraMetadataNative results,
int sequenceId)
Creates a request-less result.
|
Modifier and Type | Method and Description |
---|---|
List<CaptureResult> |
getPartialResults()
Get the read-only list of partial results that compose this total result.
|
int |
getSessionId()
Get the ID of the session where the capture request of this result was submitted.
|
dumpToLog, get, getFrameNumber, getKeyClass, getKeys, getNativeCopy, getProtected, getRequest, getSequenceId
public TotalCaptureResult(CameraMetadataNative results, CaptureRequest parent, CaptureResultExtras extras, List<CaptureResult> partials, int sessionId)
partials
- a list of partial results; null
will be substituted for an empty listpublic TotalCaptureResult(CameraMetadataNative results, int sequenceId)
For testing only.
public List<CaptureResult> getPartialResults()
The list is returned is unmodifiable; attempting to modify it will result in a
UnsupportedOperationException
being thrown.
The list size will be inclusive between 0
and
CameraCharacteristics.REQUEST_PARTIAL_RESULT_COUNT
, with elements in ascending order
of when CameraCaptureSession.CaptureCallback.onCaptureProgressed(android.hardware.camera2.CameraCaptureSession, android.hardware.camera2.CaptureRequest, android.hardware.camera2.CaptureResult)
was invoked.
public int getSessionId()