ImageBash 多图拼贴与画布合成排版节点
节点核心功能 (What is it?)
ImageBash 节点允许创作者将多张图片自动排版并合成到一个统一的独立物理画布中。它是制作多图拼贴（Collage）、图片矩阵网格、情绪板（Moodboard）以及具有自定义画布分辨率与背景衬底的集成式构图作品的理想工具。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 制作照片拼贴海报或自适应网格组合；
- 将多个分立图层合并为一张完整的视觉合成稿；
- 制作图像马赛克或纹理规律排布；
- 快速搭建美术作品集或概念图画廊；
- 将相关联的变体设计图并置用于横向视觉对比；
- 生成符合主流社交媒体规格的多图信息流配图；
- 制作基于图文混合的视觉演示文稿。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 ImageBash 节点。
- 将多个图像数据源同时连接至
input_images输入插槽列表。 - 设定所需的画布规格（
canvas_size）或自定义尺寸，并指定底色。 - 在
output_image输出引脚即可提取排版合成完成的大图。
参数输入插槽 (Parameters)
画布规格与配置 (Canvas Settings)
- canvas_size：输出画布的目标分辨率规格预设：
- Custom：完全自定义输入物理宽高；
- HD：1280×720 高清规格；
- Full HD：1920×1080 全高清规格；
- 4K：3840×2160 超高清规格；
- Square：1024×1024 正方形画幅；
- Instagram Post：1080×1080 社交媒体方形贴文规格；
- Instagram Story：1080×1920 移动端全屏竖屏故事规格。
- width（像素，默认 1920）：自定义画布宽度（仅在
canvas_size选为"Custom"时生效）。 - height（像素，默认 1080）：自定义画布高度（仅在
canvas_size选为"Custom"时生效）。 - background_color（十六进制颜色代码，默认
#ffffff纯白）：画布空白区域的填充底色。
图像源输入 (Image Input)
- input_images：待合成与排版的输入图像列表（支持同时接入多个上游图像节点）。
输出引脚 (Outputs)
- output_image：将所有输入图像自适应排版合成后的完整工件大图。
典型工作流示例 (Example)
典型的多图拼贴流程：
- 使用多个
LoadImage节点分别导入需要展示的图片素材。 - 将所有图像输出依次连接至
ImageBash节点的input_images插槽。 - 配置画布环境：
- 将
canvas_size选择为"Full HD"以获得 1920×1080 标准高清输出； - 将
background_color设为"#f0f0f0"（浅灰底色）。
- 将
- 节点将自动依据算法将各图像优雅停靠排列在画布中。
- 将
output_image接入DisplayImage节点实时监看预览结果。
关键技术特性 (Important Notes)
- 智能自动排版 (Automatic Layout)：节点底层依据图像数量与画布宽高比自动计算最佳平铺与分布坐标，无需手动调配定位。
- 灵活的画布规格 (Flexible Canvas)：既提供覆盖影视与社交网络的主流预设，又支持任意物理像素的自由定制。
- 全局底色调控 (Background Control)：对拼合留白间隙支持任意色彩与纯色衬底填充。
- 多源图层弹性承载：支持接入任意数量的输入图像资产列表。
常见问题与排查 (Common Issues)
- 画面完全空白未见图片：确认上游图像引脚是否已正确接入
input_images列表插槽。 - 合成图内素材尺寸过小：可尝试调大画布预设尺寸，或检查输入源图本身的物理分辨率。
- 背景颜色不匹配：通过修改
background_color参数十六进制代码即可即时更换背景底色。
底层技术执行细节 (Technical Details)
节点执行时严格遵循以下四个处理阶段：
- 画布构建 (Canvas Creation)：根据指定的分辨率与背景颜色在内存中开辟全新高位深图层。
- 位置解算与排布 (Image Arrangement)：自动解算各子图的纵横比与缩放因子，计算最佳停靠矩阵。
- 分层合成 (Compositing)：将所有源图像顺序光栅化写入到目标画布的对应锚点中。
- 图像输出 (Output Generation)：执行色彩矩阵压制并输出无损、高解析度的最终合成工件。