ACN_AdvancedControlNetApply_v2 Documentation

Overview

The ACN_AdvancedControlNetApply_v2 node is a powerful utility within the ComfyUI-Advanced-ControlNet system, designed to enhance and extend the features of traditional ControlNet nodes. This node integrates advanced ControlNet functionalities, significantly improving how controlnets can be applied across various contexts and media. It seamlessly converts any compatible ControlNet model into its advanced version, offering more granular control over scheduling, strengths, and masks.

Key Features

• Advanced Conversion: Automatically converts compatible ControlNet models into their advanced versions.
• Strength Management: Allows for detailed configuration of controlnet strengths across different timesteps and latents.
• Attention and Masking: Supports attention masks to focus controlnets on specific parts of the guided image, with adjustable strength.
• Timestep Keyframes: Utilizes keyframes to manage when controlnets start and end effects during sampling steps.
• Integration: Works in tandem with other nodes in the ComfyUI-Advanced-ControlNet framework for seamless advanced features.

Inputs

• Positive Conditioning (●): Mandatory input where you feed the positive conditioning data.
• Negative Conditioning (●): Mandatory input for negative conditioning data.
• ControlNet (●): The controlnet model to which advanced features are applied. This input is required for conversion to an advanced version.
• Image (●): Images that guide the controlnets. If the chosen controlnet necessitates a processed image, those should be provided. When multiple latents are processed, this input supports using one or more images.
• Mask Optional (◦): Optional input for attention masks that determine the controlnet's focus areas on the image.
• Timestep Keyframes (◦): Optional input that guides controlnet effects throughout the sampling steps.
• Latent Keyframe Override (◦): Optional override for latent keyframes to maintain uniformity if other features of time step keyframes are unnecessary.
• Weights Override (◦): Optional override for weights, similar to latent keyframes but for controlnet weights.
• Strength (⬚): Configurable strength of the controlnet, ranging from 0.0 (no effect) to 1.0 (full strength).
• Start Percent (⬚): The sampling step percentage at which the controlnet starts applying.
• Stop Percent (⬚): The percentage step for stopping controlnet effects.

Symbol Legend:

• ●: Required
• ◦: Optional
• ⬚: Configurable

Outputs

• Positive Conditioning (⬚): Outputs the positive conditioning with the applied controlnets.
• Negative Conditioning (⬚): Outputs the negative conditioning with the applied controlnets.

Usage in ComfyUI Workflows

In a ComfyUI workflow, the ACN_AdvancedControlNetApply_v2 node serves as a pivotal component for enhancing imagery guidance through advanced controlnets. It is particularly useful when fine-tuning image control features such as strength, timing, and masking are required. Typically, it would be linked to other nodes responsible for loading controlnet models and configuring keyframes or masks.

Example Workflow

1. Load ControlNet: Use nodes like Load Advanced ControlNet Model to load your desired ControlNet model.
2. Connect to Node: Feed the conditioning and controlnet inputs into ACN_AdvancedControlNetApply_v2.
3. Configure Inputs: Adjust the strengths, timesteps, and masks as per the requirements using the associated inputs.
4. Process Outputs: Observe the effect on the positive and negative conditioning outputs for enhanced image generation results.

Special Considerations

• Image Requirements: Ensure that input images meet the preprocessing criteria of the associated controlnet models.
• Chaining: This node is often best used in conjunction with other Advanced-ControlNet nodes for maximum effect, especially when leveraging scheduled effects or keyframes.
• Attention Masks: Utilizing attention masks can greatly affect how and where controlnets apply, so careful configuration is advised.

This node represents a mature approach to managing and applying ControlNet models within the ComfyUI framework, and it is an essential tool for users seeking to enhance their generative image workflows with more precision and control.