Post Processing Extension
Use the Cinemachine Post Processing extension to attach a Postprocessing V2 profile to a CinemachineCamera.
Note 1: Unity recommends using Postprocessing V2 instead of Postprocessing V1.
Note 2: With HDRP and URP 7 and up, The PostProcessing package is deprecated, and is implemented natively by HDRP and URP. In that case, please see the CinemachineVolumeSettings extension.
The Cinemachine Post Processing extension holds a Post-Processing Profile asset to apply to a CinemachineCamera when it is activated. If the camera is blending with another CinemachineCamera, then the blend weight is applied to the Post Process effects also.
Before attaching post processing profiles to CinemachineCameras, you first need to set up your project to use post processing.
To set up a project to use Post Processing V2 with Cinemachine:
Install the Postprocessing V2 package.
Select your Unity camera with Cinemachine Brain in the Scene view.
Add the component named Post-Process Layer. This will enable Post Process profiles to affect the Camera.
To add a Post Process profile to a CinemachineCamera
Select your CinemachineCamera in the Scene view or Hierarchy window.
In the Inspector, choose Add Extension > CinemachinePostProcessing, then configre the Profile asset to have the effects you want when this CinemachineCamera is live.
Properties:
Property: | Function: | |
---|---|---|
Profile | The Post-Processing profile to activate when this CinemachineCamera is live. | |
Focus Tracks Target | This is obsolete, please use Focus Tracking. | |
Focus Tracking | If the profile has the appropriate overrides, will set the base focus distance to be the distance from the selected target to the camera. The Focus Offset field will then modify that distance. | |
None | No focus tracking. | |
Look At Target | Focus offset is relative to the LookAt target. | |
Follow Target | Focus offset is relative to the Follow target. | |
Custom Target | Focus offset is relative to the Custom target. | |
Camera | Focus offset is relative to the camera | |
Focus Target | The target to use if Focus Tracks Target is set to Custom Target. | |
Focus Offset | Used when Focus Tracking is not None. Offsets the sharpest point away from the location of the focus target. | |
Weight | The weight of the dynamic volume that will be created, when the camera is fully blended in. This will blend to and from 0 along with the camera. |