Android.Hardware.Camera2.CaptureRequest.ControlAeAntibandingMode Property

Syntax

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

See Also

CameraCharacteristics.ControlAeAvailableAntibandingModes
CaptureRequest.ControlAeMode
CaptureRequest.ControlMode
CaptureResult.StatisticsSceneFlicker

Value

Documentation for this section has not yet been entered.

Remarks

The desired setting for the camera device's auto-exposure algorithm's antibanding compensation.

Some kinds of lighting fixtures, such as some fluorescent lights, flicker at the rate of the power supply frequency (60Hz or 50Hz, depending on country). While this is typically not noticeable to a person, it can be visible to a camera device. If a camera sets its exposure time to the wrong value, the flicker may become visible in the viewfinder as flicker or in a final captured image, as a set of variable-brightness bands across the image.

Therefore, the auto-exposure routines of camera devices include antibanding routines that ensure that the chosen exposure value will not cause such banding. The choice of exposure time depends on the rate of flicker, which the camera device can detect automatically, or the expected rate can be selected by the application using this control.

A given camera device may not support all of the possible options for the antibanding mode. The CameraCharacteristics.ControlAeAvailableAntibandingModes key contains the available modes for a given camera device.

The default mode is AUTO, which is supported by all camera devices.

If manual exposure control is enabled (by setting CaptureRequest.ControlAeMode or CaptureRequest.ControlMode to OFF), then this setting has no effect, and the application must ensure it selects exposure times that do not cause banding issues. The CaptureResult.StatisticsSceneFlicker key can assist the application in this.

Possible values:

Available values for this device:

CameraCharacteristics.ControlAeAvailableAntibandingModes

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