GFramework/GFramework.Godot/Text/Effects/RichTextFadeInEffect.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.4 KiB
C#

namespace GFramework.Godot.Text.Effects;
/// <summary>
/// 为文本提供逐字符淡入效果。
/// </summary>
[GlobalClass]
[Tool]
public partial class RichTextFadeInEffect : RichTextEffectBase
{
private readonly bool _animatedEffectsEnabled;
/// <summary>
/// 初始化淡入效果。
/// </summary>
/// <param name="animatedEffectsEnabled">是否允许动态效果实际生效。</param>
public RichTextFadeInEffect(bool animatedEffectsEnabled = true)
{
_animatedEffectsEnabled = animatedEffectsEnabled;
}
/// <summary>
/// 获取标签名。
/// </summary>
protected override string TagName => "fade_in";
/// <summary>
/// 应用淡入动画。
/// </summary>
/// <param name="charFx">当前字符上下文。</param>
/// <returns>始终返回 <see langword="true" />。</returns>
public override bool _ProcessCustomFX(CharFXTransform charFx)
{
if (!_animatedEffectsEnabled)
{
return true;
}
var speed = GetFloat(charFx, "speed", 4.0f);
var tick = GetFloat(charFx, "tick", 0.01f);
var progress = (float)(charFx.ElapsedTime * speed - charFx.RelativeIndex * tick);
var color = charFx.Color;
color.A = Mathf.Clamp(progress, 0f, 1f);
charFx.Color = color;
ApplyVisibility(charFx);
return true;
}
}