Firstborn/Library/PackageCache/com.unity.cinemachine@2.8.9/Documentation~/CinemachinePostProcessing.md

Post Processing Extension

Use the Cinemachine Post Processing extension to attach a Postprocessing V2 profile to a Virtual Camera.

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 Virtual Camera when it is activated. If the camera is blending with another Virtual Camera, then the blend weight is applied to the Post Process effects also.

Before attaching post processing profiles to Virtual Cameras, you first need to set up your project to use post processing.

To set up project to use Post Processing V2 with Cinemachine:

1. Install the Postprocessing V2 package.

2. Select your Unity camera with Cinemachine Brain in the Scene view.

3. 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 Virtual Camera

4. Select your Virtual Camera in the Scene view or Hierarchy window.

5. In the Inspector, choose Add Extension > CinemachinePostProcessing, then configre the Profile asset to have the effects you want when this virtual camera is live.

Properties:

| Property: || Function: | |:---||:---| | Profile || The Post-Processing profile to activate when this Virtual Camera 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. |