> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 图片拼接 (Image Concat)

> 把多张图横排、竖排或按宫格拼成一张，浏览器即时出图，无需 Run。

![图片拼接 (Image Concat)](https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max\&auto=format\&n=dMkMxJDZdIo4YzAU\&q=85\&s=b54171099e5b02d4313fe581171ebbcc)

## 这个节点是做什么的

**Image Concat** 把多张上游图片拼成一张。它有一个可增长的 **images** 输入（最多 12 个槽），
另有一个 **batch** 输入，可直接接 **Grid Split**、**Image Stage** 等输出的整批图片，批量里的每一张都会参与拼接。

节点体内有一条重排条：把缩略图拖成你想要的顺序，该顺序存进隐藏字段 **clip\_order**。
改顺序或参数后约 0.25 秒自动重新拼好，结果作为 `COMFYTV_IMAGE` 供下游使用。

## 适用场景

* 把几张角色设定图、分镜拼成一张对照图。
* 把 **Grid Split** 切开的格子逐个修改后，用同样的列数和间距拼回原图。
* 给多参考图模型准备一张拼好的参考图。

## 参数说明

### 布局（layout）

* **横排**：排成一行，各图按比例缩放到与第一张图同高。
* **竖排**：排成一列，各图按比例缩放到与第一张图同宽。
* **宫格**：每格大小等于第一张图，其他图等比缩放后居中放进格子。

### 列（cols）

宫格布局每行几张。超过图片数时按图片数算。

### 间距（gap）/ 包括外框（outer\_gap）

图片之间的间距，单位是第一张图的像素。勾选「包括外框」后，整张图外缘也留同样宽的边。
与 **Grid Split** 的「边框 / 包括外框」一一对应：用同样的列数和数值，可把切开的格子拼回原尺寸。

### 填充（bg）

间距和宫格空白处的颜色。默认透明；也可选白、黑或自定义颜色。

## 输出说明

| 输出 | 类型 | 含义 |
| - | - | - |
| **image** | `COMFYTV_IMAGE` | 拼好的一张 PNG。 |

## 小贴士

* 顺序取自重排条，而非槽位序号；**batch** 里的图显示为 B1、B2…，单张输入显示为 #0、#1…。
* 浏览器 canvas 单边上限约 16384 像素，拼出的图超过时会整体等比缩小到上限内。

## 相关节点

* **Grid Split**——把一张图切成宫格，是本节点的反操作。
* **Video Concat**——视频版的首尾拼接。
* **Compare**——两张图并排对比，不产出新图。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.