comfyui_controlnet_aux

2888
By tstandley
Updated about 1 month ago
View on GitHub →See Common Issues →

Available Nodes

Scribble_XDoG_Preprocessor

Scribble_XDoG_Preprocessor Node Documentation

Overview

The Scribble_XDoG_Preprocessor node is an auxiliary tool within the ComfyUI ecosystem, designed to generate hint images for the ControlNet framework. Specifically, this node utilizes the XDoG algorithm to extract scribble-like lines from an input image, creating line drawings that can be used to guide image generation processes in ControlNet.

What This Node Does

The Scribble_XDoG_Preprocessor node processes an input image to extract and visualize its underlying line structure. The extracted lines are depicted as high-contrast strokes, resembling scribbles, which can then be used to influence the behaviors of models in the ControlNet suite. This node is part of the larger set of line extraction preprocessors that assist in generating various forms of lineart for artistic or annotation purposes.

Inputs

The Scribble_XDoG_Preprocessor node accepts the following inputs:

  1. Image (IMAGE): The primary input for this node is an image from which line information will be extracted. This image serves as the basis for the scribble-like representation.

  2. Threshold (INT): An integer value used to adjust the sensitivity of the line extraction process. The default threshold is set to 32, with a minimum value of 1 and a maximum of 64. Lower threshold values tend to produce finer lines, while higher values yield thicker and bolder strokes.

  3. Resolution (RES): This parameter specifies the resolution at which the image will be processed. The default resolution is 512 pixels.

Outputs

The Scribble_XDoG_Preprocessor node produces the following output:

  • Processed Image (IMAGE): The output is an image with scribble-like lines extracted from the input. This processed image serves as a lineart representation of the original image, emphasizing contours and structural details.

Usage in ComfyUI Workflows

The Scribble_XDoG_Preprocessor node can be integrated into ComfyUI workflows to facilitate various image processing and generation tasks. Users often employ this node in conjunction with ControlNet models to achieve specific aesthetic outcomes in image synthesis. Here’s a typical workflow involving this node:

  1. Image Acquisition: Start by selecting an image that you wish to convert into a scribble-based line drawing.

  2. Node Integration: Incorporate the Scribble_XDoG_Preprocessor node into your ComfyUI pipeline. Configure the input settings, adjusting the threshold and resolution to fit your desired outcome.

  3. Processing: Execute the node to process the image, resulting in a scribble line drawing output.

  4. Further Enhancement: Utilize the generated line drawing with ControlNet or other image synthesis models to refine or alter the visual style of subsequent outputs.

Special Features and Considerations

  • Customizable Threshold: The node allows for flexibility in altering the threshold parameter, enabling users to finely tune the appearance of the extracted scribble lines.

  • Resolution Settings: The adjustable resolution feature ensures that users can scale the output to meet various specifications, accommodating different levels of detail.

  • Line Style: This node specifically produces scribble-style lines, which can be particularly useful for generating unique artistic effects or simulations of hand-drawn artwork.

In summary, the Scribble_XDoG_Preprocessor is a versatile and valuable node within the ComfyUI suite, providing users with the ability to transform images into scribble-like line representations, ideal for guiding and enhancing image generation tasks in creative projects.