Class CinemachineExtension
Base class for a CinemachineCamera extension module. Hooks into the Cinemachine Pipeline. Use this to add extra processing to the vcam, modifying its generated state
Inherited Members
Namespace: Unity.Cinemachine
Assembly: solution.dll
Syntax
public abstract class CinemachineExtension : MonoBehaviour
Fields
Name | Description |
---|---|
Epsilon | Useful constant for very small floats |
Properties
Name | Description |
---|---|
ComponentOwner | Get the CinemachineVirtualCamera to which this extension is attached. This is distinct from the CinemachineCameras that the extension will modify, as extensions owned by manager cameras will be applied to all the CinemachineCamera children. |
Methods
Name | Description |
---|---|
Awake() | Connect to virtual camera pipeline. Override implementations must call this base implementation |
ConnectToVcam(bool) | Connect to virtual camera. Implementation must be safe to be called redundantly. Override implementations must call this base implementation |
ForceCameraPosition(Vector3, Quaternion) | Force the virtual camera to assume a given position and orientation |
GetAllExtraStates<T>(List<T>) | Get all extra state info for all vcams. |
GetExtraState<T>(CinemachineVirtualCameraBase) | Because extensions can be placed on manager cams and will in that case be called for all the vcam children, vcam-specific state information should be stored here. Just define a class to hold your state info and use it exclusively when calling this. |
GetMaxDampTime() | Report maximum damping time needed for this extension. Only used in editor for timeline scrubbing. |
InvokePostPipelineStageCallback(CinemachineVirtualCameraBase, Stage, ref CameraState, float) | Legacy support. This is only here to avoid changing the API to make PostPipelineStageCallback() public |
OnDestroy() | Disconnect from virtual camera pipeline. Override implementations must call this base implementation |
OnEnable() | Does nothing. It's here for the little checkbox in the inspector. |
OnTargetObjectWarped(CinemachineVirtualCameraBase, Transform, Vector3) | This is called to notify the extension that a target got warped, so that the extension can update its internal state to make the camera also warp seamlessly. Base class implementation does nothing. |
OnTransitionFromCamera(ICinemachineCamera, Vector3, float) | Notification that this virtual camera is going live. Base class implementation must be called by any overridden method. |
PostPipelineStageCallback(CinemachineVirtualCameraBase, Stage, ref CameraState, float) | This callback will be called after the virtual camera has implemented each stage in the pipeline. This method may modify the referenced state. If deltaTime less than 0, reset all state info and perform no damping. |
PrePipelineMutateCameraStateCallback(CinemachineVirtualCameraBase, ref CameraState, float) | Override this to do such things as offset the ReferenceLookAt. Base class implementation does nothing. |