> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-463e218.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TextOverlay - ComfyUI Built-in Node Documentation

> 此节点在单张图像或一批图像上绘制文本。

此节点在单张图像或一批图像上绘制文本。它会创建一个可自定义字体大小、颜色、位置、对齐方式以及可选描边的文本叠加层，然后将文本合成到原始图像上。

## 输入

| 参数                                                       | 描述                                                                 | 数据类型    | 是否必填 | 范围                                      |
| -------------------------------------------------------- | ------------------------------------------------------------------ | ------- | ---- | --------------------------------------- |
| `图像`                                                     | 要绘制文本的输入图像或图像批次                                                    | IMAGE   | 是    |                                         |
| `文字`                                                     | 要叠加在图像上的文本（默认：""）。支持多行；`\n` 和 `\t` 转义序列会转换为换行符和制表符，文本会自动换行以适配图像宽度。 | STRING  | 是    |                                         |
| `字体大小`                                                   | 字体大小，以图像高度的百分比表示（默认：5.0）                                           | FLOAT   | 是    | 0.5 至 50.0（步长 0.5）                      |
| `颜色`                                                     | 文本颜色（默认："#ffffff"）                                                 | STRING  | 是    |                                         |
| `位置`                                                     | 文本在图像上的垂直位置（默认："top"）                                              | COMBO   | 是    | `"top"`<br />`"bottom"`                 |
| `对齐`                                                     | 文本的水平对齐方式（默认："left"）                                               | COMBO   | 是    | `"left"`<br />`"center"`<br />`"right"` |
| `描边`                                                     | 在文本周围绘制黑色描边（默认：True）                                               | BOOLEAN | 是    |                                         |
| 注意：如果 `text` 为空或仅包含空白字符，节点将原样返回输入图像。相同的文本叠加会应用于批次中的每张图像。 |                                                                    |         |      |                                         |

## 输出

| 输出名称 | 描述         | 数据类型  |
| ---- | ---------- | ----- |
| `图像` | 叠加了文本的输入图像 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/zh.md)

***

**Source fingerprint (SHA-256):** `baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22`