Skip to content

Most visited

Recently visited

navigation

TotalCaptureResult

public final class TotalCaptureResult
extends CaptureResult

java.lang.Object
   ↳ android.hardware.camera2.CameraMetadata<android.hardware.camera2.CaptureResult.Key<?>>
     ↳ android.hardware.camera2.CaptureResult
       ↳ android.hardware.camera2.TotalCaptureResult


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 getAvailableCaptureResultKeys() are available (that is get(CaptureResult.Key) will return non-null, if and only if that key that was enabled by the request. A few keys such as STATISTICS_FACES are disabled by default unless enabled with a switch (such as STATISTICS_FACE_DETECT_MODE). Refer to each key documentation on a case-by-case basis.

For a logical multi-camera device, if the CaptureRequest contains a surface for an underlying physical camera, the corresponding TotalCaptureResult object will include the metadata for that physical camera. And the mapping between the physical camera id and result metadata can be accessed via getPhysicalCameraResults(). If all requested surfaces are for the logical camera, no metadata for physical camera will be included.

TotalCaptureResult objects are immutable.

See also:

Summary

Inherited constants

Inherited fields

Public methods

List<CaptureResult> getPartialResults()

Get the read-only list of partial results that compose this total result.

Map<StringCaptureResult> getPhysicalCameraResults()

Get the map between physical camera ids and their capture result metadata

This function can be called for logical multi-camera devices, which are devices that have REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA capability and calls to getPhysicalCameraIds() return a non-empty list of physical devices that are backing the logical camera.

Inherited methods

Public methods

getPartialResults

added in API level 21
List<CaptureResult> getPartialResults ()

Get the read-only list of partial results that compose this total result.

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 REQUEST_PARTIAL_RESULT_COUNT, with elements in ascending order of when onCaptureProgressed(CameraCaptureSession, CaptureRequest, CaptureResult) was invoked.

Returns
List<CaptureResult> unmodifiable list of partial results

This value will never be null.

getPhysicalCameraResults

Map<StringCaptureResult> getPhysicalCameraResults ()

Get the map between physical camera ids and their capture result metadata

This function can be called for logical multi-camera devices, which are devices that have REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA capability and calls to getPhysicalCameraIds() return a non-empty list of physical devices that are backing the logical camera.

If one or more streams from the underlying physical cameras were requested by the corresponding capture request, this function returns the result metadata for those physical cameras. Otherwise, an empty map is returned.

Returns
Map<StringCaptureResult> unmodifiable map between physical camera ids and their capture result metadata

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)