EasyControlnet（高级）(controlnetAdvanced)

描述

EasyControlnet（高级）将 ControlNet 应用于 EasyUse PIPE_LINE 中包含的条件。它是 EasyControlnet 的高级变体，额外公开了 scale_soft_weights，用于调整所加载 ControlNet 的软权重缩放。image 输入提供 ControlNet 提示图像，例如 Canny 边缘图、深度图或姿势骨骼。

输入

pipe

包含模型、CLIP、VAE、正面条件、负面条件和 Latent 数据的 PIPE_LINE。节点从该管道中读取正面和负面条件，并将应用了 ControlNet 的条件写回返回的管道中。

image

必填的 IMAGE tensor，用作 ControlNet 提示。该图像应为预处理过的控制图像，且与所选的 ControlNet 模型类型匹配。

control_net_name

必填的组合输入，用于从 ComfyUI 的 controlnet 文件夹中的可用文件中选择 ControlNet 模型。

control_net

可选的 CONTROL_NET 输入。提供该输入时，将直接使用此 ControlNet 对象，而不是从 control_net_name 加载。这对于传入已在其他地方加载或修改的 ControlNet 非常有用。

strength

浮点类型，默认值为 1.0，范围为 0.0 到 10.0，步长为 0.01。控制 ControlNet 应用的总体强度。值为 0 时等效于禁用 ControlNet，并使条件保持不变。

start_percent

浮点类型，默认值为 0.0，范围为 0.0 到 1.0，步长为 0.001。定义 ControlNet 开始影响生成的去噪比例。0.0 表示采样的最开始。

end_percent

浮点类型，默认值为 1.0，范围为 0.0 到 1.0，步长为 0.001。定义 ControlNet 停止影响生成的去噪比例。1.0 表示采样的结束。

scale_soft_weights

浮点类型，默认值为 1.0，范围为 0.0 到 1.0，步长为 0.001。缩放从 control_net_name 加载 ControlNet 时应用的软权重。值为 1.0 时使用标准的软权重行为；较低的值会削弱该行为。如果你没有特意调整此参数，请将其保持为 1.0。

输出

• PIPE_LINE：输入管道，其条件已更新为包含所应用的 ControlNet。
• CONDITIONING：应用 ControlNet 之后的正面条件。
• CONDITIONING：应用 ControlNet 之后的负面条件。

两个 CONDITIONING 输出与返回管道中存储的正面和负面条件值一致，因此管道或单独的条件均可继续向下游连接。

使用说明

• start_percent 和 end_percent 是整个去噪调度中的比例，而非绝对步数。例如，start_percent=0.2 和 end_percent=0.8 表示仅在采样的中间 60% 阶段应用 ControlNet。
• strength 可以大于 1.0，从而能够将较弱的 ControlNet 推到正常 0.0 到 1.0 范围之外。
• 如果希望管道的条件在不受 ControlNet 影响的情况下直接通过，请将 strength 设置为 0。
• image 应为所选 ControlNet 所期望的预处理提示，例如 Canny 边缘图、深度图或 OpenPose 骨骼。
• 如果将 ControlNet 连接到可选的 control_net 输入，节点将直接使用该对象，而无需从 control_net_name 加载。