TEXT_DISPLAY_EFFECT - 文本显示效果变换

概述

对已存在的文本显示应用变换效果。

技术规格

属性	值
效果类型	TEXT_DISPLAY_EFFECT
Java 枚举	EffectType.TEXT_DISPLAY_EFFECT
实现类	TextDisplayTransEffect

JSON 格式

{
  "eventType": "TEXT_DISPLAY_EFFECT",
  "beat": 4.0,
  "properties": {
    "id": "display_id",
    "type": "TEXT",
    "text": "新文本内容"
  }
}

字段说明

字段	类型	必需	说明
eventType	string	是	固定为 "TEXT_DISPLAY_EFFECT"
beat	double	是	效果触发的拍数
id	string	是	目标文本显示 ID
type	string	是	变换类型
text	string	否	文本内容（TEXT 类型）
shadowed	boolean	否	是否有阴影（SHADOW 类型）
targetOpacity	float	否	目标透明度（OPACITY 类型）
color	int[4]	否	RGBA 颜色（BACKGROUND_COLOR 类型）
position	float[]	否	位置列表（LINEAR_TRANSFORMATION 类型）
rotation	float[]	否	旋转列表（LINEAR_TRANSFORMATION 类型）
scale	float[]	否	缩放列表（LINEAR_TRANSFORMATION 类型）

变换类型

类型	说明	额外参数
TEXT	更改文本内容	text
SHADOW	更改阴影设置	shadowed
OPACITY	更改透明度	targetOpacity
BACKGROUND_COLOR	更改背景颜色	color
LINEAR_TRANSFORMATION	线性变换	position, rotation, scale
GLOWING	发光效果	无

使用示例

更改文本内容

{
  "eventType": "TEXT_DISPLAY_EFFECT",
  "beat": 4.0,
  "properties": {
    "id": "score_display",
    "type": "TEXT",
    "text": "新分数：1000"
  }
}

更改透明度

{
  "eventType": "TEXT_DISPLAY_EFFECT",
  "beat": 8.0,
  "properties": {
    "id": "score_display",
    "type": "OPACITY",
    "targetOpacity": 0.5
  }
}

线性变换

{
  "eventType": "TEXT_DISPLAY_EFFECT",
  "beat": 12.0,
  "properties": {
    "id": "score_display",
    "type": "LINEAR_TRANSFORMATION",
    "position": [0.0, 2.0, 0.0],
    "rotation": [0.0, 45.0, 0.0],
    "scale": [1.5, 1.5, 1.5]
  }
}

注意事项

1. ID 必须存在: 目标文本显示必须已经创建
2. 类型匹配: 变换类型必须与参数匹配
3. 性能: 变换效果会影响渲染性能
4. 持续时间: 变换效果会持续直到被覆盖

相关效果

• TEXT_DISPLAY - 创建文本显示
• TEXT_DISPLAY_SYNC_TRACK - 轨道同步

相关文档

• 效果系统总览