Documentation for the ImageComposite+ Node

Overview

The ImageComposite+ node is a part of the ComfyUI Essentials toolkit. It is designed for combining two images into a single composite image, allowing users to integrate a source image onto a destination image at specified coordinates, with optional masking.

Node Functionality

This node facilitates the seamless blending of a source image onto a destination image, offering control over positioning and blending using a mask. This is particularly useful in creative workflows where image elements need to be layered or collaged together.

Inputs

The ImageComposite+ node accepts several inputs:

1. Destination (IMAGE): The main image onto which the source image will be composited.

2. Source (IMAGE): The image to be composited onto the destination image.

3. x (INT): The x-coordinate for the position where the top-left corner of the source image will be placed on the destination image. Default is 0.

4. y (INT): The y-coordinate for the position where the top-left corner of the source image will be placed on the destination image. Default is 0.

5. offset_x (INT): An optional horizontal offset added to the x-coordinate. Default is 0.

6. offset_y (INT): An optional vertical offset added to the y-coordinate. Default is 0.

7. Mask (MASK) (Optional): A mask to determine the blending of the source image with the destination image. Where the mask is present, the source image appears; otherwise, the destination image appears.

Outputs

The ImageComposite+ node produces a single output:

• Composite Image (IMAGE): The resulting image after compositing the source image onto the destination image with the given positional and optional mask inputs.

Use Cases

The ImageComposite+ node can be used in various creative workflows in ComfyUI:

• Layering Elements: Combine logos, watermarks, or graphical elements on a background.

• Collage Creation: Assemble multiple images into a single collage by compositing them at different positions.

• Dynamic Image Blending: Use masks to dynamically blend images together for effects like vignetting or soft transitions.

Special Features and Considerations

• Positioning Flexibility: The node allows users to precisely position the source image on the destination through x, y coordinates and additional offsets, enabling precise control over layout.

• Masking Capability: The optional mask input offers advanced compositing techniques, ensuring that only specific parts of the source image are visible on the destination.

• Batch Processing Considerations: When dealing with batches of images, ensure that the dimensions of the images being composited are managed carefully, especially when using masks, to maintain expected results across the batch.

Using the ImageComposite+ node, creators can streamline their image editing and compositing tasks directly within ComfyUI, enhancing workflows that require blending or layering of visual content.