ExposureState
public
interface
ExposureState
androidx.camera.core.ExposureState |
An interface which contains the camera exposure related information.
Applications can retrieve an instance via CameraInfo.getExposureState()
.
Summary
Public methods | |
---|---|
abstract
int
|
getExposureCompensationIndex()
Get the current exposure compensation index. |
abstract
Range<Integer>
|
getExposureCompensationRange()
Get the maximum and minimum exposure compensation values for
The actual exposure value (EV) range that supported by the camera can be calculated by
multiplying the
|
abstract
Rational
|
getExposureCompensationStep()
Get the smallest step by which the exposure compensation can be changed. |
abstract
boolean
|
isExposureCompensationSupported()
Whether exposure compensation is supported for this camera. |
Public methods
getExposureCompensationIndex
public abstract int getExposureCompensationIndex ()
Get the current exposure compensation index.
The exposure value (EV) is the compensation index multiplied by the step value
which is given by getExposureCompensationStep()
. Increasing the compensation
index by using the CameraControl.setExposureCompensationIndex(int)
will increase
exposure making the capture result brighter, decreasing the value making it darker.
For example, if the exposure value (EV) step size is 0.333, set the exposure compensation index value '6' will mean an exposure compensation of +2 EV; -3 will mean an exposure compensation of -1 EV.
The exposure value resets to default when there is no UseCase
associated with
the camera. For example, unbind all use cases from the camera or when the lifecycle
changed that all the use case stopping data from the camera.
Returns | |
---|---|
int |
The current exposure compensation index. If isExposureCompensationSupported() is false, always return 0. |
getExposureCompensationRange
public abstract Range<Integer> getExposureCompensationRange ()
Get the maximum and minimum exposure compensation values for
CameraControl.setExposureCompensationIndex(int)
The actual exposure value (EV) range that supported by the camera can be calculated by
multiplying the getExposureCompensationStep()
with the maximum and minimum values:
Min.exposure compensation *
getExposureCompensationStep()
<= minimum
supported EV
Max.exposure compensation *
getExposureCompensationStep()
>= maximum
supported EV
Returns | |
---|---|
Range<Integer> |
the maximum and minimum exposure compensation values range. If isExposureCompensationSupported() is false, return Range [0,0]. |
getExposureCompensationStep
public abstract Rational getExposureCompensationStep ()
Get the smallest step by which the exposure compensation can be changed.
Returns | |
---|---|
Rational |
The exposure compensation step. If isExposureCompensationSupported() is false, return Rational.ZERO . |
isExposureCompensationSupported
public abstract boolean isExposureCompensationSupported ()
Whether exposure compensation is supported for this camera.
Returns | |
---|---|
boolean |
true if exposure compensation is supported for this camera. |