using Cinemachine.Utility; using UnityEngine; using UnityEngine.Serialization; namespace Cinemachine { /// /// This component will expose a non-cinemachine camera to the cinemachine system, /// allowing it to participate in blends. /// Just add it as a component alongside an existing Unity Camera component. /// [DocumentationSorting(DocumentationSortingAttribute.Level.UserRef)] [RequireComponent(typeof(Camera)), DisallowMultipleComponent] [AddComponentMenu("Cinemachine/CinemachineExternalCamera")] [ExecuteAlways] [HelpURL(Documentation.BaseURL + "manual/CinemachineExternalCamera.html")] public class CinemachineExternalCamera : CinemachineVirtualCameraBase { /// The object that the camera is looking at. [Tooltip("The object that the camera is looking at. Setting this will improve the " + "quality of the blends to and from this camera")] [NoSaveDuringPlay] [VcamTargetProperty] public Transform m_LookAt = null; private Camera m_Camera; private CameraState m_State = CameraState.Default; /// Get the CameraState, as we are able to construct one from the Unity Camera public override CameraState State { get { return m_State; } } /// The object that the camera is looking at override public Transform LookAt { get { return m_LookAt; } set { m_LookAt = value; } } /// This vcam defines no targets override public Transform Follow { get; set; } /// Hint for blending positions to and from this virtual camera [Tooltip("Hint for blending positions to and from this virtual camera")] [FormerlySerializedAs("m_PositionBlending")] public BlendHint m_BlendHint = BlendHint.None; /// Internal use only. Do not call this method /// Effective world up /// Effective deltaTime public override void InternalUpdateCameraState(Vector3 worldUp, float deltaTime) { // Get the state from the camera if (m_Camera == null) { #if UNITY_2019_2_OR_NEWER TryGetComponent(out m_Camera); #else m_Camera = GetComponent(); #endif } m_State = CameraState.Default; m_State.RawPosition = transform.position; m_State.RawOrientation = transform.rotation; m_State.ReferenceUp = m_State.RawOrientation * Vector3.up; if (m_Camera != null) m_State.Lens = LensSettings.FromCamera(m_Camera); if (m_LookAt != null) { m_State.ReferenceLookAt = m_LookAt.transform.position; Vector3 dir = m_State.ReferenceLookAt - State.RawPosition; if (!dir.AlmostZero()) m_State.ReferenceLookAt = m_State.RawPosition + Vector3.Project( dir, State.RawOrientation * Vector3.forward); } ApplyPositionBlendMethod(ref m_State, m_BlendHint); InvokePostPipelineStageCallback(this, CinemachineCore.Stage.Finalize, ref m_State, deltaTime); } } }