Resize Image

节点功能:用于调整图像的尺寸。

输入参数

参数名称说明
image要调整大小的输入图像。
width_input可选传入的宽度。
height_input可选传入的高度。
get_image_size可选输入图像,将其宽高作为最终缩放尺寸(替代 width/height 参数)。

输出参数

参数名称说明
IMAGE缩放处理后的图像。
width输出图像的最终宽度。
height输出图像的最终高度。

控件参数

参数名称说明
width目标宽度,单位为像素。若为 0 则按比例自动计算。
height目标高度,单位为像素。若为 0 则按比例自动计算。
upscale_method插值算法,推荐选择 lanczos 获取更清晰缩放图像,bilinear 适合常规用途,area 在图像缩小时表现良好,bicubic 平滑过渡效果较好,nearest-exact 适合像素风格图像。
keep_proportion是否保持原图比例进行缩放(优先使用较小边作为参考维度)
divisible_by最终输出宽高是否强制可被该值整除。设置为 0 表示不启用该规则。
crop裁剪模式:disabled 表示禁用裁剪,center 表示居中裁剪。
插值方法原理描述特点与优点适用场景缺点
nearest-exact最近邻像素,直接复制像素值最快、保持像素精度、不混色像素艺术、掩码处理、分块图像产生锯齿、块状伪影
bilinear2x2 邻域加权平均平滑、快速、比 nearest 更自然常规图像缩放、ResizeMask 节点稍模糊、细节保留不足
area源图像区域平均值缩小时保留结构、减少锯齿和摩尔纹图像缩小、结构保持需求强的场景放大时不适用
bicubic4x4 邻域加权平均细腻平滑、自然过渡照片、自然图像、插值要求中等较慢、可能出现轻微环状伪影
lanczossinc 函数(Lanczos 样窗)滤波最锐利、细节最好、高质量结果高清图像处理、最终输出计算量大、慢,有过冲风险


  • width:目标宽度(默认512)
  • height:目标高度(默认512)

放大缩小都可以。


参数值含义行为描述适用场景
stretch拉伸(不保持比例)直接将图像拉伸为目标尺寸,可能导致变形图像变形不影响结果的任务,如某些纹理或特效输入
resize等比缩放(保持比例)将图像缩放到目标尺寸内,保持比例,不裁剪、不补边保证图像比例一致,但不需要严格固定分辨率时
pad等比缩放 + 补边(填色)将图像等比缩放后,居中并用指定颜色补边到目标尺寸保持比例且尺寸固定,适用于推理输入、统一尺寸处理
pad_edge等比缩放 + 补边(边缘延展)类似 pad,但使用图像边缘像素填充边缘区域保持比例且尺寸固定,视觉更自然,适合展示或生成
crop等比裁剪将图像按比例裁剪至目标尺寸,避免变形或留边,支持居中/顶/底等位置裁剪强调画面主体或需要精确构图的场景,如头像、特写图像


pad_color:指定补边颜色(RGB,例如 "0, 0, 0" 表示黑色)。pad_color只在pad模式下才生效。


crop_position:当使用 crop 模式时,裁剪位置center, top, bottom, left, right才生效。

参数值裁剪位置行为描述适用场景
center居中裁剪从图像中心开始等比裁剪,尽可能保留中间内容一般默认选项,适合大多数图像,保持主体居中
top上部裁剪优先保留图像上方内容,裁剪掉底部多余部分上方为主体的图像(如人物头像、天空)
bottom下部裁剪优先保留图像下方内容,裁剪掉顶部多余部分下方为主体的图像(如人物全身照、建筑)
left左侧裁剪优先保留图像左边内容,裁剪掉右侧多余部分主体偏左或对称裁剪不合适时
right右侧裁剪优先保留图像右边内容,裁剪掉左侧多余部分主体偏右或构图要求右侧内容