Files
Main/Assets/Launcher/ExternalLibs/NGUI/Scripts/UI/UI2DSpriteAnimation.cs
2025-01-25 04:38:09 +08:00

159 lines
3.2 KiB
C#

//----------------------------------------------
// NGUI: Next-Gen UI kit
// Copyright © 2011-2015 Tasharen Entertainment
//----------------------------------------------
using UnityEngine;
/// <summary>
/// Small script that makes it easy to create looping 2D sprite animations.
/// </summary>
public class UI2DSpriteAnimation : MonoBehaviour
{
/// <summary>
/// How many frames there are in the animation per second.
/// </summary>
[SerializeField] protected int framerate = 20;
/// <summary>
/// Should this animation be affected by time scale?
/// </summary>
public bool ignoreTimeScale = true;
/// <summary>
/// Should this animation be looped?
/// </summary>
public bool loop = true;
/// <summary>
/// Actual sprites used for the animation.
/// </summary>
public UnityEngine.Sprite[] frames;
UnityEngine.SpriteRenderer mUnitySprite;
UI2DSprite mNguiSprite;
int mIndex = 0;
float mUpdate = 0f;
/// <summary>
/// Returns is the animation is still playing or not
/// </summary>
public bool isPlaying { get { return enabled; } }
/// <summary>
/// Animation framerate.
/// </summary>
public int framesPerSecond { get { return framerate; } set { framerate = value; } }
/// <summary>
/// Continue playing the animation. If the animation has reached the end, it will restart from beginning
/// </summary>
public void Play ()
{
if (frames != null && frames.Length > 0)
{
if (!enabled && !loop)
{
int newIndex = framerate > 0 ? mIndex + 1 : mIndex - 1;
if (newIndex < 0 || newIndex >= frames.Length)
mIndex = framerate < 0 ? frames.Length - 1 : 0;
}
enabled = true;
UpdateSprite();
}
}
/// <summary>
/// Pause the animation.
/// </summary>
public void Pause () { enabled = false; }
/// <summary>
/// Reset the animation to the beginning.
/// </summary>
public void ResetToBeginning ()
{
mIndex = framerate < 0 ? frames.Length - 1 : 0;
UpdateSprite();
}
/// <summary>
/// Start playing the animation right away.
/// </summary>
void Start () { Play(); }
/// <summary>
/// Advance the animation as necessary.
/// </summary>
void Update ()
{
if (frames == null || frames.Length == 0)
{
enabled = false;
}
else if (framerate != 0)
{
float time = ignoreTimeScale ? RealTime.time : Time.time;
if (mUpdate < time)
{
mUpdate = time;
int newIndex = framerate > 0 ? mIndex + 1 : mIndex - 1;
if (!loop && (newIndex < 0 || newIndex >= frames.Length))
{
enabled = false;
return;
}
mIndex = NGUIMath.RepeatIndex(newIndex, frames.Length);
UpdateSprite();
}
}
}
/// <summary>
/// Immediately update the visible sprite.
/// </summary>
void UpdateSprite ()
{
if (mUnitySprite == null && mNguiSprite == null)
{
mUnitySprite = GetComponent<UnityEngine.SpriteRenderer>();
mNguiSprite = GetComponent<UI2DSprite>();
if (mUnitySprite == null && mNguiSprite == null)
{
enabled = false;
return;
}
}
float time = ignoreTimeScale ? RealTime.time : Time.time;
if (framerate != 0) mUpdate = time + Mathf.Abs(1f / framerate);
if (mUnitySprite != null)
{
mUnitySprite.sprite = frames[mIndex];
}
else if (mNguiSprite != null)
{
mNguiSprite.nextSprite = frames[mIndex];
}
}
}