AILab_ImageCombiner Node Documentation

Overview

The AILab_ImageCombiner node is part of the ComfyUI-RMBG suite, which provides advanced tools for image processing. This specific node is designed to seamlessly combine two images: a foreground image and a background image. It offers various blending modes and adjustable positioning of the foreground image on the background, enabling versatile image composition tasks.

Inputs

The AILab_ImageCombiner node accepts the following inputs:

1. Foreground Image (foreground): The image to be placed on top of the background. This input is mandatory.

2. Background Image (background): The image to serve as the base upon which the foreground image is layered. This input is mandatory.

3. Mode (mode): A dropdown selection for the blending mode between the foreground and background images. The options include:

   • normal: Standard overlay without blending.
   • multiply: Multiplies the foreground and background colors.
   • screen: Opposite of multiply; it inverts, multiplies, and inverts the colors again.
   • overlay: Combination of multiply and screen.
   • add: Adds colors of the two images.
   • subtract: Subtracts the colors of the background image from the foreground.

4. Foreground Opacity (foreground_opacity): A float value between 0.0 and 1.0 controlling the transparency of the foreground image. A value of 1.0 means fully opaque, while 0.0 is fully transparent.

5. Foreground Scale (foreground_scale): A float value to scale the size of the foreground image. Values less than 1.0 shrink the image, while values greater than 1.0 enlarge it.

6. Position X (position_x): An integer between 0 and 100 indicating the horizontal position of the foreground image on the background. The foreground image is centered at this point, calculated as a percentage of the background's width.

7. Position Y (position_y): An integer between 0 and 100 indicating the vertical position of the foreground image on the background. Similar to Position X, it is a percentage of the background's height where the center of the foreground image is placed.

8. Foreground Mask (foreground_mask): An optional mask for the foreground image to define which areas of the foreground should be visible and which should be transparent.

Outputs

The AILab_ImageCombiner node produces the following outputs:

1. Combined Image (IMAGE): The resulting image after combining the foreground and background images according to the specified blending mode, opacity, scale, and position.

2. Image Width (WIDTH): The width of the resulting combined image.

3. Image Height (HEIGHT): The height of the resulting combined image.

Usage in ComfyUI Workflows

The AILab_ImageCombiner node is a powerful tool in any ComfyUI workflow that involves image composition. Here are some typical use cases:

• Graphic Design and Photo Editing: Integrate it into workflows to add custom graphics or images (e.g., logos or watermarks) to a base image. Utilize the blending modes to achieve artistic effects.

• Image Collage Creation: Use it repeatedly with different settings to overlay multiple images into a single composition.

• Product Showcase: Layer product images over different background scenes for advertising or catalog purposes.

• Visual Storytelling: Combine visual elements in a narrative sequence, where foreground elements (e.g., characters, text elements) can be dynamically placed and styled over backgrounds.

Special Features and Considerations

1. Multiple Blending Modes: The node supports various artistic and photorealistic blending modes, giving users freedom to achieve specific visual effects.

2. Precision Positioning: The node allows exact control over the positioning of the foreground image with percentage-based coordinates, enabling intricate composite designs.

3. Adjustable Opacity: Foreground image transparency can be finely tuned, facilitating subtle or pronounced image overlays.

4. Foreground Mask Support: Allows users to selectively show parts of the foreground image, adding flexibility and precision, especially useful in complex compositions.

5. Dynamic Rescaling: The node automatically adjusts the size of the foreground image relative to the background, based on the user-defined scale factor, ensuring seamless integration into larger images.

Overall, the AILab_ImageCombiner node is a versatile component within ComfyUI, essential for detailed and creative image processing tasks.