ComfyUI Node: Three Tone Styler

Three Tone Styler:

The ThreeToneStyler is a custom node designed for creating stylized images using a three-tone color grading technique. This node allows you to apply creative color grading based on color theory relationships, such as complementary, triadic, and analogous color schemes. By manipulating the highlights, midtones, and shadows of an image, you can achieve a unique artistic effect that enhances the visual appeal of your artwork. The node is particularly beneficial for AI artists looking to experiment with color dynamics and luminance mapping, providing a versatile tool for enhancing image aesthetics through controlled color relationships and contrast adjustments.

Three Tone Styler Input Parameters:

images

This parameter accepts the input image(s) that you want to apply the three-tone style effect to. The images are processed as tensors, allowing for efficient manipulation and transformation within the node.

base_color

The base_color parameter sets the primary color used in the three-tone styling process. It is defined as a string representing a color code, with a default value of #0000FF (blue). This color serves as the foundation for the color grading process, influencing the overall tone and mood of the output image.

color_relationship

This parameter determines the color relationship used in the styling process, offering options such as "Primaries," "Secondaries," "Complementary," "Split Complementary," "Triadic," and "Analogous." The default setting is "Complementary." Each option applies a different color theory principle to the image, affecting how colors interact and contrast with each other.

tone_mapping

The tone_mapping parameter specifies which part of the image's tonal range will be affected by the color grading. Options include "Highlights," "Midtones," and "Shadows," with "Midtones" as the default. This choice determines which tonal areas will be emphasized or subdued, allowing for targeted adjustments to the image's appearance.

contrast

This parameter controls the contrast level of the image, with a default value of 1.0. It ranges from 0.1 to 2.0, adjustable in increments of 0.1. Increasing contrast enhances the difference between light and dark areas, while decreasing it results in a more subdued image.

threshold_low

The threshold_low parameter sets the lower threshold for tone mapping, with a default value of 0.3. It ranges from 0.0 to 1.0, adjustable in increments of 0.05. This threshold determines the minimum intensity level that will be affected by the tone mapping, allowing for precise control over which parts of the image are altered.

threshold_high

This parameter sets the upper threshold for tone mapping, with a default value of 0.7. It ranges from 0.0 to 1.0, adjustable in increments of 0.05. The threshold_high determines the maximum intensity level affected by the tone mapping, providing further control over the image's tonal adjustments.

smoothing

The smoothing parameter controls the smoothness of the transition between different tones, with a default value of 0.1. It ranges from 0.0 to 1.0, adjustable in increments of 0.05. Higher values result in smoother transitions, while lower values create more abrupt changes.

saturation

This parameter adjusts the saturation level of the image, with a default value of 1.0. It ranges from 0.0 to 2.0, adjustable in increments of 0.1. Increasing saturation intensifies the colors, while decreasing it results in a more muted palette.

preserve_luminance

The preserve_luminance parameter is a boolean option that, when set to true (default), maintains the original luminance of the image during the color grading process. This ensures that the brightness levels remain consistent, even as colors are altered.

Three Tone Styler Output Parameters:

output

The output parameter is a tensor representing the stylized image after the three-tone effect has been applied. This output retains the original image's dimensions and format, but with the enhanced color grading and tonal adjustments specified by the input parameters. The result is a visually distinct image that reflects the chosen color relationships and tone mapping settings.

Three Tone Styler Usage Tips:

• Experiment with different color_relationship settings to discover unique color dynamics that enhance your artwork's mood and style.
• Use the contrast parameter to fine-tune the image's visual impact, balancing between subtle and dramatic effects.
• Adjust threshold_low and threshold_high to precisely control which tonal areas are affected, allowing for targeted enhancements or reductions.
• Consider enabling preserve_luminance to maintain consistent brightness levels, especially when working with images where luminance is a critical aspect.

Three Tone Styler Common Errors and Solutions:

Error: "Invalid color code format"

• Explanation: The base_color parameter must be a valid hex color code.
• Solution: Ensure that the base_color is specified in the correct format, such as #RRGGBB.

Error: "Contrast value out of range"

• Explanation: The contrast parameter must be within the specified range of 0.1 to 2.0.
• Solution: Adjust the contrast value to fall within the acceptable range using the provided slider.

Error: "Threshold values must be between 0.0 and 1.0"

• Explanation: The threshold_low and threshold_high parameters must be within the range of 0.0 to 1.0.
• Solution: Ensure that both threshold values are set within the specified range, using the sliders for precise adjustments.