跳转至

CropImage 图像精细裁剪与几何缩放旋转节点

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

CropImage 节点为创作者提供了对图像几何空间的亚像素级精确裁剪（Cropping）、中心变焦缩放（Zooming）以及自由角度旋转（Rotation）控制能力。无论是为了重新框定构图主体、校正拍摄地平线倾角，还是剔除画面四周无关元素，该节点都能提供工业级的几何变换保障。

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

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

  • 按指定的物理像素坐标与规格裁切图像目标区域；
  • 放大并聚焦画面的核心细节（如特写裁切）；
  • 对画面执行任意角度的顺时针或逆时针旋转纠偏；
  • 剔除图片边缘水印、黑边或不规整的白边；
  • 在自动化图像处理管线中统一截取固定锚点的局部视图。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 CropImage 节点。
  2. 将图像数据源接入 input_image 输入插槽。
  3. 设定矩形裁剪框的起始坐标（left、top）与尺寸（width、height）。
  4. （可选）调整 zoom 变焦倍率与 rotate 旋转角度。
  5. 在 output 引脚即可提取完成几何变换后的全新图像工件。

参数输入插槽 (Parameters)

裁剪框坐标配置 (Crop Settings)

  • left（像素，$\ge 0$，默认 0）：裁剪矩形区域左边界距离原图左边缘的水平像素距离。
  • top（像素，$\ge 0$，默认 0）：裁剪矩形区域上边界距离原图顶部的垂直像素距离。
  • width（像素，$\ge 1$，默认 100）：裁剪区域的物理宽度。
  • height（像素，$\ge 1$，默认 100）：裁剪区域的物理高度。

几何变换选项 (Transform Settings)

  • zoom（浮点数，默认 1.0）：对裁切区域应用的变焦放大系数：
    • 1.0 = 保持原始比例（无变焦）；
    • > 1.0 = 放大（放大中心细节）；
    • < 1.0 = 缩小。
  • rotate（角度 Degrees，默认 0）：图像围绕几何中心旋转的角度：
    • 正数 = 顺时针旋转（例如 15 代表顺时针旋转 15°）；
    • 负数 = 逆时针旋转。

输出引脚 (Outputs)

  • output：经历裁剪、重采样缩放与旋转纠偏后生成的全新图像工件（ImageArtifact）。

典型工作流示例 (Example)

裁剪人像特写并施加轻微倾角构图：

  1. 使用 LoadImage 导入一张全身人像照片。
  2. 将图像输出连入 CropImage 的 input_image 参数。
  3. 配置矩形裁剪框：
    • 将 left 设为 200，top 设为 150；
    • 将 width 设为 600，height 设为 800，精确框选面部与上半身。
  4. 增强构图张力：
    • 将 zoom 设为 1.15（放大 15% 突出眼神光）；
    • 将 rotate 设为 5（顺时针微旋 5 度营造动感）。
  5. 将 output 接入 DisplayImage 查看精修后的特写卡片。

关键技术特性 (Important Notes)

  • 毫秒级实时联动 (Live Preview)：滑块调节即时触发矩阵变换，画布内极速响应。
  • 物理边界防越界保护 (Boundary Checking)：节点内嵌严格的边界夹紧（Clamp）逻辑，自动防御裁切框超出原图物理范围。
  • 高阶重采样画质保障：旋转与变焦运算底层采用双三次/Lanczos 抗锯齿重采样，绝不产生马赛克毛边。
  • 透明通道完美继承 (RGBA Support)：针对带有 Alpha 通道的素材，旋转过程中露出的留白区域自动保留纯透明。

常见问题与排查 (Common Issues)

  • 裁剪后画面全黑或报错：检查 left + width 或 top + height 是否严重超出了原图自身的物理分辨率；确保 width 和 height 均为正整数。
  • 旋转后图像边缘被切掉：围绕中心点旋转矩形会使外接包围盒发生变化，节点默认会自适应约束边界；若需完整保留全部旋转角，可结合 ExtendCanvas 预留四周衬底。