ImagePad KJ (ImagePadKJ) - ComfyUI-KJNodes

ImagePad KJ 节点支持多种填充模式，包括复制边缘像素、使用纯色或应用模糊效果，并能同时处理图像数据和对应的遮罩数据。

ImagePad KJ 是一个图像处理节点，专门用于为输入的图像和可选的遮罩添加边框或填充区域。其核心功能是允许用户精确控制图像四周的扩展尺寸和填充方式，从而调整图像的构图或为后续处理步骤准备画布。

节点功能

此节点支持多种填充模式，包括复制边缘像素、使用纯色或应用模糊效果，并能同时处理图像数据和对应的遮罩数据。它接受标准的 IMAGE 和 MASK 张量作为输入，通过指定上、下、左、右四个方向的像素值来定义填充区域，并确保输出图像和遮罩的尺寸同步变化。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image`	IMAGE	是	-	-	image（输入参数）：输入需要被填充的原始图像。节点将对此图像应用指定的填充设置。
`mask`	MASK	否	-	-	mask（输入参数）：可选输入，与图像对应的遮罩。节点会将其缩放到与图像相同尺寸后，应用相同的填充设置。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`pad_mode`	COMBO	是	edge	"edge", "edge_pixel", "color", "pillarbox_blur"	`edge_pixel`（复制单个边缘像素）、`color`（使用指定颜色）、`pillarbox_blur`（模糊边缘以创建电影黑边效果）。
`left`	INT	是	0	0 - MAX_RESOLUTION (步长: 1)	left（输入参数）：指定在图像左侧添加的填充区域的宽度，单位为像素。取值范围为 0 至 MAX_RESOLUTION，步长为 1。
`right`	INT	是	0	0 - MAX_RESOLUTION (步长: 1)	right（输入参数）：指定在图像右侧添加的填充区域的宽度，单位为像素。取值范围为 0 至 MAX_RESOLUTION，步长为 1。
`top`	INT	是	0	0 - MAX_RESOLUTION (步长: 1)	top（输入参数）：指定在图像顶部添加的填充区域的高度，单位为像素。取值范围为 0 至 MAX_RESOLUTION，步长为 1。
`bottom`	INT	是	0	0 - MAX_RESOLUTION (步长: 1)	bottom（输入参数）：指定在图像底部添加的填充区域的高度，单位为像素。取值范围为 0 至 MAX_RESOLUTION，步长为 1。
`extra_padding`	INT	是	0	0 - MAX_RESOLUTION (步长: 1)	在指定给四个方向（上、下、左、右）的填充量基础上，额外统一增加的像素值。取值范围为 0 至 MAX_RESOLUTION，步长为 1。
`color`	STRING	是	0, 0, 0	-	颜色，可以是 RGB 值（0-255 或 0.0-1.0）、颜色名称或十六进制代码。
`target_width`	INT	否	-	0 - MAX_RESOLUTION (步长: 1)	-
`target_height`	INT	否	-	0 - MAX_RESOLUTION (步长: 1)	-

参数名称	数据类型	说明
images	IMAGE	images（输出参数）：输出经过填充处理后的图像。
masks	MASK	masks（输出参数）：输出经过同步填充处理后的遮罩。

在需要将不规则尺寸的图像统一为特定长宽比的工作流中，此节点非常有用。例如，在批量处理不同来源的图片以输入到固定尺寸的 AI 模型之前，可以使用它来添加黑边（pillarbox）或模糊背景，确保所有输入尺寸一致，同时保留原始图像内容不被扭曲。

请注意，过大的填充值可能会导致最终图像分辨率超出系统处理能力。此外，当提供遮罩时，节点会自动将其缩放到与输入图像相同的尺寸，然后再进行填充操作。

ImagePad KJ 节点来自 ComfyUI-KJNodes 节点包。