ComfyUI Node: Create Grid Image

Create Grid Image:

The Create Grid Image node is designed to generate a composite image by arranging multiple images into a grid format. This node is particularly useful for creating visual summaries or collages from a collection of images. By specifying various parameters, you can control the number of columns, the size of each cell, and the appearance of borders around each image. This functionality is beneficial for artists who want to present multiple artworks in a single, organized layout, making it easier to compare and showcase their work.

Create Grid Image Input Parameters:

images_path

This parameter specifies the directory path where the images to be included in the grid are located. It is crucial to ensure that the path exists and contains the images you want to use. If the path does not exist, the node will not execute properly. There is no default value for this parameter, and it must be provided by the user.

pattern_glob

This parameter allows you to define a pattern to match specific files within the directory. By default, it is set to "*", which means all files will be considered. You can use this to filter images based on their names or extensions.

include_subfolders

This parameter determines whether to include images from subfolders within the specified directory. It accepts "true" or "false" as values, with the default being "false". Setting it to "true" will recursively search for images in all subdirectories.

number_of_columns

This parameter sets the number of columns in the grid. The default value is 6. Adjusting this value will change the layout of the grid, affecting how many images are placed in each row.

max_cell_size

This parameter defines the maximum size of each cell in the grid, in pixels. The default value is 256. This ensures that images are resized to fit within the specified dimensions, maintaining a uniform appearance.

border_width

This parameter specifies the width of the border around each image, in pixels. The default value is 3. Setting this to 0 will remove the border entirely.

border_red

This parameter sets the red component of the border color. The default value is 0. It ranges from 0 to 255, where 0 is no red and 255 is full red.

border_green

This parameter sets the green component of the border color. The default value is 0. It ranges from 0 to 255, where 0 is no green and 255 is full green.

border_blue

This parameter sets the blue component of the border color. The default value is 0. It ranges from 0 to 255, where 0 is no blue and 255 is full blue.

Create Grid Image Output Parameters:

IMAGE

The output is a single composite image in tensor format, representing the grid of images. This output can be used for further processing or directly saved and viewed. The grid image will have the specified number of columns, cell sizes, and border properties as defined by the input parameters.

Create Grid Image Usage Tips:

• Ensure that the images_path is correct and contains the images you want to include in the grid.
• Use the pattern_glob parameter to filter specific types of images, such as ".jpg" or ".png".
• Adjust the number_of_columns to change the layout of your grid, depending on how many images you have and how you want them displayed.
• Set include_subfolders to "true" if your images are organized in subdirectories and you want to include them all.
• Modify the max_cell_size to ensure all images fit well within the grid without being too large or too small.
• Customize the border color using the border_red, border_green, and border_blue parameters to match your desired aesthetic.

Create Grid Image Common Errors and Solutions:

The grid image path <images_path> does not exist!

• Explanation: The specified directory path does not exist or is incorrect.
• Solution: Verify that the images_path is correct and points to an existing directory containing the images you want to use.

No images found matching the pattern

• Explanation: No images in the specified directory match the pattern_glob.
• Solution: Check the pattern_glob parameter to ensure it correctly matches the filenames of the images you want to include.

Invalid value for include_subfolders

• Explanation: The include_subfolders parameter must be either "true" or "false".
• Solution: Ensure that the include_subfolders parameter is set to either "true" or "false".

Border color values out of range

• Explanation: The values for border_red, border_green, and border_blue must be between 0 and 255.
• Solution: Adjust the border color values to be within the valid range of 0 to 255.