ImageConcanate Node Documentation

Overview

The ImageConcanate node is part of the ComfyUI environment and forms part of the KJNodes collection. This node provides a functionality for image processing whereby it concatenates two images, image2 to image1, in a specified direction. The concatenation can be adjusted such that the size of the images matches, depending on the configuration settings.

Functionality

The ImageConcanate node handles two main tasks:

1. Concatenates image2 to image1 based on a user-specified direction.
2. Offers the option to resize image2 to match the dimensions of image1 if necessary.

Inputs

The ImageConcanate node accepts the following inputs:

• image1: The first image to which the second image (image2) will be concatenated.
• image2: The second image that will be concatenated to the first image (image1).
• direction: Specifies the direction in which image2 should be concatenated to image1. The available directions are:
  • right: Concatenates image2 to the right of image1.
  • down: Concatenates image2 below image1.
  • left: Concatenates image2 to the left of image1.
  • up: Concatenates image2 above image1.
• match_image_size: A boolean value that, when set to True, resizes image2 to match the size of image1 before concatenation, preserving the aspect ratio. If set to False, the images are concatenated as they are.

Outputs

The ImageConcanate node produces the following output:

• image: The resultant image after the concatenation operation is performed according to the specified direction and size matching configuration.

Usage in Workflows

In ComfyUI workflows, the ImageConcanate node can be utilized for a variety of image processing tasks where arranging multiple images in a specific configuration or layout is necessary. This might include:

• Creating composite images from a series of source images.
• Arranging images for visualization purposes.
• Preparing images for further processing by combining them into a single image.

Special Features and Considerations

• Adaptive Size Matching: The node offers an option to resize image2 to maintain a seamless concatenation with image1, which is useful for operations where alignment and consistent sizing are crucial.
• Flexible Concatenation Directions: Users can define the orientation of the concatenation, allowing for customizable image layouts.
• Batch Handling: The function automatically adjusts batch sizes to ensure that concatenations are performed consistently across multiple image pairs.
• Aspect Ratio Preservation: When match_image_size is enabled, resizing is performed with an emphasis on maintaining the aspect ratio of image2.

This node is an asset in workflows necessitating the combination of two images and can serve as a foundational utility for complex image manipulations and presentations within the ComfyUI system.