Rasagar/Library/PackageCache/com.unity.cinemachine/Documentation~/CinemachineVirtualCamera.md

Setting Virtual Camera properties

The Cinemacine Virtual Camera is a component that you add to an empty GameObject. It represents a Virtual Camera in the Unity Scene.

Use the Aim, Body, and Noise properties to specify how the Virtual Camera animates position, rotation, and other properties. The Virtual Camera applies these settings to the Unity Camera when Cinemachine Brain or Timeline transfers control of the Unity camera to the Virtual Camera. You can also use Scene Handles to modify some common properties.

At any time, each Virtual Camera may be in one of these states:

• Live: The Virtual Camera actively controls a Unity camera that has a Cinemachine Brain. When a Cinemachine Brain blends from one Virtual Camera to the next, both Virtual Cameras are live. When the blend is complete, there is only one live Virtual Camera.

• Standby: The Virtual Camera doesn’t control the Unity camera. However, it still follows and aims at its targets, and updates at every frame. A Virtual Camera in this state is activated and has a priority that is the same as or lower than the live Virtual Camera.

• Disabled: The Virtual Camera doesn’t control the Unity camera and doesn’t actively follow or aim at its targets. A Virtual Camera in this state doesn’t consume processing power. To disable a Virtual Camera, deactivate its game object. The Virtual Camera is present but disabled in the Scene. However, even though the game object is deactivated, the virtual camera can still control the Unity camera if the virtual camera is participating in a blend, or if it is invoked by Timeline.

Properties

Property:		Function:
Solo		Toggles whether or not the Virtual Camera is temporarily live. Use this property to get immediate visual feedback in the Game view to adjust the Virtual Camera.
Game Window Guides		Toggles the visibility of compositional guides in the Game view. These guides are available when Look At specifies a GameObject and the Aim section uses Composer or Group Composer, or when Follow specifies a target and the Body section uses Framing Composer. This property applies to all Virtual Cameras.
Save During Play		Check to apply the changes while in Play mode. Use this feature to fine-tune a Virtual Camera without having to remember which properties to copy and paste. This property applies to all Virtual Cameras.
Priority		The importance of this Virtual Camera for choosing the next shot. A higher value indicates a higher priority. Cinemachine Brain chooses the next live Virtual Camera from all Virtual Cameras that are activated and have the same or higher priority as the current live Virtual Camera. This property has no effect when using a Virtual Camera with Timeline.
Follow		The target GameObject that the Virtual Camera moves with. The Body properties use this target to update the position of the Unity camera. Keep this property empty to make the Unity camera use the position of the Virtual Camera’ transform. For example, you might choose to animate the Virtual Camera in Timeline.
Look At		The target GameObject to aim the Unity camera at. The Aim properties use this target to update the rotation of the Unity camera. Keep this property empty to make the Unity camera use the orientation of the Virtual Camera.
Standby Update		Controls how often the virtual camera is updated when the virtual camera is not live.
Position Blending		Style for blending positions to and from this Virtual Camera.
	Linear	Standard linear position blend.
	Spherical	Spherical blend about the Look At position, if there is a Look At target.
	Cylindrical	Cylindrical blend about the Look At position, if there is a Look At target. Vertical coordinate is linearly interpolated.
Lens		These properties mirror their counterparts in the properties for the Unity camera.
	Field Of View	The camera view in vertical degrees. For example, to specify the equivalent of a 50mm lens on a Super 35 sensor, enter a Field of View of 19.6 degrees. This property is available when the Unity camera with the Cinemachine Brain component uses a Projection of Perspective. You can also use Scene Handles to modify this property.
	Presets	A drop-down menu of settings for commonly-used lenses. Choose Edit Presets to add or edit the asset that contains a default list of lenses.
	Orthographic Size	When using an orthographic camera, defines the half-height of the camera view, in world coordinates. Available when the Unity camera with the Cinemachine Brain component uses a Projection of Orthographic.
	Near Clip Plane	The closest point relative to the camera where drawing occurs. You can also use Scene Handles to modify this property.
	Far Clip Plane	The furthest point relative to the camera where drawing occurs. You can also use Scene Handles to modify this property.
	Dutch	Dutch angle. Tilts the Unity camera on the z-axis, in degrees. This property is unique to the Virtual Camera; there is no counterpart property in the Unity camera.
Mode Override		Allows you to select a different camera mode to apply to the Unity camera component when Cinemachine activates this Virtual Camera. Important: All the changes applied to the Camera component through this setting will remain after the Virtual Camera deactivation. If you set a mode override in any Virtual Camera, you should set one in all Virtual Cameras.
	None	Leaves the Projection and Physical Camera properties unchanged in the Camera.
	Orthographic	Sets the Projection property to Orthographic.
	Perspective	Sets the Projection property to Perspective and disables the Physical Camera feature and properties.
	Physical	Sets the Projection property to Perspective and enables the Physical Camera feature and properties.
Blend Hint		Provides hints for blending positions to and from the virtual camera.
Inherit Position		When enabled, whenever this virtual camera goes live, forces the initial position to be the same as the current position of the Unity Camera, if possible.
Extensions		Components that add extra behaviors to the Virtual Camera.
	Add Extension	Choose a new extension to add to the Virtual Camera.