跳转至

MergeImages 多图排版拼接与画廊画册合并节点

节点核心功能 (What is it?)

MergeImages 节点允许创作者利用多种灵活的排版布局样式，将多张图像合并为一个统一、协调的复合构图作品。无论是创建规则网格、横向/纵向长图序列，还是打造类似 Pinterest 风格的不等高瀑布流（Masonry），该节点都能提供工业级的自动间距排布与圆角边框美化能力。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 制作照片拼图、多图格画廊或画册组合；
  • 将一系列具有关联性的图像（如同一角色的多角度三视图）整合成一张单图；
  • 制作图像马赛克图案或多图矩阵；
  • 搭建设计作品集、美术概念展示板或 Moodboard；
  • 将多张生成变体并列排列以便进行横向视觉评审与比对；
  • 制作社交媒体宣传九宫格或长图排版；
  • 生成基于图形的可视化演示汇报素材。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 MergeImages 节点。
  2. 将多个图像数据源同时接入 input_images 输入插槽。
  3. 选择所需的排版布局方式（layout_style）与对齐排布参数。
  4. 在 output 引脚即可提取排版合并完成的全新图像资产。

参数输入插槽 (Parameters)

图像源输入 (Image Input)

  • input_images：待合并的图像列表（支持同时接入来自多个图像节点的连线）。

排版布局配置 (Layout Settings)

  • layout_style：图像排布的视觉拓扑样式：
    • grid：具有等大单元格的标准规则网格矩阵；
    • horizontal：单行水平横向排列（横向拼接长图）；
    • vertical：单列垂直纵向排列（纵向信息流长图）；
    • masonry：类似 Pinterest 的瀑布流布局（自适应不同子图的原始高宽比，消除垂直大面积空隙）。
  • columns（1–10，默认 3）：在 grid（网格）模式下指定的列数。
  • spacing（像素，0–50，默认 10）：子图与子图之间的物理间隙距离。

样式与外观选项 (Styling Options)

  • background_color（十六进制颜色代码，默认 #ffffff 纯白）：合成后大底图的留白衬底颜色。
  • border_radius（像素，0–20，默认 0）：各子图像边框的圆角曲率半径。
  • padding（像素，0–100，默认 20）：整幅合成画面外边缘与内部图片之间的内边距。

输出引脚 (Outputs)

  • output：将所有输入图像依设定规则排版、施加边距与圆角后生成的全新复合图像工件（ImageArtifact）。

典型工作流示例 (Example)

典型的多图网格排版工作流：

  1. 使用多个 LoadImage 节点分别导入需要组合的素材图片。
  2. 将这些节点的输出统一连接至 MergeImages 节点的 input_images 参数。
  3. 设定布局属性：
    • 将 layout_style 设为 "grid"；
    • 将 columns 设为 2（双列并排）；
    • 将 spacing 设为 15 像素，获得清晰舒适的图间间距。
  4. 定制整体外观：
    • 将 background_color 设为 "#f0f0f0"（浅灰底色）；
    • 将 border_radius 设为 5，为各图片赋予细腻微小的圆角；
    • 将 padding 设为 30，为整图四周留出大气的保护留白。
  5. 将 output 引脚连接至 DisplayImage 查看精美的画板成果。

关键技术特性 (Important Notes)

  • 多元化拓扑架构 (Flexible Layout)：支持网格、横向行、垂直列与瀑布流四种主流设计规范。
  • 自适应空间对齐 (Automatic Arrangement)：节点自动解算并适配输入图片的长宽比，在保持纵横比不失真的前提下规整排列。
  • 全方位视觉定制：深度支持背景色彩、图间间距（Spacing）、全局内边距（Padding）与子图圆角（Border Radius）。
  • 多源图层弹性承载：支持处理任意数量的输入图像资产。

常见问题与排查 (Common Issues)

  • 画面没有出现图片：确认是否已将上游图像节点的输出连入 input_images 列表参数。
  • 布局局促或重叠：根据图像总数与分辨率，适当调大 spacing、padding 或调整 columns 列数。
  • 各子图过小：尝试减少 columns 列数，或在输入前提升各源图的原始分辨率。

底层技术执行细节 (Technical Details)

在合成过程中，该节点自动执行以下算子：

  • 动态尺寸计算：根据所有子图规格与所选的布局引擎，推算最优的大画布总物理尺寸；
  • 纵横比非破坏性保持：在规整单元格尺寸的同时，严格锁定原图宽高比，杜绝拉伸畸变；
  • 抗锯齿几何遮罩：当设定 border_radius > 0 时，自动在内存中为每张图片计算并施加抗锯齿圆角 Alpha 蒙版；
  • 高位深光栅化压合：以统一的色彩空间将所有元素压印至指定底色的大画布中。