Class CinemachineComponentBase | Package Manager UI website
docs.unity3d.com
    Show / Hide Table of Contents

    Class CinemachineComponentBase

    An abstract representation of a mutator acting on a Cinemachine Virtual Camera

    Inheritance
    MonoBehaviour
    CinemachineComponentBase
    CinemachineBasicMultiChannelPerlin
    CinemachineComposer
    CinemachineFramingTransposer
    CinemachineHardLockToTarget
    CinemachineHardLookAt
    CinemachinePOV
    CinemachineSameAsFollowTarget
    CinemachineTrackedDolly
    CinemachineTransposer
    Namespace: Cinemachine
    Syntax
    [DocumentationSorting(DocumentationSortingAttribute.Level.API)]
    public abstract class CinemachineComponentBase : MonoBehaviour

    Fields

    Epsilon

    Useful constant for very small floats

    Declaration
    protected const float Epsilon = 0.0001F
    Field Value
    Type Description
    System.Single

    Properties

    FollowTarget

    Returns the owner vcam's Follow target.

    Declaration
    public Transform FollowTarget { get; }
    Property Value
    Type Description
    Transform

    FollowTargetPosition

    Get the position of the Follow target. Special handling: If the Follow target is a VirtualCamera, returns the vcam State's position, not the transform's position

    Declaration
    public Vector3 FollowTargetPosition { get; }
    Property Value
    Type Description
    Vector3

    FollowTargetRotation

    Get the rotation of the Follow target. Special handling: If the Follow target is a VirtualCamera, returns the vcam State's rotation, not the transform's rotation

    Declaration
    public Quaternion FollowTargetRotation { get; }
    Property Value
    Type Description
    Quaternion

    IsValid

    Returns true if this object is enabled and set up to produce results.

    Declaration
    public abstract bool IsValid { get; }
    Property Value
    Type Description
    System.Boolean

    LookAtTarget

    Returns the owner vcam's LookAt target.

    Declaration
    public Transform LookAtTarget { get; }
    Property Value
    Type Description
    Transform

    LookAtTargetPosition

    Get the position of the LookAt target. Special handling: If the LookAt target is a VirtualCamera, returns the vcam State's position, not the transform's position

    Declaration
    public Vector3 LookAtTargetPosition { get; }
    Property Value
    Type Description
    Vector3

    LookAtTargetRotation

    Get the rotation of the LookAt target. Special handling: If the LookAt target is a VirtualCamera, returns the vcam State's rotation, not the transform's rotation

    Declaration
    public Quaternion LookAtTargetRotation { get; }
    Property Value
    Type Description
    Quaternion

    Stage

    What part of the pipeline this fits into

    Declaration
    public abstract CinemachineCore.Stage Stage { get; }
    Property Value
    Type Description
    CinemachineCore.Stage

    VcamState

    Returns the owner vcam's CameraState.

    Declaration
    public CameraState VcamState { get; }
    Property Value
    Type Description
    CameraState

    VirtualCamera

    Get the associated CinemachineVirtualCameraBase

    Declaration
    public CinemachineVirtualCameraBase VirtualCamera { get; }
    Property Value
    Type Description
    CinemachineVirtualCameraBase

    Methods

    MutateCameraState(ref CameraState, Single)

    Mutates the camera state. This state will later be applied to the camera.

    Declaration
    public abstract void MutateCameraState(ref CameraState curState, float deltaTime)
    Parameters
    Type Name Description
    CameraState curState

    Input state that must be mutated

    System.Single deltaTime

    Delta time for time-based effects (ignore if less than 0)

    OnTargetObjectWarped(Transform, Vector3)

    This is called to notify the component that a target got warped, so that the component can update its internal state to make the camera also warp seamlessy. Base class implementation does nothing.

    Declaration
    public virtual void OnTargetObjectWarped(Transform target, Vector3 positionDelta)
    Parameters
    Type Name Description
    Transform target

    The object that was warped

    Vector3 positionDelta

    The amount the target's position changed

    PrePipelineMutateCameraState(ref CameraState)

    Override this to do such things as offset the RefereceLookAt. Base class implementation does nothing.

    Declaration
    public virtual void PrePipelineMutateCameraState(ref CameraState curState)
    Parameters
    Type Name Description
    CameraState curState

    Input state that must be mutated

    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023