ComfyUI Node: ImageBlur

ImageBlur:

The ImageBlur node is designed to apply a Gaussian blur effect to an image, which can help in reducing noise and detail, creating a smoother and softer appearance. This node is particularly useful in various artistic and image processing tasks where you want to achieve a dreamy or out-of-focus effect. By adjusting the blur radius and sigma, you can control the intensity and spread of the blur, allowing for a wide range of creative possibilities. The Gaussian blur method ensures that the transition between blurred and non-blurred areas is smooth and natural, making it a preferred choice for high-quality image processing.

ImageBlur Input Parameters:

image

This parameter represents the input image that you want to apply the blur effect to. The image should be in a tensor format, typically with dimensions corresponding to batch size, height, width, and channels.

blur_radius

The blur radius determines the size of the area around each pixel that will be considered for blurring. A larger radius results in a more pronounced blur effect, as it includes more neighboring pixels in the calculation. The minimum value is 0, which means no blur, and there is no strict maximum value, but practical values usually range from 1 to 50. The default value is often set to a moderate level to provide a noticeable but not overwhelming blur.

sigma

Sigma is the standard deviation of the Gaussian distribution used in the blur process. It controls the spread of the blur effect; a higher sigma value results in a wider and softer blur. The minimum value is typically a small positive number, such as 0.1, and there is no strict maximum, but values usually range from 0.1 to 10. The default value is chosen to balance performance and visual quality.

ImageBlur Output Parameters:

blurred_image

The output is the blurred version of the input image. This image retains the same dimensions as the input but with the applied Gaussian blur effect. The blurred image can be used directly in your artwork or as a base for further processing.

ImageBlur Usage Tips:

• Experiment with different blur_radius and sigma values to achieve the desired level of smoothness and softness in your images.
• Use a smaller blur_radius for subtle effects and a larger radius for more dramatic, dreamy looks.
• Combining the ImageBlur node with other nodes like ImageSharpen can create interesting artistic effects by balancing sharp and soft areas in your image.

ImageBlur Common Errors and Solutions:

ValueError: Invalid blur_radius value

• Explanation: This error occurs when the blur_radius parameter is set to a negative value or a non-integer.
• Solution: Ensure that the blur_radius is a non-negative integer. Adjust the value to be within the practical range, typically between 1 and 50.

ValueError: Invalid sigma value

• Explanation: This error occurs when the sigma parameter is set to a non-positive value.
• Solution: Ensure that sigma is a positive number. Adjust the value to be within the practical range, typically between 0.1 and 10.

RuntimeError: Input image tensor is not on the correct device

• Explanation: This error occurs when the input image tensor is not on the same device as the processing operations.
• Solution: Ensure that the input image tensor is moved to the correct device (e.g., GPU) before processing. Use the .to(device) method to move the tensor to the appropriate device.

RuntimeError: Input image tensor has incorrect dimensions

• Explanation: This error occurs when the input image tensor does not have the expected dimensions (batch size, height, width, channels).
• Solution: Ensure that the input image tensor has the correct dimensions. Reshape or adjust the tensor as needed to match the expected format.