ComfyUI Node: Guided Filter Image

Guided Filter Image:

The GuidedFilterImage node is designed to enhance the quality and detail of images by applying a guided filter. This filter uses a guidance image to influence the filtering process, allowing for edge-preserving smoothing and detail enhancement. The guided filter is particularly useful in scenarios where you want to smooth an image while maintaining sharp edges, such as in image denoising, HDR compression, and detail enhancement. By leveraging the guidance image, the filter can effectively distinguish between noise and important features, resulting in a more visually appealing output.

Guided Filter Image Input Parameters:

images

This parameter represents the input image(s) that you want to filter. The images should be in a format that the node can process, typically a tensor or array of image data.

guide

The guide parameter is the guidance image that influences the filtering process. This image helps the filter to preserve edges and important details while smoothing other areas. The guide image should be of the same dimensions as the input images.

size

The size parameter controls the radius of the filter. It determines the extent of the area around each pixel that the filter considers. A larger size results in more smoothing, while a smaller size preserves more detail. The value ranges from 0 to 1023, with a default of 4.

sigma

The sigma parameter affects the sensitivity of the filter to differences in intensity. A higher sigma value results in more aggressive smoothing, while a lower value preserves more detail. The value ranges from 0.01 to 100.0, with a default of 0.1 and a step size of 0.01.

Guided Filter Image Output Parameters:

IMAGE

The output is the filtered image, which has undergone the guided filtering process. This image retains important details and edges while reducing noise and smoothing other areas, resulting in a visually enhanced version of the input image.

Guided Filter Image Usage Tips:

• For subtle smoothing while preserving details, use a smaller size value and a lower sigma value.
• If you need more aggressive noise reduction, increase the size and sigma values, but be cautious as this may also reduce important details.
• Use a high-quality guidance image that closely matches the content of the input image for the best results.

Guided Filter Image Common Errors and Solutions:

ValueError: Size parameter out of range

• Explanation: This error occurs when the size parameter is set outside the allowed range of 0 to 1023. - Solution: Ensure that the size parameter is within the specified range.

ValueError: Sigma parameter out of range

• Explanation: This error occurs when the sigma parameter is set outside the allowed range of 0.01 to 100.0.
• Solution: Ensure that the sigma parameter is within the specified range.

TypeError: Input images and guide must have the same dimensions

• Explanation: This error occurs when the input images and the guide image do not have matching dimensions.
• Solution: Verify that the input images and the guide image have the same dimensions before processing.