ComfyUI Node: Bounded Image Blend with Mask

Bounded Image Blend with Mask:

The Bounded Image Blend with Mask node is designed to seamlessly blend a source image into a target image within specified bounds, using a mask to control the blending process. This node is particularly useful for AI artists who want to integrate elements from one image into another with precision and control. By defining the target bounds and applying a mask, you can ensure that the blending occurs only within the desired area, creating a smooth transition between the images. The node also supports feathering, which applies a Gaussian blur to the mask edges, resulting in a more natural and gradual blend. This functionality is ideal for tasks such as compositing, where you need to merge different visual elements while maintaining a cohesive and aesthetically pleasing result.

Bounded Image Blend with Mask Input Parameters:

target

The target parameter represents the main image onto which the source image will be blended. This image serves as the canvas for the blending operation.

target_mask

The target_mask parameter is an image that defines the areas of the target image where the blending will occur. The mask controls the transparency and blending intensity, with white areas representing full blending and black areas representing no blending.

target_bounds

The target_bounds parameter specifies the rectangular area within the target image where the blending will take place. This is defined by the coordinates of the top-left and bottom-right corners of the rectangle.

source

The source parameter is the image that will be blended into the target image. This image will be resized and positioned according to the target bounds and mask.

blend_factor

The blend_factor parameter controls the intensity of the blending between the source and target images. It is a float value ranging from 0.0 to 1.0, where 0.0 means no blending and 1.0 means full blending. The default value is 0.5.

feathering

The feathering parameter applies a Gaussian blur to the edges of the mask, creating a smooth transition between the blended and non-blended areas. It is a float value that determines the radius of the blur. A higher value results in a more gradual blend.

Bounded Image Blend with Mask Output Parameters:

IMAGE

The output is the resulting image after the blending operation. This image combines the source and target images within the specified bounds, using the mask and blend factor to control the blending intensity and feathering to smooth the edges.

Bounded Image Blend with Mask Usage Tips:

• To achieve a seamless blend, ensure that the target_mask accurately represents the area where you want the blending to occur. Use a soft-edged mask for a more natural transition.
• Adjust the blend_factor to control the intensity of the blending. A lower value will make the source image less prominent, while a higher value will make it more dominant.
• Use the feathering parameter to smooth the edges of the blend. This is particularly useful when blending images with different textures or colors.

Bounded Image Blend with Mask Common Errors and Solutions:

"Mask size does not match target size"

• Explanation: This error occurs when the dimensions of the target_mask do not match the dimensions of the target image.
• Solution: Ensure that the target_mask is the same size as the target image or use the node's functionality to resize the mask accordingly.

"Invalid blend factor"

• Explanation: This error occurs when the blend_factor is set to a value outside the allowed range of 0.0 to 1.0.
• Solution: Adjust the blend_factor to a value within the range of 0.0 to 1.0.

"Feathering value too high"

• Explanation: This error occurs when the feathering value is set too high, causing excessive blurring.
• Solution: Reduce the feathering value to achieve a more controlled and subtle blur effect.