跳转至

RescaleImage 图像重采样缩放与分辨率调整节点

节点核心功能 (What is it?)

RescaleImage 节点允许创作者对输入图像的分辨率尺寸执行高保真缩放调整。它提供了针对物理像素尺寸（Pixels）和相对比例（Percentage）的双模缩放控制，并内嵌了工业级的图像重采样滤波算法（如 Lanczos、双三次插值等），是为不同下游平台规整画幅、制作缩略图或准备模型输入规格的核心工具。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 将高分辨率图像等比缩小至特定的物理像素规格；
  • 按百分比等比例放大或缩小图像；
  • 为网页展示、移动端信息流或印刷出版准备匹配的尺寸与文件体积；
  • 快速生成高质量缩略图（Thumbnail）或低延迟预览图；
  • 在自动化图像生成管线中，批量统一各阶段的画面分辨率；
  • 在严密锁定原始纵横比（Aspect Ratio）的前提下执行无损缩放。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 RescaleImage 节点。
  2. 将图像数据源接入 input_image 输入插槽。
  3. 选择缩放策略（resize_mode），并设定目标尺寸或百分比参数。
  4. 在 output 引脚即可提取缩放重采样完成的全新图像资产。

参数输入插槽 (Parameters)

缩放尺寸配置 (Resize Settings)

  • resize_mode：决定新图像规格的计算模式：
    • percentage：基于相对百分比缩放（例如 50% 即为原图面积的四分之一、长宽各减半）；
    • pixels：设定具体的绝对物理像素数值。
  • target_size（像素，默认 512）：在 pixels 模式下生效的目标基准像素值：
    • 若以宽度为锚点：设定宽度为该值，高度将严格按原图宽高比自动等比缩放；
    • 若以高度为锚点：设定高度为该值，宽度将严格按原图宽高比自动等比缩放。
  • percentage_scale（1–1000，默认 100）：在 percentage 模式下生效的缩放百分比数值：
    • 50 = 缩小至原尺寸的 50%；
    • 100 = 维持原始 100% 尺寸不变；
    • 200 = 放大至原尺寸的 200%（长宽各翻倍）。

重采样画质设置 (Quality Settings)

  • resample_filter：用于重构像素网格的数学重采样滤波器：
    • lanczos（推荐，默认）：基于 Lanczos 卷积核的顶级重采样算法，能极好地保留细微线条与纹理锐度（高品质，运算耗时稍长）；
    • bicubic（双三次插值）：平滑度极佳的均衡型算法，适合常规图像缩放；
    • bilinear（双线性插值）：计算开销小，适合追求快速吞吐的处理管线；
    • nearest（最近邻插值）：保留原始硬切边缘与马赛克像素块，适用于像素画（Pixel Art）无损放大。

输出引脚 (Outputs)

  • output：执行高质量重采样缩放后的全新图像工件（ImageArtifact）。

典型工作流示例 (Example)

典型的高画质缩图流水线：

  1. 使用 LoadImage 导入一张 4K 级别的超高清摄影作品。
  2. 将该图像连入 RescaleImage 节点的 input_image 插槽。
  3. 配置缩放参数：
    • 将 resize_mode 设为 "percentage"；
    • 将 percentage_scale 设为 50（制作二分之一规格版本）；
    • 将 resample_filter 设为 "lanczos" 确保文字与高频细节清晰锐利。
  4. 将 output 连入 DisplayImage 监看缩放后的精细画面。

关键技术特性 (Important Notes)

  • 毫秒级实时响应 (Live Preview)：滑块调节即时触发图像重采样，无缝更新视图。
  • 刚性锁定纵横比 (Aspect Ratio)：节点在缩放全流程中始终锁定原图几何比例，绝不产生拉伸形变。
  • 顶尖抗混叠质量 (High Quality)：内置 Lanczos 滤波核有效遏制缩放过程中产生的摩尔纹与边缘阶梯伪影。
  • 全透明通道完美继承 (RGBA Support)：针对 RGBA 图像，Alpha 遮罩通道与色彩三通道同步执行相同的插值核卷积计算，抠图轮廓不发虚、不错位。

常见问题与排查 (Common Issues)

  • 缩放后图像过小：检查是否在 percentage 模式下误将比例设得太小，或在 pixels 模式下调低了 target_size。
  • 画面模糊或细节涂抹严重：将 resample_filter 从 bilinear 或 nearest 切换至 lanczos 或 bicubic。
  • 最终尺寸不符合预期：确认当前激活的是 percentage 还是 pixels 模式，确保输入了正确的对应数值。

重采样数学内核机制 (Technical Details)

节点基于底层 PIL/Pillow 高性能图像处理引擎构建：

  • Lanczos 滤波器：采用 Sinc 函数加窗截断窗口矩阵，在频域上最大限度保留图像的高频通带能量。
  • Bicubic 双三次滤波：利用周围 $4 \times 4$ 共 16 个临近像素的样条加权多项式，过渡自然且平顺。
  • Bilinear 双线性滤波：利用 $2 \times 2$ 共 4 个临近像素的线性插值计算，性能高效。
  • Nearest 最近邻：直接映射源像素坐标最近点，无任何像素均化，是复古像素风格的首选。