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

Image Plot - Arrange images by layout

Node Purpose: Image Plot arranges images in a horizontal, vertical, or grid layout. Also supports a video-collection style input (list of batches) to produce frame-wise collages across multiple sequences. When inputs contain alpha, the node processes the canvas in RGBA and preserves alpha automatically.

Inputs

Name	Port	Type	Default	Range	Description
image	-	IMAGE or LIST	-	-	Input image batch or a list of batches for video-collection display.
layout	-	COMBO	horizontal	horizontal/vertical/grid	Arrangement mode.
spacing	-	INT	10	0–1000	Space between images.
grid_columns	-	INT	2	1–100	Number of columns when using grid.
background_color	-	STRING	1.0	Gray/HEX/RGB; also supports R,G,B,A and #RRGGBBAA for RGBA output	Background color for both the canvas and spacing regions; when left empty under RGBA output, it becomes transparent.

Outputs

Name	Type	Description
image	IMAGE	Combined image batch; RGB inputs stay RGB, while RGBA inputs or alpha-containing video collections automatically preserve RGBA.

Features

• Standard plotting: converts batch frames to PIL, arranges per layout, and returns a single composed image.
• Video collection: accepts a Python list of batches and builds per-frame collages across groups, preserving device and dtype.
• Size normalization: bilinear resize to the minimal common size across images for clean alignment.
• Color parsing: supports gray (0.0–1.0), HEX (#RRGGBB), and R,G,B integer tuples.
• Alpha rule: if any input frame contains alpha, the canvas is created in RGBA and transparency is preserved.
• Background rule: background_color controls both the canvas and the spacing regions.
• Transparency rule: RGBA output uses a transparent background only when background_color is empty or explicitly set to values like transparent / none.
• Color rule: under RGBA output, ordinary gray/HEX/RGB values fill with the corresponding opaque color; if you need custom transparency, pass R,G,B,A or #RRGGBBAA.
• Source alpha protection: background_color only fills non-image rectangular areas and does not overwrite transparency already present inside the original images.

Typical Usage

• Create a side-by-side comparison: set layout=horizontal and adjust spacing.
• Stack vertically: set layout=vertical to form a column.
• Build grids: set layout=grid and tune grid_columns for tiled views.
• Show multiple sequences: pass a list of batches to produce a frame-aligned collage across inputs.

Notes & Tips

• Video-collection detection is based on Python list input; tensor input is treated as a single batch.
• Output tensor uses channels-last layout and clamps to [0,1].