Add Label (AddLabel) - ComfyUI-KJNodes

Add Label 节点，从技术实现上看，该节点使用 PIL 库进行图像处理和文本渲染

Add Label 节点是一个图像标注工具，它可以在输入的图像上添加一个包含自定义文本的标签条。该节点的核心功能是生成一个带有文字的背景区域，并将其与原始图像进行拼接或叠加，从而为图像添加说明性文字。

节点功能

从技术实现上看，该节点使用 PIL 库进行图像处理和文本渲染。它支持将标签条以“上、下、左、右”四个方向拼接在图像边缘，或以“覆盖”模式直接叠加在图像上。节点会从指定的字体文件夹（通常是 ComfyUI/custom_nodes/ComfyUI-KJNodes/fonts）加载字体文件，并允许用户通过颜色字符串（如“white”、“#FF0000”）来定义文字和标签背景的颜色。

节点参数说明 - Add Label

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image`	IMAGE	是	-	-	image（输入参数）：输入需要添加标签的原始图像。
`font`	COMBO	是	-	(可用字体列表)	font（输入参数）：选择用于渲染文字的字体文件。字体文件需放置在指定的 `kjnodes_fonts` 目录下。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`direction`	COMBO	是	up	"up", "down", "left", "right", "overlay"	`down`（下方）、`left`（左侧）、`right`（右侧）或 `overlay`（直接覆盖在图像上）。
`text_x`	INT	是	10	0 - 4096 (步长: 1)	text_x（输入参数）：设置标签文字在标签条内的水平起始位置（X坐标）。取值范围为 0 到 4096。
`text_y`	INT	是	2	0 - 4096 (步长: 1)	text_y（输入参数）：设置标签文字在标签条内的垂直起始位置（Y坐标）。取值范围为 0 到 4096。
`height`	INT	是	48	-1 - 4096 (步长: 1)	height（输入参数）：设置标签条的高度（当方向为左或右时，此参数控制宽度）。值为 -1 时，高度将自动适应字体大小。
`font_size`	INT	是	32	0 - 4096 (步长: 1)	font_size（输入参数）：设置标签文字的字体大小。取值范围为 0 到 4096。
`font_color`	STRING	是	white	-	font_color（输入参数）：定义标签文字的颜色。支持颜色名称（如“white”）或十六进制颜色码（如“#FF0000”）。
`label_color`	STRING	是	black	-	label_color（输入参数）：定义标签条背景的颜色。支持颜色名称（如“black”）或十六进制颜色码。
`text`	STRING	是	Text	-	text（输入参数）：输入需要显示在标签条上的文字内容。
`caption`	STRING	否	""	-	caption（输入参数）：可选附加说明文字。

Output 输出

参数名称	数据类型	说明
IMAGE	IMAGE	IMAGE（输出参数）：输出已添加了文字标签的图像。

使用场景

在图像批处理或生成工作流中，此节点非常实用。例如，在生成一系列风格测试图后，你可以使用此节点为每张图片自动添加一个描述其使用参数（如模型名称、采样步数）的标签，方便后续对比和筛选。它也可以用于为漫画分格或故事板图像添加对话文字或序号。

注意事项

需要注意的是，当选择“上、下、左、右”方向时，此操作会改变输出图像的尺寸（高度或宽度）。此外，字体颜色和标签背景颜色支持多种格式，但需要确保输入的字符串能被正确解析为 RGB 颜色值。

Add Label 节点源码链接

Add Label 节点来自 ComfyUI-KJNodes 节点包。

Add Label(AddLabel)

Add Label