Cinemachine Shot Quality Evaluator

Cinemachine Shot Quality Evaluator is an extension for the Camera. It post-processes the final position of the CinemachineCamera to evaluate shot quality based of visibility of the LookAt target and, optionally, camera distance from it.

CinemachineDeoccluder Has this functionality bundled with it. Use this extension if you want to evaluate shot quality without using the Deoccluder.

You can implement your own shot quality evaluator by creating a class that implements the IShotQualityEvaluator interface.

The Shot Quality Evaluator uses a Physics Raycaster. Therefore, Cinemachine Shot Quality Evaluator requires that potential obstructions have collider volumes. There is a performance cost for this requirement. If this cost is prohibitive in your game, consider implementing this functionality differently.

Properties:

Property:	Function:
Occlusion Layers	Objects on these layers will be detected.
Ignore Tag	Obstacles with this tag will be ignored. It is a good idea to set this field to the target's tag.
Minimum Distance From Target	Obstacles closer to the target than this will be ignored.
Camera Radius	Radius of the spherecast that will be done to check for occlusions.
Distance Evaluation	If enabled, will evaluate shot quality based on target distance.
Optimal Distance	If greater than zero, maximum quality boost will occur when target is this far from the camera.
Near Limit	Shots with targets closer to the camera than this will not get a quality boost.
Far Limit	Shots with targets farther from the camera than this will not get a quality boost.
Max Quality Boost	High quality shots will be boosted by this fraction of their normal quality.