> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 标题 (Title)

> 在视频上烧录一段带样式的标题文字——类似片头字幕或下方字幕条，支持字体、描边、位置、时间、淡入淡出和打字机逐字显现。

<Frame caption="标题 (Title) · 截图待补">
  <img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=b54171099e5b02d4313fe581171ebbcc" alt="标题 (Title)" width="800" height="450" data-path="images/nodes/_placeholder.svg" />
</Frame>

## 这个节点是做什么的

**Title（标题）** 在 `COMFYTV_VIDEO` 上叠加一段文字，并重新渲染成新视频。你输入文字、选字体和颜色、决定位置和出现时间，然后点 **▶ 运行**；渲染是服务器端的一次 ffmpeg 处理（非浏览器即时）。输出是新的 `COMFYTV_VIDEO`。

卡片带实时视频播放器可预览位置，文字支持替换记号 `#timecode#`、`#shorttimecode#`、`#frame#`，播放时会被替换为当前时间码/帧号。

本节点需要同时接入 **video** 输入并填写非空 **text**——任一缺失时运行都会报错。

## 适用场景

* 给片段加片头标题或片尾卡。
* 加人名/职务的下方字幕条，用描边保证可读性。
* 用打字机效果做动感开场。
* 为审片版本打上实时时间码或帧计数。

## 参数说明

### text（文字）

要烧录的标题文字。支持记号 `#timecode#`、`#shorttimecode#`、`#frame#`。必填（留空运行会报错）。

### font（字体）

服务器上可用字体的下拉框（来自 `list_fonts()`；无字体时回退到 `default`）。默认为第一个已安装字体。

### size（字号）

字号（像素）。范围 8–400，默认 48。

### color（颜色）

文字填充色，十六进制字符串。默认 `#FFFFFF`（白）。

### stroke / stroke\_color（描边 / 描边色）

描边粗细（像素，0–20，默认 0）及其十六进制颜色（默认 `#000000`）。轻微描边可让文字在杂乱画面上依旧清晰。

### anchor（锚点）

文字位置：`bottom`、`top`、`center`、`top-left`、`top-right`、`bottom-left`、`bottom-right`。默认 `bottom`。

### t\_start / t\_end（起始 / 结束时间）

起止时间（秒）。`t_start` 默认 0.0（0–3600）。`t_end` 默认 `-1.0`，`-1` 表示「直到片尾」（范围 −1 到 3600）。

### fade\_s（淡入淡出）

淡入/淡出时长（秒），0–10，默认 0（不淡化）。

### typewriter / type\_step（打字机 / 步进）

显现模式：`off`、`char`、`word`、`line`（默认 `off`）。非 `off` 时，`type_step` 为每个单位显现的间隔秒数（0.02–2.0，默认 0.1）。

## 输出说明

| 输出        | 类型              | 含义        |
| --------- | --------------- | --------- |
| **video** | `COMFYTV_VIDEO` | 已烧录标题的源片段 |

## 使用提示

* 2–4px 的对比色描边是让标题在任何背景上都清晰的最省事做法。
* `t_end = -1` 是「保持到片尾」的默认值；只有想让标题提前消失时才设正值。
* 字体来自服务器；下拉框里缺你要的字体时，请在系统（或 ComfyTV 资源）中安装字体。

## 类型与 Bridge

`COMFYTV_VIDEO` 是 ComfyTV 的项目快照，不是 ComfyUI 原生 `VIDEO`。要与原生 ComfyUI 节点互通，请插入 **Bridge**（`ComfyTV/Bridge`）。详见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。

## 相关节点

* **Subtitles（字幕）**——烧录带时间的 SRT/VTT 字幕（随时间显示多条），而非单条标题。
* **Subtitles · Speech-to-Text（语音转字幕）**——自动生成字幕文本供 Subtitles 使用。
