TEEDPreprocessor Node Documentation

Overview

The TEEDPreprocessor is a node designed for use within ComfyUI's ControlNet Auxiliary Preprocessors. This node specifically focuses on extracting soft-edge lines from images using the TEED (Thin Edge and End Detection) technique. This process is valuable in generating hint images which can be employed in various control applications and image editing tasks.

Functionality

The TEEDPreprocessor is categorized under "ControlNet Preprocessors" within the "Line Extractors" section of ComfyUI. It uses a pretrained model to detect and extract thin, soft-edge lines from an input image, which can be used as a foundation for further artistic augmentation or enhancement in workflows that require precise edge detection.

Inputs

The TEEDPreprocessor node accepts the following inputs:

• Image: The primary input is an image from which the node will extract soft-edge lines.
• Safe Steps (Integer): This parameter determines the safety level for the edge detection process. It is an integer value with a default setting of 2 and a maximum value of 10. This parameter helps in ensuring that the edge extraction process is robust and can handle varying complexities within the input image.
• Resolution (Integer): The resolution at which the processing should occur. The default resolution setting is 512, and it helps in scaling the image to an appropriate size for optimal line extraction.

Outputs

The TEEDPreprocessor node produces the following output:

• Image (IMAGE): The output is an image with the extracted soft-edge lines. This processed image is suitable for use in further image editing workflows that require detailed edge information.

Usage in ComfyUI Workflows

In ComfyUI workflows, the TEEDPreprocessor can be used as a preprocessing step to enhance images by highlighting edges with soft lines. This capability makes it an essential part of workflows that involve detailed image transformation and artistic rendering processes.

Example Workflow

1. Image Upload: Start by uploading an image that needs edge processing.
2. TEEDPreprocessor: Apply the TEEDPreprocessor node to extract soft-edge lines from the image, adjusting the 'safe steps' and 'resolution' parameters as needed.
3. Post-Processing: Use the output image in subsequent nodes within the workflow to integrate the edge information into creative image generation or augmentation tasks.

Special Features and Considerations

• Pretrained Model: The TEEDPreprocessor uses a pretrained model specifically designed to detect and extract thin and soft-edge lines, optimizing it for diverse image inputs.
• Tuning Parameters: The node includes adjustable parameters such as safe steps and resolution, allowing users to control the level of detail and accuracy in edge extraction.
• Device Compatibility: The node is designed to work seamlessly with the torch device settings, ensuring compatibility and performance on various computation platforms.

In conclusion, the TEEDPreprocessor node in the ComfyUI ControlNet Auxiliary Preprocessors is a powerful tool for extracting essential line details from images, augmenting their value in digital art and image processing workflows. Its ability to produce high-quality soft-edge line images makes it a valuable component in artistic preprocessing and creative expression.