TEXT_DISPLAY - 文本显示效果

概述

在指定位置创建 3D 文本显示。

技术规格

属性	值
效果类型	TEXT_DISPLAY
Java 枚举	EffectType.TEXT_DISPLAY
实现类	TextDisplayEffect

JSON 格式

{
  "eventType": "TEXT_DISPLAY",
  "beat": 4.0,
  "properties": {
    "id": "display_id",
    "text": "Text",
    "position": [0.0, 1.5, 0.0],
    "rotation": [0.0, 0.0, 0.0],
    "scale": [1.0, 1.0, 1.0]
  }
}

字段说明

字段	类型	必需	说明
eventType	string	是	固定为 "TEXT_DISPLAY"
beat	double	是	效果触发的拍数
id	string	是	文本显示唯一标识符
text	string	是	显示的文本内容
position	float[3]	是	[X, Y, Z] 坐标（数组格式）
rotation	float[3]	是	[X, Y, Z] 旋转角度（数组格式）
scale	float[3]	是	[X, Y, Z] 缩放（数组格式）

使用示例

基本文本显示

{
  "eventType": "TEXT_DISPLAY",
  "beat": 4.0,
  "properties": {
    "id": "title",
    "text": "Welcome to RhythMC",
    "position": [0.0, 2.0, 0.0],
    "rotation": [0.0, 0.0, 0.0],
    "scale": [2.0, 2.0, 2.0]
  }
}

带旋转的文本

{
  "eventType": "TEXT_DISPLAY",
  "beat": 8.0,
  "properties": {
    "id": "rotating_text",
    "text": "Spin!",
    "position": [0.0, 1.5, 0.0],
    "rotation": [0.0, 45.0, 0.0],
    "scale": [1.5, 1.5, 1.5]
  }
}

相关效果

• TEXT_DISPLAY_REMOVE - 移除文本显示
• TEXT_DISPLAY_SYNC_TRACK - 跟随轨道移动
• TEXT_DISPLAY_EFFECT - 文本显示效果变换

相关文档

• 效果系统总览