// This code is part of the Fungus library (https://github.com/snozbot/fungus) // It is released for free under the MIT open source license (https://github.com/snozbot/fungus/blob/master/LICENSE) using UnityEngine; using UnityEngine.UI; using System; using System.Collections; using MoonSharp.Interpreter; namespace Fungus { /// /// Types of display operations supported by portraits. /// public enum DisplayType { /// Do nothing. None, /// Show the portrait. Show, /// Hide the portrait. Hide, /// Replace the existing portrait. Replace, /// Move portrait to the front. MoveToFront } /// /// Directions that character portraits can face. /// public enum FacingDirection { /// Unknown direction None, /// Facing left. Left, /// Facing right. Right } /// /// Offset direction for position. /// public enum PositionOffset { /// Unknown offset direction. None, /// Offset applies to the left. OffsetLeft, /// Offset applies to the right. OffsetRight } [AddComponentMenu("")] /// /// Controls the Portrait sprites on stage. /// /// Is only really used via Stage, it's child class. This class continues to exist to support existing API /// dependant code. All functionality is stage dependant. /// public class PortraitController : MonoBehaviour { // Timer for waitUntilFinished functionality protected float waitTimer; protected Stage stage; protected virtual void Awake() { stage = GetComponentInParent(); } protected virtual void FinishCommand(PortraitOptions options) { if (options.onComplete != null) { if (!options.waitUntilFinished) { options.onComplete(); } else { StartCoroutine(WaitUntilFinished(options.fadeDuration, options.onComplete)); } } else { StartCoroutine(WaitUntilFinished(options.fadeDuration)); } } /// /// Makes sure all options are set correctly so it won't break whatever command it's sent to /// /// /// protected virtual PortraitOptions CleanPortraitOptions(PortraitOptions options) { // Use default stage settings if (options.useDefaultSettings) { options.fadeDuration = stage.FadeDuration; options.moveDuration = stage.MoveDuration; options.shiftOffset = stage.ShiftOffset; } // if no previous portrait, use default portrait if (options.character.State.portrait == null) { options.character.State.SetPortraitImageBySprite(options.character.ProfileSprite); } // Selected "use previous portrait" if (options.portrait == null) { options.portrait = options.character.State.portrait; } // if no previous position, use default position if (options.character.State.position == null) { options.character.State.position = stage.DefaultPosition.rectTransform; } // Selected "use previous position" if (options.toPosition == null) { options.toPosition = options.character.State.position; } if (options.replacedCharacter != null) { // if no previous position, use default position if (options.replacedCharacter.State.position == null) { options.replacedCharacter.State.position = stage.DefaultPosition.rectTransform; } } // If swapping, use replaced character's position if (options.display == DisplayType.Replace) { options.toPosition = options.replacedCharacter.State.position; } // Selected "use previous position" if (options.fromPosition == null) { options.fromPosition = options.character.State.position; } // if portrait not moving, use from position is same as to position if (!options.move) { options.fromPosition = options.toPosition; } if (options.display == DisplayType.Hide) { options.fromPosition = options.character.State.position; } // if no previous facing direction, use default facing direction if (options.character.State.facing == FacingDirection.None) { options.character.State.facing = options.character.PortraitsFace; } // Selected "use previous facing direction" if (options.facing == FacingDirection.None) { options.facing = options.character.State.facing; } if (options.character.State.portraitImage == null) { CreatePortraitObject(options.character, options.fadeDuration); } return options; } /// /// Creates and sets the portrait image for a character /// /// /// protected virtual void CreatePortraitObject(Character character, float fadeDuration) { if (character.State.holder == null) { character.State.holder = new GameObject(character.name + " holder", typeof(RectTransform) //typeof(CanvasRenderer), //typeof(Image) ).GetComponent(); // Set it to be a child of the stage character.State.holder.transform.SetParent(stage.PortraitCanvas.transform, false); SetRectTransform(character.State.holder, stage.DefaultPosition.GetComponent()); } if (character.State.allPortraits.Count == 0) { foreach (var item in character.Portraits) { if(item == null) { Debug.LogError("null in portrait list on character " + character.name); continue; } // Create a new portrait object GameObject po = new GameObject(item.name, typeof(RectTransform), typeof(CanvasRenderer), typeof(Image)); // Set it to be a child of the stage po.transform.SetParent(character.State.holder, false); // Configure the portrait image Image pi = po.GetComponent(); pi.preserveAspect = true; pi.sprite = item; pi.color = new Color(1f, 1f, 1f, 0f); if (item == character.ProfileSprite) { character.State.portraitImage = pi; } //expand to fit parent RectTransform rt = po.GetComponent(); rt.sizeDelta = Vector2.zero; rt.anchorMin = Vector2.zero; rt.anchorMax = Vector2.one; rt.pivot = Vector2.one * 0.5f; rt.ForceUpdateRectTransforms(); po.SetActive(false); character.State.allPortraits.Add(pi); } } } protected virtual IEnumerator WaitUntilFinished(float duration, Action onComplete = null) { // Wait until the timer has expired // Any method can modify this timer variable to delay continuing. waitTimer = duration; while (waitTimer > 0f) { waitTimer -= Time.deltaTime; yield return null; } // Wait until next frame just to be safe yield return new WaitForEndOfFrame(); if (onComplete != null) { onComplete(); } } protected virtual void SetupPortrait(PortraitOptions options) { if (options.character.State.holder == null) return; SetRectTransform(options.character.State.holder, options.fromPosition); if (options.character.State.facing != options.character.PortraitsFace) { options.character.State.holder.localScale = new Vector3(-1f, 1f, 1f); } else { options.character.State.holder.localScale = new Vector3(1f, 1f, 1f); } if (options.facing != options.character.PortraitsFace) { options.character.State.holder.localScale = new Vector3(-1f, 1f, 1f); } else { options.character.State.holder.localScale = new Vector3(1f, 1f, 1f); } } protected virtual void DoMoveTween(PortraitOptions options) { CleanPortraitOptions(options); LeanTween.cancel(options.character.State.holder.gameObject); // LeanTween doesn't handle 0 duration properly float duration = (options.moveDuration > 0f) ? options.moveDuration : float.Epsilon; // LeanTween.move uses the anchoredPosition, so all position images must have the same anchor position LeanTween.move(options.character.State.holder.gameObject, options.toPosition.position, duration) .setEase(stage.FadeEaseType); if (options.waitUntilFinished) { waitTimer = duration; } } /// /// Performs a deep copy of all values from one RectTransform to another. /// public static void SetRectTransform(RectTransform target, RectTransform from) { target.eulerAngles = from.eulerAngles; target.position = from.position; target.rotation = from.rotation; target.anchoredPosition = from.anchoredPosition; target.sizeDelta = from.sizeDelta; target.anchorMax = from.anchorMax; target.anchorMin = from.anchorMin; target.pivot = from.pivot; target.localScale = from.localScale; } /// /// Using all portrait options available, run any portrait command. /// /// Portrait Options /// The function that will run once the portrait command finishes public virtual void RunPortraitCommand(PortraitOptions options, Action onComplete) { waitTimer = 0f; // If no character specified, do nothing if (options.character == null) { onComplete(); return; } // If Replace and no replaced character specified, do nothing if (options.display == DisplayType.Replace && options.replacedCharacter == null) { onComplete(); return; } // Early out if hiding a character that's already hidden if (options.display == DisplayType.Hide && !options.character.State.onScreen) { onComplete(); return; } options = CleanPortraitOptions(options); options.onComplete = onComplete; switch (options.display) { case (DisplayType.Show): Show(options); break; case (DisplayType.Hide): Hide(options); break; case (DisplayType.Replace): Show(options); Hide(options.replacedCharacter, options.replacedCharacter.State.position.name); break; case (DisplayType.MoveToFront): MoveToFront(options); break; } } /// /// Moves Character in front of other characters on stage /// public virtual void MoveToFront(PortraitOptions options) { options.character.State.portraitImage.transform.SetSiblingIndex(options.character.State.portraitImage.transform.parent.childCount); options.character.State.display = DisplayType.MoveToFront; FinishCommand(options); } /// /// Show portrait with the supplied portrait options /// /// public virtual void Show(PortraitOptions options) { options = CleanPortraitOptions(options); if (options.shiftIntoPlace) { options.fromPosition = Instantiate(options.toPosition) as RectTransform; if (options.offset == PositionOffset.OffsetLeft) { options.fromPosition.anchoredPosition = new Vector2(options.fromPosition.anchoredPosition.x - Mathf.Abs(options.shiftOffset.x), options.fromPosition.anchoredPosition.y - Mathf.Abs(options.shiftOffset.y)); } else if (options.offset == PositionOffset.OffsetRight) { options.fromPosition.anchoredPosition = new Vector2(options.fromPosition.anchoredPosition.x + Mathf.Abs(options.shiftOffset.x), options.fromPosition.anchoredPosition.y + Mathf.Abs(options.shiftOffset.y)); } else { options.fromPosition.anchoredPosition = new Vector2(options.fromPosition.anchoredPosition.x, options.fromPosition.anchoredPosition.y); } } SetupPortrait(options); // LeanTween doesn't handle 0 duration properly float duration = (options.fadeDuration > 0f) ? options.fadeDuration : float.Epsilon; var prevPortrait = options.character.State.portrait; if (options.character.State.portrait != null && options.character.State.portrait != options.portrait) { HidePortrait(options.character.State.portraitImage.rectTransform, duration); } options.character.State.SetPortraitImageBySprite(options.portrait); options.character.State.portraitImage.rectTransform.gameObject.SetActive(true); LeanTween.alpha(options.character.State.portraitImage.rectTransform, 1f, duration).setEase(stage.FadeEaseType).setRecursive(false); DoMoveTween(options); FinishCommand(options); if (!stage.CharactersOnStage.Contains(options.character)) { stage.CharactersOnStage.Add(options.character); } MoveToFront(options); // Update character state after showing options.character.State.onScreen = true; options.character.State.display = DisplayType.Show; options.character.State.facing = options.facing; options.character.State.position = options.toPosition; } protected virtual void HidePortrait(RectTransform rectTransform, float duration) { LeanTween.alpha(rectTransform, 0f, duration) .setEase(stage.FadeEaseType) .setRecursive(false) .setOnComplete(() => rectTransform.gameObject.SetActive(false)); } /// /// Hide portrait with provided options /// public virtual void Hide(PortraitOptions options) { CleanPortraitOptions(options); if (options.character.State.display == DisplayType.None) { return; } SetupPortrait(options); // LeanTween doesn't handle 0 duration properly float duration = (options.fadeDuration > 0f) ? options.fadeDuration : float.Epsilon; HidePortrait(options.character.State.portraitImage.rectTransform, duration); DoMoveTween(options); //update character state after hiding options.character.State.onScreen = false; options.character.State.facing = options.facing; options.character.State.position = options.toPosition; options.character.State.display = DisplayType.Hide; if (stage.CharactersOnStage.Remove(options.character)) { } FinishCommand(options); } /// /// Sets the dimmed state of a character on the stage. /// public virtual void SetDimmed(Character character, bool dimmedState) { if (character.State.dimmed == dimmedState) { return; } character.State.dimmed = dimmedState; Color targetColor = dimmedState ? stage.DimColor : Color.white; // LeanTween doesn't handle 0 duration properly float duration = (stage.FadeDuration > 0f) ? stage.FadeDuration : float.Epsilon; LeanTween.color(character.State.portraitImage.rectTransform, targetColor, duration).setEase(stage.FadeEaseType).setRecursive(false); } #region Overloads and Helpers /// /// Shows character at a named position in the stage /// /// /// Named position on stage public virtual void Show(Character character, string position) { PortraitOptions options = new PortraitOptions(true); options.character = character; options.fromPosition = options.toPosition = stage.GetPosition(position); Show(options); } /// /// Shows character moving from a position to a position /// /// /// /// Where the character will appear /// Where the character will move to public virtual void Show(Character character, string portrait, string fromPosition, string toPosition) { PortraitOptions options = new PortraitOptions(true); options.character = character; options.portrait = character.GetPortrait(portrait); options.fromPosition = stage.GetPosition(fromPosition); options.toPosition = stage.GetPosition(toPosition); options.move = true; Show(options); } /// /// From lua, you can pass an options table with named arguments /// example: /// stage.show{character=jill, portrait="happy", fromPosition="right", toPosition="left"} /// Any option available in the PortraitOptions is available from Lua /// /// Moonsharp Table public virtual void Show(Table optionsTable) { Show(PortraitUtil.ConvertTableToPortraitOptions(optionsTable, stage)); } /// /// Simple show command that shows the character with an available named portrait /// /// Character to show /// Named portrait to show for the character, i.e. "angry", "happy", etc public virtual void ShowPortrait(Character character, string portrait) { PortraitOptions options = new PortraitOptions(true); options.character = character; options.portrait = character.GetPortrait(portrait); if (character.State.position == null) { options.toPosition = options.fromPosition = stage.GetPosition("middle"); } else { options.fromPosition = options.toPosition = character.State.position; } Show(options); } /// /// Simple character hide command /// /// Character to hide public virtual void Hide(Character character) { PortraitOptions options = new PortraitOptions(true); options.character = character; Hide(options); } /// /// Move the character to a position then hide it /// /// Character to hide /// Where the character will disapear to public virtual void Hide(Character character, string toPosition) { PortraitOptions options = new PortraitOptions(true); options.character = character; options.toPosition = stage.GetPosition(toPosition); options.move = true; Hide(options); } /// /// From lua, you can pass an options table with named arguments /// example: /// stage.hide{character=jill, toPosition="left"} /// Any option available in the PortraitOptions is available from Lua /// /// Moonsharp Table public virtual void Hide(Table optionsTable) { Hide(PortraitUtil.ConvertTableToPortraitOptions(optionsTable, stage)); } /// /// Moves Character in front of other characters on stage /// public virtual void MoveToFront(Character character) { PortraitOptions options = new PortraitOptions(true); options.character = character; MoveToFront(CleanPortraitOptions(options)); } protected virtual void DoMoveTween(Character character, RectTransform fromPosition, RectTransform toPosition, float moveDuration, Boolean waitUntilFinished) { PortraitOptions options = new PortraitOptions(true); options.character = character; options.fromPosition = fromPosition; options.toPosition = toPosition; options.moveDuration = moveDuration; options.waitUntilFinished = waitUntilFinished; DoMoveTween(options); } #endregion } }