选择文本图层并展开「文本」，设置文字内容、系统字体、排版对齐、2D 描边阴影与 3D 挤出倒角。
文本图层
文本图层可将自定义文字内容作为独立图层放置于舞台中：支持展示直播标题、弹幕提示、滚动通告、房间规则或歌词字幕。
可通过以下两种途径向场景中添加文本：
- 素材库：在 素材库 的文本分类下输入内容，点击添加到场景即生成文本图层
- 剪贴板粘贴：在窗口任意位置按下 ⌘/Ctrl+V 粘贴剪贴板中的纯文本即可直接创建文本图层（在文本输入框获得焦点时光标保留原生输入逻辑；在 直播模式 下纯文本粘贴将被屏蔽，防止意外将剪贴板中的密钥等敏感信息上屏）
文本图层跨 2D 与 3D 空间 通用：2D 模式下作为锐利的屏幕平面矢量图层参与层叠；3D 模式下转换为 Blender 风格的立体挤出网格几何体，接受场景实时光照与阴影投射。
选中文本图层后，详情面板将展示文本专属配置：
| 字段 | 说明 |
|---|---|
| 文字 | 多行纯文本内容，上限 10,000 字符。直接在控制面板的输入框中编辑，支持系统输入法（IME） |
| 字体 | 本机已安装的系统字体家族。下拉列表会实时呈现当前文本首行在各字体下的字样预览，并标注样式数量与本地化别名。若目标电脑缺失该字体，将自动回退至同家族中最接近的字重，或系统默认无衬线字体 |
| 样式 | 字体家族提供的真实字形变体（如 Regular、Bold、Semibold、Italic 等），避免人工合成伪加粗 |
| 大小 | 文字字号（像素）。在 3D 空间中按 1000 像素/米映射换算 |
| 颜色 | 文字本体基础填充颜色 |
| 对齐 | 水平对齐方式：左对齐、居中对齐、右对齐与两端对齐。该设定同时决定文字在内容增减时保持不动的对齐锚点 |
| 垂直对齐 | 垂直对齐方式：顶部、居中、基线（首行基线）与底部对齐 |
| 字符间距 | 字符之间的附加间隙（em），默认 0 |
| 单词间距 | 词间空格的附加宽度（em），作用于标准空格符，默认 0 |
| 行高 | 以字号为基准的行间距倍数，默认 1.25× |
| 倾斜 | 文字斜切倾斜度（−1 至 1）。适用于为缺少原生斜体字形的字体呈现斜体外观 |
排版与文本框
文本图层提供可调的虚拟排版外框，用于精确规划文本的版面占用：
| 字段 | 说明 |
|---|---|
| 宽度 与 高度 | 文本框尺寸（像素）。保持为 0 时外框自动贴合文字边界；指定正宽度时文本将自动折行（支持中日韩禁则与西文换行） |
| 溢出 | 文字超出文本框边界时的处理策略：溢出（允许超出外框继续显示）、缩放以适应（自动缩小文字以刚好容纳于框内）或截断（丢弃超出边框的文本行） |
2D 样式与底板
在 2D 空间下，文本图层由矢量光栅化着色器绘制，内置专用的描边、投影与背景底板设置（不依赖图层后处理特效）：
- 描边：提供宽度（像素）、颜色以及拐角样式（圆角 Round、尖角 Sharp 或斜角 Beveled）
- 阴影：提供不透明度（%）、颜色、水平与垂直偏移（偏移 X 与 偏移 Y，像素）以及模糊半径（像素）
- 背景：在文字底层绘制带衬底的底板，提供不透明度（%）、颜色、内边距（Padding，像素）以及圆角半径（Corner Radius，像素）
2D 文本在舞台缩放、窗口拉伸或高分辨率导出时，会在固定比例步进点自动以全分辨率重绘，确保文字与边缘始终保持锐利清晰。
3D 几何与材质
在 3D 空间下，文字通过三维轮廓解析转换为实体立体网格，并提供三维专属控件：
| 控制项 | 说明 |
|---|---|
| 挤出 | 几何体沿深度方向的挤出厚度（em），取值 0 至 5 |
| 倒角 | 文字边沿的倒角切削深度（em），赋予文字柔和的高光立体轮廓 |
| 倒角细分 | 倒角曲面的分段细分程度（1 至 10），数值越高曲面过渡越圆润 |
| 粗糙度 与 金属度 | 基于 PBR 物理材质的标准光照响应属性，取值 0 至 1 |
| 自发光 | 使文字以自身颜色散发辉光，可配合全场景 辉光特效 营造霓虹灯发光字效果 |
| 面向相机 | 开启后文字在每一帧自动朝向视口相机构图，忽略图层自身的空间旋转姿态 |
3D 文字的轮廓描边与外部阴影由 图层特效（如描边 Outline 与投影 Drop Shadow）直接驱动。
卡拉 OK 与实时文本
文本图层不仅支持静态文字展示，还深度集成至外部控制与舞台演出管线中：
- 卡拉 OK 歌词：通过自动化的 歌词 动作，可在文本图层上逐字唱出 LRC 歌词。面板底部提供已演唱颜色（Sung Color）与已演唱描边（Sung Outline，仅限 2D）配置项，在歌词演唱推进时平滑擦除变色
- 实时文本：可动态投送到文本图层的临时文本，直接在舞台呈现，不写入场景文件，亦不产生撤销历史记录。可通过以下方式投送：
- 自动化
- Stream Deck 的「设置文本」动作
- MCP 服务器 的
set_text工具 - 插件 API 调用
object.setText（带transient标记）
- 恢复保存文本：当舞台正显示外部临时文本时，面板中将出现实时文本提示栏与显示已保存文本按钮。点击即可立即撤除临时文本并恢复场景中保存的原始文字；直接在文本框中键入新内容或切换场景时，临时文本亦会自动结束
最后更新于 2026年10月21日