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

Setting Cinemachine Brain properties

The Cinemachine Brain is a component in the Unity camera itself. Cinemachine Brain monitors all active Virtual Cameras in the Scene. It chooses the next Virtual Camera to control the Unity camera. It also controls the cut or blend from the current Virtual Camera to the next.

To add a Cinemachine Brain component to a Unity camera, do one of the following:

• Add a Virtual Camera, or other Cinemachine object, to your Scene. Unity adds a Cinemachine Brain component to the Unity camera for you if there isn’t one already.

• Add a Cinemachine Brain component to the Unity camera yourself.

Tip: You can also control Virtual Cameras from Timeline. Timeline overrides the decisions that Cinemachine Brain makes.

Cinemachine Brain holds the following key properties:

• Blend Settings: A list that defines how to blend from one Virtual Camera to another. For example, add an item to the list for a 4 second blend from vcam1 to vcam2 then add another item for a 1 second blend from vcam2 back to vcam1. If a blend between two cameras isn’t defined, Cinemachine Brain uses its default blend.

• Layer Filter: Cinemachine Brain uses only those Virtual Cameras that pass the culling mask of the Unity camera. You can set up split-screen environments by using the culling mask to filter layers.

• Event Dispatching: Cinemachine Brain fires events when it changes shot. It fires an event when a Virtual Camera goes live. It also fires an event when it cuts from one Virtual Camera to another. Use the latter event to reset temporal post effects.

Properties:

Property:		Function:
Show Debug Text		Check to display a textual summary of the live Virtual Camera and blend in the view.
Show Camera Frustum		Check to display the frustum of the camera in the Scene view.
Ignore Time Scale		Check to make the Virtual Cameras respond in real time to user input and damping, even if the game is running in slow motion.
World Up Override		The Y axis of the specified GameObject defines the worldspace up vector for Virtual Cameras. Use this property in top-down game environments. Set to None to use the worldspace Y axis. Setting this appropriately is important to avoid gimbal-lock in extreme up/down conditions.
Update Method		When to update the position and rotation of the Virtual Cameras.
	Fixed Update	Synchronize Virtual Camera update with the Physics module, in FixedUpdate.
	Late Update	In MonoBehaviour LateUpdate.
	Smart Update	Update each virtual camera according to how its target is updated. This is the recommended setting.
	Manual Update	Virtual Cameras do not update automatically. You must explicitly call brain.ManualUpdate() at an appropriate time in your game loop. This should be after any camera LookAt or Follow targets have moved. This is an advanced feature.
Blend Update Method		When to resolve the blends and update the main camera.
	Late Update	In MonoBehaviour LateUpdate. This is the recommended setting.
	Fixed Update	Use this setting only if your Update Method is FixedUpdate and you see judder when blending.
Default Blend		The blend to use when you haven’t explicitly defined a blend between two Virtual Cameras.
	Cut	Zero-length blend.
	Ease In Out	S-shaped curve, giving a gentle and smooth transition.
	Ease In	Linear out of the outgoing shot, and easy into the incoming.
	Ease Out	Easy out of the outgoing shot, and linear into the incoming.
	Hard In	Easy out of the outgoing, and hard into the incoming.
	Hard Out	Hard out of the outgoing, and easy into the incoming.
	Linear	Linear blend. Mechanical-looking.
	Custom	Custom blend curve. Draw the curve you want.
Custom Blends		The asset that contains custom settings for blends between specific Virtual Cameras in your Scene.
Create Asset		Create an asset containing a list of custom blends between Virtual Cameras.
Camera Cut Event		This event fires when a Virtual Camera goes live and there is no blend.
Camera Activated Event		This event fires when a Virtual Camera goes live. If a blend is involved, then the event fires on the first frame of the blend.