LayerUtility: ImageScaleByAspectRatio

节点功能：将输入的图像或遮罩按照指定的宽高比进行缩放，支持多种预设比例和自定义比例，并可以按长边尺寸进行缩放。

LayerUtility: ImageScaleByAspectRatio-节点参数说明

输入参数
image	可选输入图像。
mask	可选输入掩码图像。
输出参数
image	缩放后的图像输出。
mask	缩放后的掩码输出。
original_size	输入图像/掩码的原始宽高，例如 [640,480]。
width	输出图像的宽度。
height	输出图像的高度。
控件参数
aspect_ratio	目标宽高比。可选值：original（保持原图）、custom（自定义）、常见比例如 1:1、16:9、9:16 等。
proportional_width	当 aspect_ratio = custom 时，设置宽的比例值。仅在使用自定义比例时有效。例如输入 3 和 2 表示比例为 3:2。
proportional_height	当 aspect_ratio = custom 时，设置高的比例值。配合 proportional_width 使用，建议避免设为 0。
fit	图像适配方式，可选：letterbox（等比+留边）、crop（裁切填满）、fill（强制拉伸填满）。推荐使用 letterbox 保留原比例，或 crop 用于头像、特写图。
method	缩放插值方法。 lanczos（兰索斯插值）：高质量缩放算法，边缘保留效果好，不过耗时稍高，推荐作为默认选择，适用于高清图像。 bicubic（双三次插值）：插值效果平滑自然，运算速度较快，质量比 lanczos 稍逊，适合对一般图像进行缩放。 bilinear（双线性插值）：计算速度快但效果较为粗糙，适用于图像预览以及轻量处理的场景。 box（方框平均插值）：采用简单平均的方式，主要用于降采样，速度快但质量一般。 hamming（汉明插值）：与 lanczos 类似，质量略低，边缘保留效果较好，适用于对边缘保持有一定要求的图像。 nearest（最近邻插值）：保留像素块，不进行平滑处理，适合像素风格图、遮罩图、分割图，不推荐用于真实图像的缩放。
round_to_multiple	将最终宽高对齐为某个倍数（如 64、128），或选 None 不做对齐。
scale_to_longest_side	是否将图像最长边缩放为固定值（如 1024），另一边按比例自动调整。开启后可控制输出最大边长度，适合保证输出不超过 GPU 限制或统一尺寸。
longest_side	设定最长边的目标像素值，仅在 scale_to_longest_side = True 时生效。

oringal模式下，无论proportional_width和proportional_height如何设置，图片会一直保持原图片大小进行输出，
custom模式下，proportional_width和proportional_height要设置不一样的比例才能生效，如果是同样的比例，依旧是原图片大小进行输出。
proportional_width和proportional_height只在custom模式下生效。

不同的fit模式，该参数在oringal下不生效。

原图大小的宽度原本是1202，但是round_to_multiple=8，则会强制将图片大小限制到8的倍数大小变成1208（原图大小附近的数值），而scale_to_longest_side设置为true后，原图大小会按longest_side进行缩放。

ComfyUI原生节点

ComfyUI第三方插件

LayerUtility: ImageScaleByAspectRatio