Documentation for this section has not yet been entered.
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.ControlAeMode is OFF, this can be set along with CaptureRequest.SensorExposureTime, CaptureRequest.SensorSensitivity, and CaptureRequest.SensorFrameDuration 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. While the aperture is still changing, CaptureResult.LensState will be set to MOVING.
When this is supported and CaptureRequest.ControlAeMode is one of the ON modes, this will be overridden by the camera device auto-exposure algorithm, the overridden values are then provided back to the user in the corresponding result.
Units: The f-number (f/N)
Range of valid values:
CameraCharacteristics.LensInfoAvailableApertures
Optional - This value may be null on some devices.
Full capability - Present on all camera devices that report being CameraMetadata.INFO_SUPPORTED_HARDWARE_LEVEL_FULL devices in the CameraCharacteristics.InfoSupportedHardwareLevel key