# Cinemachine Auto Focus

This CinemachineCamera extension drives the Camera's focusDistance property.  It can be used to lock focus onto a specific object, or (in HDRP) to auto-detect what is in front of the camera and focus on that.
	
FocusDistance is only relevant for physical cameras, and appropriate processing must be installed for it to have any visible effect.

As of this writing, only HDRP provides out-of-the-box handling to process the Camera's focusDistance.  In HDRP:
1. Create an active Volume containing a Depth Of Field override.
1. In the DepthOfField override, activate Focus Mode and set it to Physical Camera.
1. In the DepthOfField override, activate Focus Distance Mode and set to Camera.  
 
With these settings, the focus distance set by Cinemachine Auto Focus will have a visible effect while the camera is within the Volume.

![Example Auto Vocus Volume](images/CinemachineAutoVocusVolume.png)


## Properties:

| **Property:** || **Function:** |
|:---|:---|:---|
| __FocusTarget__ || The camera's focus distance will be set to the distance from camera to the selected target.  The Focus Offset field will then modify that distance.  |
| | _None_ | Focus tracking is disabled. |
| | _LookAtTarget_ | Focus offset is relative to the LookAt target. |
| | _FollowTarget_ | Focus offset is relative to the Follow target. |
| | _CustomTarget_ | Focus offset is relative to the Custom target set in the _CustomTarget_ field. |
| | _Camera_ | Focus offset is relative to the camera.  Use this setting to directly set the focus distance using _FocusDepthOffset_. |
| | _ScreenCenter_ | HDRP only: Focus will be on whatever is located in the depth buffer at the center of the screen. |
| __Custom Target__ || The target to use if Focus Target is set to _CustomTarget_.  |
| __Focus Depth Offset__ || Offsets the sharpest point away in depth from the focus target location.  |
| __Damping__ || The value corresponds approximately to the time the focus will take to adjust to the new value.  |
| __Auto Detection Radius__ || HDRP-only: Radius of the AutoFocus sensor in the center of the screen, used when _Focus Target_ is set to _ScreenCenter_.  A value of 1 would fill the screen.  It's recommended to keep this quite small.  Default value is 0.02.  |