ComfyUI Node: TTPlanet Tile GuidedFilter

TTPlanet Tile GuidedFilter:

The TTPlanet_TileGF_Preprocessor is a specialized node designed to enhance and preprocess images using a combination of Gaussian blur and Guided Filter techniques. This node is particularly useful for AI artists looking to refine their images by reducing noise and enhancing details, making it an essential tool for creating high-quality, visually appealing artwork. By leveraging the Guided Filter, the node ensures that the image retains its essential features while smoothing out unwanted artifacts. The Gaussian blur further aids in reducing noise, providing a cleaner and more polished output. This preprocessor is ideal for tasks that require precise control over image clarity and detail, offering a balance between smoothness and sharpness.

TTPlanet Tile GuidedFilter Input Parameters:

image

The image parameter is the primary input for the node, representing the image that you want to preprocess. This parameter accepts an image file in various formats and serves as the base for all subsequent processing steps.

scale_factor

The scale_factor parameter controls the scaling of the image during the preprocessing. It determines how much the image will be downscaled and then upscaled, which can affect the level of detail and smoothness in the final output. The value ranges from 1.00 to 8.00, with a default of 1.00. Higher values result in more significant scaling, which can enhance the smoothing effect.

blur_strength

The blur_strength parameter specifies the intensity of the Gaussian blur applied to the image. This helps in reducing noise and smoothing out the image. The value ranges from 1.0 to 10.0, with a default of 2.0. Higher values result in a stronger blur effect, which can be useful for heavily noisy images.

radius

The radius parameter defines the radius of the Guided Filter. This parameter influences the extent of the filtering effect, with larger values resulting in a more pronounced smoothing effect. The value ranges from 1 to 20, with a default of 7. Adjusting this parameter allows for fine-tuning the balance between detail preservation and noise reduction.

eps

The eps parameter, short for epsilon, controls the regularization term in the Guided Filter. It helps in maintaining the balance between edge preservation and smoothing. The value ranges from 0.001 to 0.1, with a default of 0.01. Lower values result in sharper edges, while higher values provide smoother transitions.

TTPlanet Tile GuidedFilter Output Parameters:

IMAGE

The IMAGE output parameter represents the processed image after applying the Gaussian blur and Guided Filter. This output is a refined version of the input image, with reduced noise and enhanced details, making it more suitable for further artistic manipulation or final presentation.

TTPlanet Tile GuidedFilter Usage Tips:

• Experiment with the scale_factor to find the optimal balance between detail and smoothness for your specific image.
• Use higher blur_strength values for images with significant noise to achieve a cleaner output.
• Adjust the radius parameter to control the extent of the Guided Filter effect, balancing between detail preservation and noise reduction.
• Fine-tune the eps parameter to maintain sharp edges while achieving the desired level of smoothness.

TTPlanet Tile GuidedFilter Common Errors and Solutions:

"Invalid image format"

• Explanation: The input image is not in a supported format.
• Solution: Ensure that the image is in a compatible format such as JPEG, PNG, or BMP.

"Scale factor out of range"

• Explanation: The scale_factor value is outside the allowed range.
• Solution: Adjust the scale_factor to be within the range of 1.00 to 8.00.

"Blur strength out of range"

• Explanation: The blur_strength value is outside the allowed range.
• Solution: Adjust the blur_strength to be within the range of 1.0 to 10.0.

"Radius out of range"

• Explanation: The radius value is outside the allowed range.
• Solution: Adjust the radius to be within the range of 1 to 20.

"Eps out of range"

• Explanation: The eps value is outside the allowed range.
• Solution: Adjust the eps to be within the range of 0.001 to 0.1.