Class CinemachineOrbitalFollow
This is a CinemachineComponent in the the Body section of the component pipeline. Its job is to position the camera somewhere on a spheroid centered at the Follow target.
The position on the sphere and the radius of the sphere can be controlled by user input.
Inheritance
Implements
Inherited Members
Namespace: Unity.Cinemachine
Assembly: solution.dll
Syntax
[AddComponentMenu("Cinemachine/Procedural/Position Control/Cinemachine Orbital Follow")]
[DisallowMultipleComponent]
[CameraPipeline(CinemachineCore.Stage.Body)]
[HelpURL("https://docs.unity3d.com/Packages/com.unity.cinemachine@3.0/manual/CinemachineOrbitalFollow.html")]
public class CinemachineOrbitalFollow : CinemachineComponentBase, IInputAxisOwner, IInputAxisResetSource, CinemachineFreeLookModifier.IModifierValueSource, CinemachineFreeLookModifier.IModifiablePositionDamping, CinemachineFreeLookModifier.IModifiableDistance
Fields
Name | Description |
---|---|
HorizontalAxis | Axis representing the current horizontal rotation. Value is in degrees and represents a rotation about the up vector |
OrbitStyle | How to construct the surface on which the camera will travel |
Orbits | Defines a complex surface rig from 3 horizontal rings. |
RadialAxis | Axis controlling the scale of the current distance. Value is a scalar multiplier and is applied to the specified camera distance |
Radius | The camera will be placed at this distance from the Follow target |
RecenteringTarget | Defines the reference frame for horizontal recentering. The axis center will be dynamically updated to be behind the selected object. |
TargetOffset | Offset from the object's center in local space. |
TrackerSettings | Settings to control damping for target tracking. |
VerticalAxis | Axis representing the current vertical rotation. Value is in degrees and represents a rotation about the right vector |
Properties
Name | Description |
---|---|
IsValid | True if component is enabled and has a valid Follow target |
Stage | Get the Cinemachine Pipeline stage that this component implements. Always returns the Body stage |
Methods
Name | Description |
---|---|
ForceCameraPosition(Vector3, Quaternion) | Force the virtual camera to assume a given position and orientation |
GetMaxDampTime() | Report maximum damping time needed for this component. |
MutateCameraState(ref CameraState, float) | Positions the virtual camera according to the transposer rules. |
OnTargetObjectWarped(Transform, Vector3) | This is called to notify the user that a target got warped, so that we can update its internal state to make the camera also warp seamlessly. |
OnTransitionFromCamera(ICinemachineCamera, Vector3, float) | Notification that this virtual camera is going live. Base class implementation does nothing. |