ComfyUI Node: Contour FX (CRT)

Contour FX (CRT):

ContourFX is a powerful node designed to enhance images by applying contour effects, which can significantly alter the visual aesthetics of an image. This node is particularly useful for artists looking to emphasize edges and outlines within their artwork, providing a stylized and dramatic effect. By leveraging advanced image processing techniques, ContourFX detects and highlights the edges in an image, allowing for customizable adjustments to the contour lines and background. This node is ideal for creating striking visual contrasts and can be used to produce both subtle and bold artistic effects, depending on the settings chosen. Its primary goal is to offer a flexible tool for artists to explore and manipulate the contours of their images, enhancing the overall composition and depth.

Contour FX (CRT) Input Parameters:

image

This parameter represents the input image to which the contour effect will be applied. It is expected to be a tensor format image, which allows for efficient processing and manipulation within the node.

threshold

The threshold parameter determines the sensitivity of edge detection. It controls the minimum gradient magnitude required for an edge to be considered significant. A lower threshold will result in more edges being detected, while a higher threshold will limit detection to only the most prominent edges. The value ranges from 0.0 to 1.0, with a default of 1.0.

softness

Softness affects the transition between detected edges and the surrounding areas. It controls the smoothness of the edge blending, with lower values resulting in sharper edges and higher values producing softer transitions. The range is from 0.0 to 1.0, with a default of 1.0.

sensitivity

Sensitivity adjusts the amplification of the gradient magnitude, influencing how pronounced the detected edges appear. Higher sensitivity values will enhance the visibility of edges, making them more prominent. The parameter ranges from 0.0 to 1.0, with a default of 0.77.

line_color

This parameter specifies the color of the contour lines. It is defined using a hexadecimal color code, with a default value of "#FFFFFF" (white). The chosen color will be applied to the detected edges in the image.

line_opacity

Line opacity controls the transparency of the contour lines. A value of 1.0 means fully opaque lines, while 0.0 results in fully transparent lines. The range is from 0.0 to 1.0, with a default of 1.0.

background_color

Background color sets the color of the image areas that are not part of the detected edges. It is specified using a hexadecimal color code, with a default value of "#000000" (black).

background_opacity

This parameter determines the transparency of the background color. Similar to line opacity, it ranges from 0.0 (fully transparent) to 1.0 (fully opaque), with a default of 1.0.

output_mode

Output mode allows you to choose between two options: "Final Image" and "Edge Mask". "Final Image" applies the contour effect with the specified colors and opacities, while "Edge Mask" outputs a mask highlighting the detected edges.

Contour FX (CRT) Output Parameters:

IMAGE

The output is an image tensor that contains the processed image with the applied contour effects. Depending on the chosen output mode, this can either be the final image with contour lines and background colors applied or an edge mask highlighting the detected edges. This output is crucial for visualizing the impact of the contour effects and can be used for further artistic manipulation or as a final piece.

Contour FX (CRT) Usage Tips:

• Experiment with the threshold and sensitivity parameters to achieve the desired level of edge detection. Lower thresholds and higher sensitivities can reveal more details, while higher thresholds can simplify the image by focusing on major edges.
• Use line_color and background_color creatively to match the mood and style of your artwork. Contrasting colors can create a dramatic effect, while similar tones can produce a more subtle look.
• Adjust softness to control the sharpness of the edges. For a more painterly effect, increase the softness to blend edges smoothly with the background.

Contour FX (CRT) Common Errors and Solutions:

"Invalid image tensor"

• Explanation: This error occurs when the input image is not in the expected tensor format.
• Solution: Ensure that the input image is correctly formatted as a tensor before passing it to the node.

"Color code format error"

• Explanation: This error arises when the line_color or background_color is not provided in the correct hexadecimal format.
• Solution: Verify that the color codes are in the format "#RRGGBB" and correct any discrepancies.

"Invalid parameter range"

• Explanation: This error indicates that one or more parameters are set outside their allowed range.
• Solution: Check all parameter values to ensure they fall within the specified minimum and maximum limits. Adjust any values that are out of range.