ACN_AdvancedControlNetApplySingle_v2 Node Documentation

Overview

The ACN_AdvancedControlNetApplySingle_v2 node is a part of the ComfyUI-Advanced-ControlNet repository. This node is designed to integrate advanced functionalities into the existing ComfyUI framework, providing users with enhanced control over how ControlNets are applied in image generation workflows. It supports advanced features like timestep scheduling, custom weights, and attention masks, allowing for more nuanced and detailed manipulations of ControlNet applications.

Functionality

The ACN_AdvancedControlNetApplySingle_v2 node applies a single instance of an Advanced ControlNet to an image generation process. It automates the conversion of a standard ControlNet into its advanced form, which includes capabilities for:

• Timestep and latent strength scheduling.
• Attention mask applications to control specific areas and effects on the image.
• Integration of custom weights to manipulate the priority between the generated content and the ControlNet influence.

Inputs

• positive (Required): Conditioning data that provides positive guidance to the ControlNet during the image generation process.
• negative (Required): Conditioning data that provides negative guidance to the ControlNet, acting as counterbalancing inputs.
• control_net (Required): A loaded ControlNet model. If not in its advanced form, this node will automatically convert it to an advanced version, provided it is a supported type.
• image (Required): The images intended to guide the ControlNet. Depending on the ControlNet, these might need to be pre-processed. If only one image is provided, it will be used for all latents; otherwise, each image is associated with different latents.
• mask_optional (Optional): Attention masks that determine which parts of the image the ControlNet will affect. Multiple masks can be provided to apply to various latents.
• timestep_kf (Optional): A sequence of timestep keyframes that guide how the ControlNet's effect evolves throughout the sampling steps.
• latent_kf_override (Optional): An override for latent keyframes that applies across all timesteps, regardless of other settings within timestep keyframes.
• weights_override (Optional): A global override for weight settings that applies across all timesteps, independent of any other weight-related keyframes.
• strength (Widget/Input): Sets the control strength of the ControlNet. A value of 1.0 indicates full strength, while 0.0 means no effect.
• start_percent (Widget/Input): Specifies the starting point during the sampling process at which the ControlNet should be applied.
• stop_percent (Widget/Input): Specifies the stopping point for the ControlNet's application during the sampling process.

Outputs

• positive: The resultant positive conditioning data with the applied ControlNet effects.
• negative: The resultant negative conditioning data with the applied ControlNet effects.

Usage in ComfyUI Workflows

The ACN_AdvancedControlNetApplySingle_v2 node is used in workflows where precision control over ControlNet is desired. It allows users to integrate sophisticated controls over image generation by:

• Applying customized weights to balance control between the prompt and ControlNet.
• Using masks to target specific image areas for detailed adjustments.
• Scheduling ControlNet influence across the image generation process to dynamically adapt its strength and impact.

This node is particularly useful for artists and developers seeking to create complex and nuanced images, ensuring that their ControlNet influence aligns with their creative goals or experimental needs.

Special Features or Considerations

• Automatic Advanced Conversion: Any loaded ControlNet is automatically upgraded to its advanced version, simplifying the integration process for the user.
• Granular Control: Through the use of keyframes and overrides, users can exert precise control over how and when ControlNet influences are applied.
• Interoperable with Other Nodes: This node can work seamlessly with others in the Advanced-ControlNet suite, offering broad compatibility and extended features in image generation workflows.

This node's extensive capabilities make it integral for workflows aiming for high customization in art and design generated using AI models. It enhances the ComfyUI framework by adding depth and flexibility to ControlNet applications.