TextOverlay - ComfyUI Built-in Node Documentation

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

输入

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

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

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22