ComfyUI-Inpaint-CropAndStitch>✂️ Inpaint Crop (Improved)
ComfyUI-Inpaint-CropAndStitch
时间:2025/08/18

✂️ Inpaint Crop (Improved)

该节点可实现从原始图像预处理(缩放)、蒙版掩码调整(扩展 / 填充 / 反转)、外绘扩展,到上下文区域控制、输出尺寸调整的全流程修复准备工作,最终输出裁剪后的图像、掩码及用于后续拼接的信息(stitcher),为图像修复模型提供更精准的输入。
✂️ Inpaint Crop (Improved)-节点参数说明
输入参数
image需要进行修复处理的原始图像。
mask原始图片中需要修补的区域
optional_context_mask额外的“必须保留为上下文”的区域。 处理流程里会把它和主掩码的上下文框合并,以确保这些区域也被包含到,以提升修复区域颜色、纹理、结构的一致性与无缝贴合效果。
输出参数
stitcher包含缝合信息的字典(比如裁剪图在画布图中的位置与尺寸;用于后续将修复结果融合回原图)
cropped_image裁剪后的待修复图像区域
cropped_mask裁剪后待修复图像的蒙版区域
控件参数
downscale_algorithm需要缩小图像时使用的插值算法 可选:nearest / bilinear / bicubic / lanczos / box / hamming。 默认:bilinear 平衡速度与平滑;lanczos/bicubic 更锐利、细节更好;nearest 仅在像素风格或掩码处理时用。
upscale_algorithm需要放大图像时使用的插值算法 可选:nearest / bilinear / bicubic / lanczos / box / hamming。 默认:bicubic;常用lanczos;nearest 只适合像素风格。
preresize是否在整个流程开始前就先重设图像/蒙版的分辨率。用于把原图拉到一个合适的工作尺度,利于后续裁剪/采样稳定。 默认False(开启)
preresize_mode尺寸调整模式:①ensure minimum resolution/②ensure maximum resolution/③ensure minimum and maximum resolution ①ensure minimum resolution:确保宽和高至少达到 预处理后图像最小宽度、高度(不足就放大,超出不限制)。 ②ensure maximum resolution:确保宽和高不超过预处理后图像最大宽度、高度,超出就缩小,不足不动)。 ③ensure minimum and maximum resolution:同时满足最小与最大(不足放大、超出缩小)。
preresize_min_width预处理后图像最小宽度;默认1024
preresize_min_height预处理后图像最小高度;默认1024
preresize_max_width预处理后图像最大宽度;默认1024
preresize_max_height预处理后图像最大高度;默认1024
mask_fill_holes填充蒙版中的“孔洞”(即掩码内部完全封闭的未掩码区域),确保封闭区域被标记为需要修复。默认True
mask_expand_pixels扩大蒙版范围;默认0
mask_invert反转蒙版(反选蒙版之外的区域);默认false
mask_blend_pixels蒙版边缘羽化像素数(使修复边界更自然);默认32,范围 0~64
mask_hipass_filter过滤掩码中低于该值的弱信号(例如模糊的掩码边缘),仅保留较强的掩码区域。默认 0.1,范围 0~1
extend_for_outpainting是否扩展图像边缘以支持外绘(在图像外部添加空白区域,用于生成新内容)。
extend_up_factor图像上方向的扩展比例(基于原始图像尺寸)
extend_down_factor图像下方向的扩展比例(基于原始图像尺寸)
extend_left_factor图像左方向的扩展比例(基于原始图像尺寸)
extend_right_factor图像右方向的扩展比例(基于原始图像尺寸)
context_from_mask_extend_factor从蒙版区域向四周扩展上下文的比例。例如1.2表示在蒙版区域基础上,向上、下、左、右各扩展20%的区域作为上下文。默认 1.2,范围 1.0~100.0
output_resize_to_target_size是否强制将输出图像调整到指定的目标尺寸(用于统一修复结果的大小)。
output_target_width输出图像的目标宽度
output_target_height输出图像的目标高度
output_padding对裁剪区域四周再加一圈安全边距(像素)。选项(0/8/16/32/64/128/256/512),默认32
如下,该节点对输入图片的蒙版区域,单独裁剪出来进行处理,即指定大小放大或缩小处理

optional_context_mask(可选上下文掩码)

是一个用于手动补充关键环境信息的高级参数。它的核心作用是:在主掩码(mask)定义的修复区域之外,额外标记需要保留的“上下文区域”,确保修复模型能参考这些关键环境信息,生成与原图更协调的结果。

例如示例中,修复原图中的玻璃有外界映射时,手动加入了周边环境的区域,确保修复的区域更加合理;通过示例的结果对比可以看出加入optional_context_mask的结果更加合理。


downscale_algorithm/upscale_algorithm模式说明

是图像修复过程中控制图像缩放质量的核心参数。这些算法决定了图像在预处理和输出阶段的缩放方式,直接影响最终修复质量。

默认:bicubic

算法模式计算复杂度适用场景视觉特点
nearest★☆☆☆☆像素艺术/游戏纹理锯齿状边缘
bilinear ★★☆☆☆通用快速处理轻微模糊
bicubic★★★☆☆照片修复(默认)细节保留
lanczos★★★★☆高质量放大锐利边缘
box★★☆☆☆快速缩小平均模糊
hamming★★★☆☆抗锯齿处理平滑过渡

nearest和box模式处理下的图片偏锯齿状


mask_fill_holes:自动填充封闭蒙版中的空隙


extend_for_outpainting

开启后,会在四周扩展画布,为“往外画”创造空间。以原图为参考,按系数增加相应方向的额外边距;

例如 1.2 可能表示在该方向上添加约 20% 的可绘空间;实际数值请按可视结果微调(>1 增加,=1 不变)。


output resize to target size

控制输出图像的尺寸和格式

广告

可加入知识星球获取所有示例工作流

广告

微信扫码入群,加入AIGC大家庭,与大家一起交流学习