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

Blending between Virtual Cameras

Use blending properties to specify how the Cinemachine Brain component performs a blend between virtual cameras.

A Cinemachine blend is not a fade, wipe, or dissolve. Rather, Cinemachine Brain performs a smooth animation of the position, rotation, and other settings of the Unity camera from one Virtual Camera to the next.

For blends between specific Virtual Cameras, use the Custom Blends list in the Cinemachine Brain component. Use the Default Blend property in Cinemachine Brain to specify blends between Virtual Cameras that do not have custom blends.

The From and To settings are name-based, not references. This means that Cinemachine finds cameras by matching their names to the settings. They are not linked to specific GameObjects. The built-in dropdowns can be used to select a virtual camera from the current scene, or the name can be typed directly into the text boxes. If a name does not match any virtual camera in the current scene, the field will be highlighted in yellow.

Use the reserved name **ANY CAMERA** to blend from or to any Virtual Camera.

When Cinemachine begins a transition from one virtual camera to another, it will look in this asset for an entry that matches the upcoming transition, and apply that blend definition.

• If none is found, then the CinemachineBrain's DefaultBlend setting will apply.
• If multiple entries in the Custom Blends asset match the upcoming transition, Cinemachine will choose the one with the strongest specificity. For example, if blending from vcam1 to vcam2, and the custom blends asset contains an entry for vcam1-to-AnyCamera, and another entry for vcam1-to-vcam2, then the vcam1-to-vcam2 entry will apply.
• If multiple entries in the Custom Blends asset match the upcoming transition with equally-strong specificity, then the first one found will apply.

Properties:

Property:		Function:
From		The name of the Virtual Camera to blend from. Use the name **ANY CAMERA** to blend from any Virtual Camera. This property is available only for custom blends.
To		The name of the Virtual Camera to blend to. Use the name **ANY CAMERA** to blend to any Virtual Camera. This property is available only for custom blends.
Style Default Blend		Shape of the blend curve.
	Cut	Zero-length blend.
	Ease In Out	S-shaped curve, giving a gentle and smooth transition.
	Ease In	Linear out of the outgoing Virtual Camera, and ease into the incoming Virtual Camera.
	Ease Out	Ease out of the outgoing Virtual Camera, and blend linearly into the incoming Virtual Camera.
	Hard In	Ease out of the outgoing Virtual Camera, and accelerate into the incoming Virtual Camera.
	Hard Out	Accelerate out of the outgoing Virtual Camera, and ease into the incoming Virtual Camera.
	Linear	Linear blend. mechanical-looking.
	Custom	Custom blend curve. Allows you to draw a custom blend curve.
Time		Duration (in seconds) of the blend.