ComfyUI Node: EasyControlnetStack

EasyControlnetStack:

The easy controlnetStack node is designed to streamline the process of managing multiple ControlNet models within your AI art pipeline. This node allows you to stack and configure several ControlNet models, providing a flexible and efficient way to enhance your image generation tasks. By using this node, you can easily control the strength, start and end percentages, and other parameters of each ControlNet model, ensuring that your creative vision is accurately reflected in the final output. The node supports both simple and advanced modes, catering to different levels of user expertise and requirements.

EasyControlnetStack Input Parameters:

toggle

This parameter determines whether the stacking operation should be performed. If set to False, None, or "False", the node will not execute the stacking process. This is useful for conditionally enabling or disabling the node's functionality.

mode

This parameter allows you to choose between simple and advanced modes. In simple mode, only basic settings are applied, while advanced mode provides more granular control over each ControlNet model's parameters. The available options are ["simple", "advanced"].

num_controlnet

This integer parameter specifies the number of ControlNet models to be stacked. The default value is 1, with a minimum of 1 and a maximum defined by the system's configuration (max_cn_num).

optional_controlnet_stack

This optional parameter allows you to provide an existing stack of ControlNet models to be included in the new stack. It accepts a CONTROL_NET_STACK type.

controlnet_<i>

For each ControlNet model (where <i> ranges from 1 to num_controlnet), this parameter specifies the name of the ControlNet model to be used. The default value is "None", and it includes a list of available ControlNet models.

controlnet_<i>_strength

This float parameter sets the strength of the <i>-th ControlNet model. The default value is 1.0, with a range from -10.0 to 10.0 and a step of 0.01.

start_percent_<i>

In advanced mode, this float parameter defines the starting percentage of the <i>-th ControlNet model's influence. The default value is 0.0, with a range from 0.0 to 1.0 and a step of 0.001.

end_percent_<i>

In advanced mode, this float parameter defines the ending percentage of the <i>-th ControlNet model's influence. The default value is 1.0, with a range from 0.0 to 1.0 and a step of 0.001.

scale_soft_weight_<i>

This float parameter adjusts the soft weight scaling for the <i>-th ControlNet model. The default value is 1.0, with a range from 0.0 to 1.0 and a step of 0.001.

image_<i>

This parameter allows you to provide an image input for the <i>-th ControlNet model. It accepts an IMAGE type.

EasyControlnetStack Output Parameters:

controlnet_stack

This output parameter returns the stacked ControlNet models as a CONTROL_NET_STACK. This stack can then be used in subsequent nodes to apply the combined effects of all included ControlNet models, providing a powerful tool for complex image generation tasks.

EasyControlnetStack Usage Tips:

• To achieve a balanced effect, start with the default strength values and gradually adjust the controlnet_<i>_strength parameters.
• Use the advanced mode if you need precise control over when each ControlNet model's influence starts and ends during the image generation process.
• Experiment with different scale_soft_weight_<i> values to fine-tune the blending of multiple ControlNet models.

EasyControlnetStack Common Errors and Solutions:

"No ControlNet models specified"

• Explanation: This error occurs when no ControlNet models are provided in the controlnet_<i> parameters.
• Solution: Ensure that you specify at least one ControlNet model by setting the controlnet_<i> parameters to valid model names.

"Invalid strength value"

• Explanation: This error occurs when the controlnet_<i>_strength parameter is set to a value outside the allowed range.
• Solution: Adjust the controlnet_<i>_strength parameter to a value within the range of -10.0 to 10.0.

"Invalid start or end percentage"

• Explanation: This error occurs when the start_percent_<i> or end_percent_<i> parameters are set to values outside the allowed range.
• Solution: Ensure that the start_percent_<i> and end_percent_<i> parameters are within the range of 0.0 to 1.0.

"Image input missing"

• Explanation: This error occurs when the image_<i> parameter is not provided for a specified ControlNet model.
• Solution: Provide a valid image input for each specified ControlNet model by setting the image_<i> parameters.