Java android.hardware.camera2 CaptureResult fields, constructors, methods, implement or subclass

Example usage for Java android.hardware.camera2 CaptureResult fields, constructors, methods, implement or subclass

Introduction

In this page you can find the methods, fields and constructors for android.hardware.camera2 CaptureResult.

The text is from its open source code.

Field

KeyCONTROL_AE_STATE

Current state of the auto-exposure (AE) algorithm.

Switching between or enabling AE modes ( CaptureRequest#CONTROL_AE_MODE android.control.aeMode ) always resets the AE state to INACTIVE.

KeyCONTROL_AF_STATE

Current state of auto-focus (AF) algorithm.

Switching between or enabling AF modes ( CaptureRequest#CONTROL_AF_MODE android.control.afMode ) always resets the AF state to INACTIVE.

KeyCONTROL_AWB_MODE

Whether auto-white balance (AWB) is currently setting the color transform fields, and what its illumination target is.

This control is only effective if CaptureRequest#CONTROL_MODE android.control.mode is AUTO.

When set to the ON mode, the camera device's auto-white balance routine is enabled, overriding the application's selected CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform , CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains and CaptureRequest#COLOR_CORRECTION_MODE android.colorCorrection.mode .

KeyCONTROL_AWB_STATE

Current state of auto-white balance (AWB) algorithm.

Switching between or enabling AWB modes ( CaptureRequest#CONTROL_AWB_MODE android.control.awbMode ) always resets the AWB state to INACTIVE.

KeyFLASH_MODE

The desired mode for for the camera device's flash control.

This control is only effective when flash unit is available ( CameraCharacteristics#FLASH_INFO_AVAILABLE android.flash.info.available == true).

When this control is used, the CaptureRequest#CONTROL_AE_MODE android.control.aeMode must be set to ON or OFF.

KeyFLASH_STATE

Current state of the flash unit.

When the camera device doesn't have flash unit (i.e.

KeyJPEG_ORIENTATION

The orientation for a JPEG image.

The clockwise rotation angle in degrees, relative to the orientation to the camera, that the JPEG picture needs to be rotated by, to be viewed upright.

Camera devices may either encode this value into the JPEG EXIF header, or rotate the image data to match this orientation.

KeyLENS_APERTURE

The desired lens aperture size, as a ratio of lens focal length to the effective aperture diameter.

Setting this value is only supported on the camera devices that have a variable aperture lens.

When this is supported and CaptureRequest#CONTROL_AE_MODE android.control.aeMode is OFF, this can be set along with CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime , CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity , and CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration to achieve manual exposure control.

The requested aperture value may take several frames to reach the requested value; the camera device will report the current (intermediate) aperture size in capture result metadata while the aperture is changing.

KeyLENS_FOCAL_LENGTH

The desired lens focal length; used for optical zoom.

This setting controls the physical focal length of the camera device's lens.

KeyLENS_FOCUS_DISTANCE

Desired distance to plane of sharpest focus, measured from frontmost surface of the lens.

Should be zero for fixed-focus cameras

Units: See CameraCharacteristics#LENS_INFO_FOCUS_DISTANCE_CALIBRATION android.lens.info.focusDistanceCalibration for details

Range of valid values:
>= 0

Optional - This value may be null on some devices.

Full capability - Present on all camera devices that report being CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_FULL HARDWARE_LEVEL_FULL devices in the CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel key

KeyLENS_STATE

Current lens status.

For lens parameters CaptureRequest#LENS_FOCAL_LENGTH android.lens.focalLength , CaptureRequest#LENS_FOCUS_DISTANCE android.lens.focusDistance , CaptureRequest#LENS_FILTER_DENSITY android.lens.filterDensity and CaptureRequest#LENS_APERTURE android.lens.aperture , when changes are requested, they may take several frames to reach the requested values.

KeySENSOR_EXPOSURE_TIME

Duration each pixel is exposed to light.

If the sensor can't expose this exact duration, it will shorten the duration exposed to the nearest possible value (rather than expose longer).

KeySENSOR_SENSITIVITY

The amount of gain applied to sensor data before processing.

The sensitivity is the standard ISO sensitivity value, as defined in ISO 12232:2006.

The sensitivity must be within CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE android.sensor.info.sensitivityRange , and if if it less than CameraCharacteristics#SENSOR_MAX_ANALOG_SENSITIVITY android.sensor.maxAnalogSensitivity , the camera device is guaranteed to use only analog amplification for applying the gain.

If the camera device cannot apply the exact sensitivity requested, it will reduce the gain to the nearest supported value.

KeySENSOR_TIMESTAMP

Time at start of exposure of first row of the image sensor active array, in nanoseconds.

The timestamps are also included in all image buffers produced for the same capture, and will be identical on all the outputs.

When CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE android.sensor.info.timestampSource == UNKNOWN, the timestamps measure time since an unspecified starting point, and are monotonically increasing.

KeySENSOR_NEUTRAL_COLOR_POINT

The estimated camera neutral color in the native sensor colorspace at the time of capture.

This value gives the neutral color point encoded as an RGB value in the native sensor color space.

KeySENSOR_NOISE_PROFILE

Noise model coefficients for each CFA mosaic channel.

This key contains two noise model coefficients for each CFA channel corresponding to the sensor amplification (S) and sensor readout noise (O).

Method

Tget(Key key)
Get a capture result field value.
longgetFrameNumber()
Get the frame number associated with this result.