| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101 |
- using UnityEngine;
- using System;
- namespace Cinemachine
- {
- /// <summary>
- /// Asset that defines the rules for blending between Virtual Cameras.
- /// </summary>
- [DocumentationSorting(DocumentationSortingAttribute.Level.UserRef)]
- [Serializable]
- [HelpURL(Documentation.BaseURL + "manual/CinemachineBlending.html")]
- public sealed class CinemachineBlenderSettings : ScriptableObject
- {
- /// <summary>
- /// Container specifying how two specific Cinemachine Virtual Cameras
- /// blend together.
- /// </summary>
- [DocumentationSorting(DocumentationSortingAttribute.Level.UserRef)]
- [Serializable]
- public struct CustomBlend
- {
- [Tooltip("When blending from this camera")]
- public string m_From;
- [Tooltip("When blending to this camera")]
- public string m_To;
- [CinemachineBlendDefinitionProperty]
- [Tooltip("Blend curve definition")]
- public CinemachineBlendDefinition m_Blend;
- }
- /// <summary>The array containing explicitly defined blends between two Virtual Cameras</summary>
- [Tooltip("The array containing explicitly defined blends between two Virtual Cameras")]
- public CustomBlend[] m_CustomBlends = null;
- /// <summary>Internal API for the inspector editopr: a label to represent any camera</summary>
- public const string kBlendFromAnyCameraLabel = "**ANY CAMERA**";
- /// <summary>
- /// Attempts to find a blend definition which matches the to and from cameras as specified.
- /// If no match is found, the function returns the supplied default blend.
- /// </summary>
- /// <param name="fromCameraName">The game object name of the from camera</param>
- /// <param name="toCameraName">The game object name of the to camera</param>
- /// <param name="defaultBlend">Blend to return if no custom blend found.</param>
- /// <returns></returns>
- public CinemachineBlendDefinition GetBlendForVirtualCameras(
- string fromCameraName, string toCameraName, CinemachineBlendDefinition defaultBlend)
- {
- bool gotAnyToMe = false;
- bool gotMeToAny = false;
- CinemachineBlendDefinition anyToMe = defaultBlend;
- CinemachineBlendDefinition meToAny = defaultBlend;
- if (m_CustomBlends != null)
- {
- for (int i = 0; i < m_CustomBlends.Length; ++i)
- {
- // Attempt to find direct name first
- CustomBlend blendParams = m_CustomBlends[i];
- if ((blendParams.m_From == fromCameraName)
- && (blendParams.m_To == toCameraName))
- {
- return blendParams.m_Blend;
- }
- // If we come across applicable wildcards, remember them
- if (blendParams.m_From == kBlendFromAnyCameraLabel)
- {
- if (!string.IsNullOrEmpty(toCameraName)
- && blendParams.m_To == toCameraName)
- {
- if (!gotAnyToMe)
- anyToMe = blendParams.m_Blend;
- gotAnyToMe = true;
- }
- else if (blendParams.m_To == kBlendFromAnyCameraLabel)
- defaultBlend = blendParams.m_Blend;
- }
- else if (blendParams.m_To == kBlendFromAnyCameraLabel
- && !string.IsNullOrEmpty(fromCameraName)
- && blendParams.m_From == fromCameraName)
- {
- if (!gotMeToAny)
- meToAny = blendParams.m_Blend;
- gotMeToAny = true;
- }
- }
- }
- // If nothing is found try to find wild card blends from any
- // camera to our new one
- if (gotAnyToMe)
- return anyToMe;
- // Still have nothing? Try from our camera to any camera
- if (gotMeToAny)
- return meToAny;
- return defaultBlend;
- }
- }
- }
|