ComfyUI Node: (DEPRECATED) Guided Filter Alpha

(DEPRECATED) Guided Filter Alpha:

GuidedFilterAlpha is a node designed to enhance the quality of images by applying a guided filter using an alpha mask. This node is particularly useful for refining details and smoothing images while preserving edges, making it ideal for tasks such as image denoising, detail enhancement, and edge-aware smoothing. The guided filter leverages the alpha mask to guide the filtering process, ensuring that the important structures in the image are maintained. This node is deprecated in favor of GuidedFilterImage, but it still provides valuable functionality for specific use cases where an alpha mask is required.

(DEPRECATED) Guided Filter Alpha Input Parameters:

images

This parameter accepts the input image(s) that you want to process. The images should be in a tensor format, typically representing the RGB channels of the image. The guided filter will be applied to these images, and the quality of the output will depend on the characteristics of the input images.

alpha

The alpha parameter is an image tensor that serves as the guide for the filtering process. It helps in preserving the edges and important structures in the input images. The alpha mask should ideally highlight the areas of interest in the image that need to be preserved during the filtering process.

filter_radius

This integer parameter defines the radius of the filter. It controls the size of the window used for the guided filtering process. The default value is 8, with a minimum of 1 and a maximum of 64. A larger radius results in smoother images but may also blur fine details, while a smaller radius preserves more details but may not smooth the image as effectively.

sigma

The sigma parameter is a float that determines the amount of smoothing applied by the filter. It controls the sensitivity of the filter to variations in the image. The default value is 0.1, with a minimum of 0.01 and a maximum of 1.0. A higher sigma value results in more aggressive smoothing, while a lower value preserves more details.

(DEPRECATED) Guided Filter Alpha Output Parameters:

IMAGE

The output is an image tensor that has been processed by the guided filter. This output image will have enhanced details and smoothed regions, with edges and important structures preserved according to the alpha mask. The result is a refined image that maintains the essential features of the original input.

(DEPRECATED) Guided Filter Alpha Usage Tips:

• To achieve optimal results, ensure that the alpha mask accurately represents the areas of interest in the image that need to be preserved.
• Experiment with different values of filter_radius and sigma to find the best balance between smoothing and detail preservation for your specific use case.
• Use this node for tasks such as image denoising, detail enhancement, and edge-aware smoothing where maintaining the integrity of edges is crucial.

(DEPRECATED) Guided Filter Alpha Common Errors and Solutions:

"Input tensor is not in the correct format"

• Explanation: This error occurs when the input images or alpha mask are not provided in the expected tensor format.
• Solution: Ensure that both the images and alpha parameters are provided as tensors. Convert your images to the appropriate tensor format before passing them to the node.

"Filter radius out of range"

• Explanation: This error occurs when the filter_radius parameter is set outside the allowed range of 1 to 64. - Solution: Adjust the filter_radius parameter to a value within the specified range (1 to 64).

"Sigma value out of range"

• Explanation: This error occurs when the sigma parameter is set outside the allowed range of 0.01 to 1.0.
• Solution: Adjust the sigma parameter to a value within the specified range (0.01 to 1.0).