Android.Hardware.Camera2.CaptureRequest.ControlAeExposureCompensation Property

Syntax

[Android.Runtime.Register("CONTROL_AE_EXPOSURE_COMPENSATION")]
public static CaptureRequest.Key ControlAeExposureCompensation { get; }

See Also

CameraCharacteristics.ControlAeCompensationRange
CameraCharacteristics.ControlAeCompensationStep
CaptureRequest.ControlAeLock
CaptureRequest.ControlAeMode
CaptureResult.ControlAeState

Value

Documentation for this section has not yet been entered.

Remarks

Adjustment to auto-exposure (AE) target image brightness.

The adjustment is measured as a count of steps, with the step size defined by CameraCharacteristics.ControlAeCompensationStep and the allowed range by CameraCharacteristics.ControlAeCompensationRange.

For example, if the exposure value (EV) step is 0.333, '6' will mean an exposure compensation of +2 EV; -3 will mean an exposure compensation of -1 EV. One EV represents a doubling of image brightness. Note that this control will only be effective if CaptureRequest.ControlAeMode!= OFF. This control will take effect even when CaptureRequest.ControlAeLock== true.

In the event of exposure compensation value being changed, camera device may take several frames to reach the newly requested exposure target. During that time, CaptureResult.ControlAeState field will be in the SEARCHING state. Once the new exposure target is reached, CaptureResult.ControlAeState will change from SEARCHING to either CONVERGED, LOCKED (if AE lock is enabled), or FLASH_REQUIRED (if the scene is too dark for still capture).

Units: Compensation steps

Range of valid values:

CameraCharacteristics.ControlAeCompensationRange

This key is available on all devices.

[Android Documentation]

Requirements

Namespace: Android.Hardware.Camera2
Assembly: Mono.Android (in Mono.Android.dll)
Assembly Versions: 0.0.0.0