Image Concatenate (ImageConcanate) - ComfyUI-KJNodes

Image Concatenate 节点在技术实现上支持沿四个方向（右、下、左、上）进行拼接。

Image Concatenate 节点是一个图像处理节点，其核心功能是将两个输入（image1 和 image2）——可以是图像或遮罩——沿指定方向拼接成一个新输出。它为用户提供了一种直观的组合视觉元素的方式，是构建复杂图像布局的基础工具。

节点功能

该节点在技术实现上支持沿四个方向（右、下、左、上）进行拼接。当启用 match_image_size 选项时，它会自动调整第二张图像（或遮罩）的尺寸以匹配第一张图像在拼接方向上的尺寸，确保边缘整齐。当禁用时，如果共享轴上的尺寸不匹配，较小的图像会被居中并用零填充，而不会报错。此外，如果 image2 的类型（图像或遮罩）与 image1 不同，会自动进行转换：图像转遮罩使用 RGB 均值，遮罩转图像则将单通道复制到 RGB 各通道。内部还处理了输入图像批次大小不一致的情况，通过重复最后一张图像来对齐批次，保证输出的稳定性。

节点参数说明 - Image Concatenate

连接输入（Inputs）

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image1`	IMAGE / MASK	是	-	-	image1（输入参数）：作为拼接基准的第一张输入（图像或遮罩）。输出类型与此输入类型相同。
`image2`	IMAGE / MASK	是	-	-	image2（输入参数）：将被拼接到第一张上的第二张输入（图像或遮罩）。如果其类型与 image1 不同，会自动进行转换。

控件参数（Parameters）

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`direction`	COMBO	是	right	"right", "down", "left", "up"	将 image2 拼接到 image1 的方向。
`match_image_size`	BOOLEAN	是	是	-	match_image_size（输入参数）：布尔值，默认为是。启用后，自动调整第二张图像的尺寸以匹配第一张图像在拼接方向上的尺寸。禁用时，尺寸不匹配则较小图像居中并用零填充。

输出（Output）

参数名称	数据类型	说明
IMAGE / MASK	IMAGE / MASK（与 image1 类型相同）	输出（输出参数）：拼接完成后生成的新图像或遮罩。其类型与 image1 一致。

使用场景

在具体工作流中，此节点常用于创建对比图或拼贴画。例如，在图像生成或编辑流程中，你可以将原始图像和经过风格化处理的图像分别输入，选择“右”或“下”方向进行拼接，从而并排展示处理前后的效果，便于直观比较。

注意事项

需要注意的是，当拼接方向为“左”或“上”时，image2 会被拼接到 image1 的左侧或上方，图像的前后顺序会影响最终视觉效果。此外，如果输入图像尺寸差异较大且未启用尺寸匹配，较小的图像会被居中并用零填充而非裁剪。当处理遮罩时，如果输入类型不同（图像 vs. 遮罩），要注意自动类型转换行为。

Image Concatenate 节点源码链接

Image Concatenate 节点来自 ComfyUI-KJNodes 节点包。

Image Concatenate(ImageConcanate)

Image Concanate