GFramework/GFramework.Godot/Text/Effects/RichTextSineEffect.cs
GeWuYou e5ad29314e feat(text): 添加富文本效果系统和颜色标记功能
- 实现 RichTextEffectBase 基类提供统一的标签命名和参数读取逻辑
- 添加 RichTextBlueEffect、RichTextGoldEffect、RichTextGreenEffect 和 RichTextRedEffect 颜色标记效果
- 添加 RichTextFadeInEffect、RichTextFlyInEffect、RichTextJitterEffect 和 RichTextSineEffect 动画效果
- 实现 DefaultRichTextEffectRegistry 默认效果注册表
- 创建 GfRichTextLabel 富文本标签宿主组件
- 添加 IRichTextEffectRegistry 效果注册表接口
- 实现 RichTextEffectEntry、RichTextEffectsController 和 RichTextProfile 配置管理类
- 添加 RichTextMarkup 语义化标签构建辅助方法
- 创建 RichTextMarkupTests 和 RichTextProfileTests 单元测试
2026-04-18 11:58:40 +08:00

48 lines
1.5 KiB
C#

namespace GFramework.Godot.Text.Effects;
/// <summary>
/// 为文本提供正弦波形的上下漂浮效果。
/// </summary>
[GlobalClass]
[Tool]
public partial class RichTextSineEffect : RichTextEffectBase
{
private readonly bool _animatedEffectsEnabled;
/// <summary>
/// 初始化正弦效果。
/// </summary>
/// <param name="animatedEffectsEnabled">是否允许动态效果实际生效。</param>
public RichTextSineEffect(bool animatedEffectsEnabled = true)
{
_animatedEffectsEnabled = animatedEffectsEnabled;
}
/// <summary>
/// 获取标签名。
/// </summary>
protected override string TagName => "sine";
/// <summary>
/// 应用正弦位移。
/// </summary>
/// <param name="charFx">当前字符上下文。</param>
/// <returns>始终返回 <see langword="true" />。</returns>
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;
}
}