Documentation for this section has not yet been entered.
Desired distance to plane of sharpest focus, measured from frontmost surface of the lens.
This control can be used for setting manual focus, on devices that support the MANUAL_SENSOR capability and have a variable-focus lens (see CameraCharacteristics.LensInfoMinimumFocusDistance).
A value of 0.0f means infinity focus. The value set will be clamped to [0.0f, CameraCharacteristics.LensInfoMinimumFocusDistance].
Like CaptureRequest.LensFocalLength, this setting won't be applied instantaneously, and it may take several frames before the lens can move to the requested focus distance. While the lens is still moving, CaptureResult.LensState will be set to MOVING.
LEGACY devices support at most setting this to 0.0f for infinity focus.
Units: See CameraCharacteristics.LensInfoFocusDistanceCalibration for details
Range of valid values:
>= 0
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