Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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 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

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.