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

Tracked Dolly

This Virtual Camera Body algorithm restricts the Virtual Camera to move along a predefined path. Use the Path Position property to specify where to put the Virtual Camera on the path.

Use Auto-Dolly mode to move the Virtual Camera to a position on the path that is closest to the Follow target. When enabled, Auto-Dolly automatically animates the position of the Virtual Camera to the position on the path that’s closest to the target.

Tip: Choose your path shapes with care when using Auto-Dolly mode. This becomes problematic on paths that form an arc around some point. As an extreme example, consider a perfectly circular path with the Follow target at the center. The closest point on the path becomes unstable because all points on the circular path are equally close to the target. In this situation, moving the Follow target small distances can cause the camera to move large distances on the track.

Properties:

Property:		Function:
Path		The path that the camera moves along. This property must refer to a Cinemachine Path or Cinemachine Smooth Path.
Path Position		The position along the path to place the camera. Animate this property directly or enable Auto-Dolly. The value is in the units specified by Position Units.
Position Units		The unit of measure for Path Position.
	Path Units	Use waypoints along the path. The value 0 represents the first waypoint on the path, 1 is the second waypoint, and so on.
	Distance	Use distance along the path. The path is sampled according to the Resolution property of the path. Cinemachine creates a distance lookup table, which it stores in an internal cache.
	Normalized	Use the beginning and end of the path. The value 0 represents the beginning of the path, 1 is the end of the path.
Path Offset		The position of the camera relative to the path. X is perpendicular to the path, Y is up, and Z is parallel to the path. Use this property to offset the camera from the path itself.
X Damping		How responsively the camera tries to maintain its position in a direction perpendicular to the path. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly. Using different settings per axis can yield a wide range of camera behaviors.
Y Damping		How responsively the camera tries to maintain its position in the path-local up direction. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly.
Z Damping		How responsively the camera tries to maintain its position in a direction parallel to the path. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly.
Camera Up		How to set the up vector for the Virtual Camera. This affects the screen composition because the camera Aim algorithms try to respect the up direction.
	Default	Do not modify the up direction of the Virtual Camera. Instead, use the World Up Override property in Cinemachine Brain.
	Path	Use the path’s up vector at the current point.
	Path No Roll	Use the path’s up vector at the current point, but with the roll set to zero.
	Follow Target	Use the up vector from the Follow target’s transform.
	Follow Target No Roll	Use the up vector from the Follow target’s transform, but with the roll zeroed out.
Pitch Damping		How responsively the camera tracks the target rotation’s x angle. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly.
Yaw Damping		How responsively the camera tracks the target rotation’s y angle. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly.
Roll Damping		How responsively the camera tracks the target rotation’s z angle. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly.
Auto Dolly		Controls how automatic dollying occurs. A Follow target is necessary to use this feature.
	Enabled	Check to enable the automatic dolly. Note: this can have some performance impact, depending on the search resolution.
	Position Offset	Offset, in position units, from the closest point on the path to the follow target.
	Search Radius	The number of segments on either side of the current segment. Use 0 for the entire path. Use a lower number when the path’s shape relative to the target position causes the closest point on the path to become unstable.
	Search Resolution	Cinemachine searches a segment by dividing it into many straight pieces. The higher the number, the more accurate the result. However, performance is proportionally slower for higher numbers.