MaskBlur+ Node Documentation

Overview

The MaskBlur+ node, part of the ComfyUI Essentials package, allows users to apply a Gaussian blur effect to a mask. Gaussian blurring is a commonly used technique in image processing where the sharp edges are smoothed by averaging the pixel values. This node offers flexibility in choosing the degree of blurring and the device (CPU or GPU) for processing, making it a valuable tool in workflows involving mask manipulation and processing within ComfyUI.

Inputs

The MaskBlur+ node accepts the following inputs:

1. Mask

   • Type: MASK
   • Description: The input mask that you want to apply the Gaussian blur effect to. Masks are typically binary or grayscale images used to isolate regions in an image processing workflow.

2. Amount

   • Type: Integer
   • Default: 6
   • Description: The amount of blur to apply to the mask. This value determines the size of the pixel neighborhood used for averaging, and consequently, the intensity of the blur effect.
   • Range: 0 to 256
   • Special Note: A value of 0 means no blurring will be applied. The amount must be an odd number.

3. Device

   • Type: Choice (auto, cpu, gpu)
   • Description: Specifies which device to use for performing the blurring operation.
   • Options:
     • auto: Automatically select the appropriate device.
     • cpu: Force the operation to be performed on the CPU.
     • gpu: Force the operation to be performed on the GPU.

Outputs

The MaskBlur+ node produces the following output:

1. Mask
   • Type: MASK
   • Description: The resulting mask after applying the Gaussian blur. This mask will have the same dimensions as the input mask but with the specified amount of blur applied.

Usage

In a typical ComfyUI workflow, the MaskBlur+ node can be used to:

• Smooth Noise: Reduce noise in a binary mask where irregular edges can cause processing artifacts.
• Enhance Effects: Soften hard edges of a selection in an image to allow for smoother transitions or blending with other layers.
• Preprocess Masks: Prepare masks for further operations by smoothing transitions and making shapes more cohesive.

Here's a simple use case example:

• Import an image into ComfyUI, and generate a mask.
• Use MaskBlur+ to blur the edges of the mask.
• Apply the blurred mask onto the original image or blend it with another image for creative effects.

Special Features and Considerations

• Automatic Device Selection: The node can automatically choose between CPU and GPU for processing, optimizing for performance based on available hardware.
• Edge Case Handling: The node ensures that the amount parameter is always an odd number for the Gaussian blur function to work correctly. If an even number is specified, it is automatically adjusted to the next odd integer.
• Performance Optimization: Utilizing GPU processing can significantly speed up operations on large masks or when high levels of blur are applied.

To get the latest updates or report issues, visit the ComfyUI Essentials GitHub repository.