128 lines
3.4 KiB
C#
128 lines
3.4 KiB
C#
|
using UnityEngine;
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// Flipbook动画启动器
|
|||
|
|
/// 用于非循环的Flipbook动画，在对象激活时自动设置_StartTime，使动画从当前时间开始播放
|
|||
|
|
/// </summary>
|
|||
|
|
public class FlipbookAnimationStarter : MonoBehaviour
|
|||
|
|
{
|
|||
|
|
[Header("设置")]
|
|||
|
|
[Tooltip("是否在OnEnable时自动设置StartTime")]
|
|||
|
|
public bool autoSetOnEnable = true;
|
|||
|
|
|
|||
|
|
[Tooltip("使用Material实例还是共享Material（建议使用实例）")]
|
|||
|
|
public bool useMaterialInstance = true;
|
|||
|
|
|
|||
|
|
[Tooltip("是否也处理子对象的Renderer")]
|
|||
|
|
public bool includeChildren = false;
|
|||
|
|
|
|||
|
|
private static readonly int StartTimePropertyID = Shader.PropertyToID("_StartTime");
|
|||
|
|
private MaterialPropertyBlock _propertyBlock;
|
|||
|
|
private Renderer[] _renderers;
|
|||
|
|
|
|||
|
|
private void Awake()
|
|||
|
|
{
|
|||
|
|
// 初始化MaterialPropertyBlock（性能更好的方式）
|
|||
|
|
_propertyBlock = new MaterialPropertyBlock();
|
|||
|
|
|
|||
|
|
// 获取所有Renderer
|
|||
|
|
if (includeChildren)
|
|||
|
|
{
|
|||
|
|
_renderers = GetComponentsInChildren<Renderer>(true);
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
var renderer = GetComponent<Renderer>();
|
|||
|
|
_renderers = renderer != null ? new[] { renderer } : new Renderer[0];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnEnable()
|
|||
|
|
{
|
|||
|
|
if (autoSetOnEnable)
|
|||
|
|
{
|
|||
|
|
SetStartTime();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 手动设置动画开始时间
|
|||
|
|
/// </summary>
|
|||
|
|
public void SetStartTime()
|
|||
|
|
{
|
|||
|
|
SetStartTime(Time.time);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 设置指定的开始时间
|
|||
|
|
/// </summary>
|
|||
|
|
public void SetStartTime(float startTime)
|
|||
|
|
{
|
|||
|
|
foreach (var renderer in _renderers)
|
|||
|
|
{
|
|||
|
|
if (renderer == null) continue;
|
|||
|
|
|
|||
|
|
if (useMaterialInstance)
|
|||
|
|
{
|
|||
|
|
// 方式1: 使用MaterialPropertyBlock（推荐，不会创建材质实例，性能更好）
|
|||
|
|
renderer.GetPropertyBlock(_propertyBlock);
|
|||
|
|
_propertyBlock.SetFloat(StartTimePropertyID, startTime);
|
|||
|
|
renderer.SetPropertyBlock(_propertyBlock);
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
// 方式2: 使用Material实例（会创建材质副本）
|
|||
|
|
// 注意：renderer.material会自动创建材质实例
|
|||
|
|
renderer.material.SetFloat(StartTimePropertyID, startTime);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 重置动画到第一帧
|
|||
|
|
/// </summary>
|
|||
|
|
public void ResetAnimation()
|
|||
|
|
{
|
|||
|
|
SetStartTime(0f);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 从当前时间重新播放动画
|
|||
|
|
/// </summary>
|
|||
|
|
public void RestartAnimation()
|
|||
|
|
{
|
|||
|
|
SetStartTime(Time.time);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
#if UNITY_EDITOR
|
|||
|
|
[ContextMenu("设置StartTime为当前时间")]
|
|||
|
|
private void EditorSetStartTime()
|
|||
|
|
{
|
|||
|
|
if (Application.isPlaying)
|
|||
|
|
{
|
|||
|
|
SetStartTime();
|
|||
|
|
Debug.Log($"已设置 {gameObject.name} 的StartTime为 {Time.time}");
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning("请在运行时执行此操作");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
[ContextMenu("重置StartTime为0")]
|
|||
|
|
private void EditorResetStartTime()
|
|||
|
|
{
|
|||
|
|
if (Application.isPlaying)
|
|||
|
|
{
|
|||
|
|
ResetAnimation();
|
|||
|
|
Debug.Log($"已重置 {gameObject.name} 的StartTime为0");
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning("请在运行时执行此操作");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
#endif
|
|||
|
|
}
|
|||
|
|
|