ComfyUI Node: Image Merger

Image Merger:

The ImageMerger node is designed to seamlessly combine two sets of images based on specified dividing points and optional line thickness. This node is particularly useful for AI artists who want to create composite images by merging different visual elements from two image sources. The primary function of the ImageMerger is to blend images along a defined line, allowing for creative and precise control over the merging process. By specifying dividing points, you can determine exactly where and how the images will be combined, resulting in a smooth and visually appealing transition between the two sets of images. This node is ideal for tasks such as creating artistic collages, blending textures, or generating unique visual effects.

Image Merger Input Parameters:

images_1

This parameter represents the first set of images to be merged. It is an array of images that will be combined with the second set of images based on the specified dividing points. The images should be in a compatible format and size for optimal merging results.

images_2

This parameter represents the second set of images to be merged. Similar to images_1, this array of images will be combined with the first set of images. Ensure that the images are in a compatible format and size to achieve the desired merging effect.

divide_points

This parameter is a string that specifies the points at which the images will be divided and merged. The format for this string is "(x1%, y1%);(x2%, y2%)", where each pair of coordinates represents a point on the image. The default value is "(50%, 0);(50%, 100%)", which means the images will be divided vertically in the middle. Adjusting these points allows for creative control over the merging line.

line_thickness

This parameter defines the thickness of the line along which the images will be merged. It is an integer value with a default of 0, meaning no additional line thickness. The minimum value is 0, and the maximum value is 1000, with a step of 1. Increasing the line thickness can create a more pronounced blending effect along the dividing line.

Image Merger Output Parameters:

images

This output parameter represents the merged images resulting from the combination of images_1 and images_2 based on the specified dividing points and line thickness. The merged images will have the same dimensions as the input images and will reflect the blending effect applied.

num_images

This output parameter indicates the number of images in the merged set. It provides a count of the images that have been successfully combined, which can be useful for further processing or validation.

Image Merger Usage Tips:

• To achieve a smooth and visually appealing merge, ensure that the input images (images_1 and images_2) are of the same size and format.
• Experiment with different divide_points to create unique and creative blending effects. For example, diagonal or custom-shaped dividing lines can produce interesting visual results.
• Adjust the line_thickness parameter to control the blending effect along the dividing line. A thicker line can create a more gradual transition between the images, while a thinner line can result in a sharper merge.

Image Merger Common Errors and Solutions:

currently only 2 marks are available.

• Explanation: This error occurs when the number of dividing points specified in the divide_points parameter is not exactly two.
• Solution: Ensure that the divide_points string contains exactly two points in the format "(x1%, y1%);(x2%, y2%)". For example, "(50%, 0);(50%, 100%)".

Invalid input image dimensions

• Explanation: This error occurs when the input images (images_1 and images_2) have different dimensions or incompatible formats.
• Solution: Verify that both sets of input images have the same dimensions and are in a compatible format before merging.

Line thickness out of range

• Explanation: This error occurs when the line_thickness parameter is set to a value outside the allowed range (0 to 1000).
• Solution: Ensure that the line_thickness parameter is set to a value within the range of 0 to 1000. Adjust the value accordingly to achieve the desired blending effect.