DisplayImageGrid 多图网格画廊与预设画幅排版节点
节点核心功能 (What is it?)
DisplayImageGrid 节点支持将多张离散输入的图像按规则网格（Grid）或错落瀑布流（Masonry）排版引擎自动拼接成高品质的复合展示图。它提供了包括对齐停靠（Justification）、边角圆角、背景透明度、间距控制以及直接适配工业标准视频分辨率（4K、1440p、1080p、720p）的强大导出规格。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 制作专业级作品画廊、情绪板（Moodboard）或设计作品集；
- 集中展示多模型、多 Prompt 批量生图的成果图谱（Contact Sheet）；
- 横向并排罗列多版本演化结果供团队评审；
- 生成规整的九宫格拼图或社交媒体长图；
- 导出直接适配主流高清视频与演示画幅规格（4K/1080p 等）的拼图成果。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在画布中添加 DisplayImageGrid 节点。
- 将多张输入图像汇聚连接至
images输入插槽。 - 配置排版模式（网格或瀑布流）、列数与样式外观。
- 选定目标输出规格模式（自定义物理宽度或标准视频预设）。
- 在
output引脚即可提取排版完成的高清拼图大图。
参数输入插槽 (Parameters)
图像源输入 (Image Input)
- images：待排版的源图像列表（
list[ImageArtifact]或list[ImageUrlArtifact]）。
布局排版控制 (Layout Settings)
- layout_style：图像排版拓扑风格：
- grid：规整网格矩阵，各单元格尺寸一致；
- masonry：类似 Pinterest 的自适应多列瀑布流，自适应图幅高矮。
- grid_justification（仅限 grid 网格模式）：未排满尾行的水平停靠对齐规则：
- left（默认）：靠左对齐；
- center：居中对齐；
- right：靠右对齐。
- columns（1–10，默认 4）：排版列数。
- spacing（0–100 像素，默认 10）：子图之间的物理间隙。
视觉样式微调 (Styling Options)
- crop_to_fit（布尔值，默认
true）：是否自动裁切以严丝合缝填充单元格边界。 - transparent_bg（布尔值，默认
false）：是否使用纯透明背景替代实色背景。 - background_color（十六进制颜色，默认
#000000纯黑）：网格留白背景底色。 - border_radius（0–500 像素，默认 8）：子图倒角圆角半径（0 为直角）。
导出画幅规格 (Output Settings)
- output_image_size：输出画幅控制模式：
- custom：基于物理宽度自定义；
- preset：按标准视频分辨率导出。
- output_image_width（默认 1200 px）：自定义模式下的最大物理宽度。
- output_preset：工业标准视频画幅预设：
- 4K (3840x2160)：Ultra HD 超高清画幅；
- 1440p (2560x1440)：Quad HD 2K 规格；
- 1080p (1920x1080)：Full HD 1080p 规格；
- 720p (1280x720)：HD 标清规格。
- output_format：编码导出格式（
png最佳画质与透明度、jpeg小巧高压缩、webp现代高效）。
输出引脚 (Outputs)
- output：排版渲染完成的全新复合画廊大图（
ImageUrlArtifact）。
典型工作流示例 (Example)
批量生图制作 1080p 成果展示板：
- 通过批量
GenerateImage节点产出一组创意概念图。 - 将所有图像引流汇聚至
DisplayImageGrid的images插槽。 - 设定布局参数：
layout_style设为grid；grid_justification设为center；columns设为4；spacing设为10。
- 设定视觉风格与规格：
background_color设为#000000；border_radius设为8；- 开启
crop_to_fit； output_image_size选为preset，指定1080p (1920x1080)。
- 节点将精准输出一张分辨率严格为 1920×1080 的高保真展示图板。
关键技术特性 (Important Notes)
- 等比保真无畸变：当启用预设分辨率时，算法以保持图像自身长宽比为第一原则进行等比收束适配，仅通过背景留白 Padding 填充多余视口，绝不强行拉伸挤压。
- 末行动态居中：在非满额子图排版中，
center对齐能彻底根除传统网格尾行右侧大面积空洞的视觉失衡问题。 - 全格式透明通道支持：选择
png格式并启用transparent_bg时，留白区域将输出完全透明的 Alpha 通道，便于导入合成软件叠加在视频轨上。