1hew-ComfyUI-1hewNodes/web/docs/1hew_ImagePlot/zh.md

Image Plot - 图像布局拼接

节点功能：Image Plot 支持将图像水平、垂直或网格化排列。兼容列表格式的视频收集输入，构建跨批次的逐帧拼接视图。

Inputs | 输入

参数名称	入端选择	数据类型	默认值	取值范围	描述
image	-	IMAGE 或 LIST	-	-	输入图像批次；或多个批次组成的列表，用于视频收集显示
layout	-	COMBO	horizontal	horizontal/vertical/grid	拼接布局模式
spacing	-	INT	10	0–1000	图像之间的间距
grid_columns	-	INT	2	1–100	网格模式下的列数
background_color	-	STRING	1.0	灰度/HEX/RGB	画布背景色

Outputs | 输出

输出名称	数据类型	描述
image	IMAGE	合成图像批次；视频收集输入下输出序列批次（T×H×W×3）

功能说明

• 标准拼接：将批次帧转换为 PIL，按 layout 排列后返回单张合成图像。
• 视频收集：接受批次列表输入，跨组进行帧对齐的并列拼接，保留设备与数据类型。
• 尺寸归一：对输入图片进行双线性至最小公共尺寸，确保对齐整齐。
• 颜色解析：支持灰度值（0.0–1.0）、HEX（#RRGGBB）与整数 R,G,B。

典型用法

• 并排对比：设置 layout=horizontal 并调整 spacing。
• 垂直堆叠：设置 layout=vertical，形成列式视图。
• 网格展示：设置 layout=grid 并调 grid_columns 实现平铺。
• 多序列显示：传入批次列表，逐帧拼接各输入以观察时间一致性。

注意与建议

• 视频收集判定基于 Python 列表输入；张量输入视为单个批次。
• 输出为末通道张量并限制在 [0,1] 范围。