ComfyUI > Nodes > kaytool > 𝙆 Image Composer

ComfyUI Node: 𝙆 Image Composer

Class Name

Image_Composer

Category
KayTool/Image
Author
kk8bit (Account age: 1010days)
Extension
kaytool
Latest Updated
2026-04-06
Github Stars
0.34K

How to Install kaytool

Install this extension via the ComfyUI Manager by searching for kaytool
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter kaytool in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

𝙆 Image Composer Description

Blends two images with masks for seamless composites, controlling position and transparency.

𝙆 Image Composer:

The Image_Composer node is designed to seamlessly blend two images together, allowing you to create composite images with ease. This node is particularly useful for AI artists who want to merge different visual elements into a single cohesive image. By specifying the position of the images, you can control how they are layered, whether it's top, bottom, left, or right. The node also supports the use of masks, which can help in defining the transparency and blending areas between the images. This functionality is essential for creating complex compositions where certain parts of an image need to be highlighted or hidden. The Image_Composer node simplifies the process of image compositing, making it accessible even to those with minimal technical expertise, while still offering the flexibility needed for more advanced projects.

𝙆 Image Composer Input Parameters:

image_a

This parameter represents the first image to be used in the composition. It is the primary image that will be placed according to the specified position. The image should be provided as a tensor, and it will be converted to a PIL image for processing. The size of this image will influence the final dimensions of the composite image.

mask_a

This optional parameter is a mask for the first image, which defines the transparency levels across the image. If not provided, a default mask with no transparency is used. The mask should be a tensor, and it will be resized to match the dimensions of image_a.

image_b

This parameter is the second image to be used in the composition. It will be placed relative to image_a based on the specified position. Like image_a, this image should be provided as a tensor and will be resized to fit the composition.

position

This parameter determines the relative positioning of image_b with respect to image_a. It accepts values such as "top", "bottom", "left", and "right". This choice affects how the images are layered and combined in the final output.

mask_b

This optional parameter is a mask for the second image, similar to mask_a. It defines the transparency levels for image_b. If not provided, a default mask with no transparency is used. The mask will be resized to match the dimensions of image_b.

𝙆 Image Composer Output Parameters:

data

This output provides metadata about the composition, including the positions and sizes of both images within the composite. It is useful for understanding how the images were arranged and can be used for further processing or analysis.

composed_image_tensor

This output is the final composite image, represented as a tensor. It combines image_a and image_b according to the specified position and masks, resulting in a single cohesive image.

mask_out_tensor

This output is the combined mask of the composite image, represented as a tensor. It reflects the transparency levels across the entire composition, taking into account both mask_a and mask_b.

𝙆 Image Composer Usage Tips:

  • Ensure that both images are of compatible sizes or use the node's resizing capabilities to fit them together seamlessly.
  • Utilize masks to create smooth transitions between images, especially when blending different backgrounds or textures.
  • Experiment with different positions to achieve the desired visual effect, such as placing an object in the foreground or background.

𝙆 Image Composer Common Errors and Solutions:

Image size mismatch

  • Explanation: This error occurs when the images are not compatible in size for the specified position.
  • Solution: Ensure that both images are resized appropriately before composition, or let the node handle resizing by providing images with similar dimensions.

Mask dimension error

  • Explanation: This error arises when the mask dimensions do not match the corresponding image dimensions.
  • Solution: Verify that the masks are resized to match the dimensions of their respective images before inputting them into the node.

𝙆 Image Composer Related Nodes

Go back to the extension to check out more related nodes.
kaytool
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.