ComfyUI Node: Tone Refiner (C2C)

Tone Refiner (C2C):

MECToneRefiner is a sophisticated node designed to automatically correct the tone of images, with optional features for upscaling and applying a center-focus depth of field (DOF) effect. This node is particularly beneficial for enhancing the visual quality of images by adjusting tonal imbalances, which can result in more visually appealing and professionally polished outputs. The auto-correction feature intelligently analyzes the image to make necessary adjustments, ensuring that the final result maintains a natural and balanced appearance. Additionally, the optional upscaling feature allows for increased image resolution, which is useful for printing or high-resolution displays. The center-focus DOF effect can be applied to draw attention to the central subject of the image, creating a more engaging and dynamic composition. Overall, MECToneRefiner is a versatile tool that enhances image quality through tone correction and additional visual effects.

Tone Refiner (C2C) Input Parameters:

mask_expansion_blend

This parameter controls the expansion of the blend mask, which affects how much the mask is expanded during processing. A non-zero integer value will apply a morphological operation to expand the mask, influencing the area of effect for tone correction. The minimum value is 0, which means no expansion, and there is no explicit maximum value provided, but it should be set according to the desired effect.

blend_softness

Blend softness determines the softness of the blend mask edges. A higher value results in smoother transitions between corrected and uncorrected areas, which can help in achieving a more natural look. The minimum value is 0.0, indicating no softness, and there is no explicit maximum value, but it should be adjusted based on the desired level of softness.

sampling_mask_blur_size

This parameter specifies the size of the blur applied to the sampling mask. A larger size results in a more blurred mask, which can affect the precision of the tone correction. The minimum value is 0, indicating no blur, and there is no explicit maximum value, but it should be set according to the desired level of blur.

sampling_mask_blur_strength

Sampling mask blur strength controls the intensity of the blur applied to the sampling mask. A higher value increases the blur effect, which can smooth out transitions but may reduce detail. The minimum value is 0.0, indicating no blur, and there is no explicit maximum value, but it should be adjusted based on the desired blur strength.

Tone Refiner (C2C) Output Parameters:

composite

The composite output is the final image result after applying tone correction and any optional effects such as upscaling or center-focus DOF. This output is a refined version of the input image, with improved tonal balance and visual quality.

dbg

The dbg output provides a debug mask, which is an optionally blurred version of the sampling mask used during processing. This output can be useful for understanding how the mask was applied and for troubleshooting any issues with the tone correction process.

Tone Refiner (C2C) Usage Tips:

• Experiment with the blend_softness parameter to achieve the desired level of smoothness in transitions, especially when working with images that have complex tonal variations.
• Use the mask_expansion_blend parameter to control the area of effect for tone correction, which can be particularly useful for images with specific regions that require more attention.
• Adjust the sampling_mask_blur_size and sampling_mask_blur_strength parameters to fine-tune the precision and smoothness of the tone correction, balancing detail retention with smooth transitions.

Tone Refiner (C2C) Common Errors and Solutions:

"Invalid mask expansion value"

• Explanation: This error occurs when the mask_expansion_blend parameter is set to a non-integer or an unsupported value.
• Solution: Ensure that the mask_expansion_blend parameter is set to a valid integer value that is supported by the node.

"Blend softness out of range"

• Explanation: This error indicates that the blend_softness parameter is set to a value outside the acceptable range.
• Solution: Adjust the blend_softness parameter to a value within the supported range, ensuring it is a positive float.

"Sampling mask blur size not supported"

• Explanation: This error occurs when the sampling_mask_blur_size parameter is set to an unsupported value.
• Solution: Verify that the sampling_mask_blur_size parameter is set to a valid integer value that is supported by the node.

"Sampling mask blur strength out of range"

• Explanation: This error indicates that the sampling_mask_blur_strength parameter is set to a value outside the acceptable range.
• Solution: Adjust the sampling_mask_blur_strength parameter to a value within the supported range, ensuring it is a positive float.