namespace GFramework.Godot.Text.Effects; /// /// 为文本提供正弦波形的上下漂浮效果。 /// [GlobalClass] [Tool] public partial class RichTextSineEffect : RichTextEffectBase { private readonly bool _animatedEffectsEnabled; /// /// 初始化正弦效果。 /// /// 是否允许动态效果实际生效。 public RichTextSineEffect(bool animatedEffectsEnabled = true) { _animatedEffectsEnabled = animatedEffectsEnabled; } /// /// 获取标签名。 /// protected override string TagName => "sine"; /// /// 应用正弦位移。 /// /// 当前字符上下文。 /// 始终返回 public override bool _ProcessCustomFX(CharFXTransform charFx) { if (!_animatedEffectsEnabled) { return true; } var amplitude = GetFloat(charFx, "amplitude", 0.8f); var frequency = GetFloat(charFx, "frequency", 0.5f); var speed = GetFloat(charFx, "speed", 1.5f); var phase = (float)(charFx.ElapsedTime * speed + charFx.RelativeIndex * 0.1f); var offsetY = amplitude * Mathf.Sin(phase * Mathf.Pi * 2f * frequency); charFx.Offset += new Vector2(0f, offsetY); ApplyVisibility(charFx); return true; } }