ACEPlusFFTProcessor~

节点功能:对输入的参考图像(reference_image)和编辑图像(edit_image)进行尺寸调整、归一化和裁剪等操作,确保图像符合后续处理的要求,并支持对编辑图像进行特定的任务处理(如修复、重绘等)。

输入参数

参数名称说明
reference_image可选的参考图像。
edit_image可选的编辑图像。
edit_mask可选的编辑掩码,蒙版。

输出参数

参数名称说明
UC_IMAGE图像类型,未被掩码的部分(即条件图像),处理后的编辑图像张量。
C_IMAGE图像类型,被掩码的部分,表示需要修改的区域图像。
MASK掩码类型,编辑区域的掩码图像张量。
OUT_H整数,输出图像的高度。
OUT_W整数,输出图像的宽度。
SLICE_W整数,拼接参考图像后的分割宽度,供后续网络使用。这是一个中间计算值,表示参考图像拼接在编辑图像左边后,占用的实际像素宽度(最终会乘上缩放比例)。如果没有参考图像,则这个值是 0;如果参考图像宽度大于 30 像素,还会额外 +30,这是为模型“分段处理”预留的缓冲空间。

控件参数

参数名称说明
use_reference布尔值,指定是否使用参考图像。
height图像高度,范围在 256 到 1436 之间。
width图像宽度,范围在 256 到 1436 之间。
task_type可用任务类型的列表。
keep_pixels_rate一个在 0 和 1 之间的浮动值,用于调整参考图像的大小,使其保留原始像素的比例。例:如果编辑图像是 1024 高,而 keep_pixels_rate 是 0.8,那么参考图像会被缩放成约 819 高再拼接进去。
max_seq_length最大序列长度,范围在 1024 到 5120 之间,整数,用于控制图像缩放比例的最大“序列长度”,防止图像变得太大。max_seq_length 越大,图像越少被压缩,质量越高,但显存占用更大。它不是直接控制图像宽高,而是通过计算决定压缩比例,保持总 patch 数在合理范围。

这是不同keep_pixels_rate的处理结果,当keep_pixels_rate=1.0时,参考图和编辑图完全对齐。

关于task_type中的几种模式,在本插件的其他节点中进行搭配使用。