ComfyUI 的 ImageCrop 用 x、y 指定裁切矩形的左上角,再用 width、height 指定矩形尺寸。因此右边界是 x + width,下边界是 y + height。ImageCrop 文档没有说明矩形超出原图时会怎样;相比之下,ImageCropV2 明确说明会把超界的 crop_region 调整到图像范围内。不要把 V2 的规则推及 ImageCrop 或其他裁切节点。
先读懂矩形定义
把图像左上角当作坐标起点:x 表示水平方向的起点,y 表示垂直方向的起点。裁切区域从该点开始,延伸指定的宽和高。核对边界时,分别记下左边 x、上边 y、右边 x + width 和下边 y + height。
例如,假设输入图像是 640 × 480 像素,参数为 x=100、y=60、width=200、height=150。右边界为 300,下边界为 210,因此这个矩形位于图像范围内。这只是用于说明计算方法的假设算例,并非实际运行结果。
核对当前节点的行为说明
先确认工作流里实际使用的是哪个节点。ImageCrop 官方文档 将 x、y 定义为裁切区域左上角坐标,并列出裁切宽度和高度;文档没有说明自动约束,也没有描述超界后的结果。
ImageCropV2 官方文档 使用由 x、y、width、height 组成的 crop_region,并补充了明确的边界规则:区域超出图像时会自动调整以适配图像范围。文档还说明,超出图像宽或高的坐标会被移到有效位置,裁切宽或高也会按需要缩小。这是两个节点各自文档契约的差异,不是所有 ComfyUI 裁切节点通用的规则。
按四步完成裁切核对
- 读取输入图像的实际尺寸,先记宽、再记高。不要用缩小后的预览尺寸代替原图尺寸。
- 查看工作流中选中的具体节点。确认它使用独立的
x、y、width、height输入(ImageCrop),还是使用crop_region(ImageCropV2)。 - 选择目标左上角和裁切尺寸,计算
right = x + width、bottom = y + height。将右边界与图像宽度比较、下边界与图像高度比较;同时确认起始坐标没有落在图像范围外。 - 运行工作流,检查输出尺寸和实际可见区域。若矩形完全在图内,对照输入图像核查位置和边缘;若请求超界,记录实际节点和参数,不要预先假定
ImageCrop会如何处理。
用边界核对表验收
下表中的尺寸和参数均为假设值,用来展示应如何计算以及文档支持到什么程度,不是测试结果。
| 情况 | 输入尺寸与请求矩形 | 边界核算 | 文档预期与核对方式 |
|---|---|---|---|
| 完全在图内 | 640 × 480;x=100、y=60、width=200、height=150 | 右边界 300;下边界 210 | 两个节点的定义都描述了矩形裁切;检查输出是否为 200 × 150,以及内容位置是否正确。 |
| 几何边界与右、下边缘重合 | 640 × 480;x=440、y=330、width=200、height=150 | 半开矩形 [440, 640) × [330, 480);右边界 640;下边界 480 | 作为几何矩形,其边界与图像尺寸重合。这一算术关系不能保证每种节点实现如何处理边缘坐标;检查所用节点的输出尺寸和角落内容。 |
| 超出右边缘 | 640 × 480;x=580、y=60、width=120、height=100 | 右边界 700;下边界 160 | V2 文档说明会调整到图内;ImageCrop 文档未说明结果。 |
| 起点已在图外 | 640 × 480;x=700、y=500、width=80、height=80 | 起点同时超过宽度和高度 | V2 文档说明会将越界坐标移至有效位置并调整裁切区域;不要据此推断 ImageCrop 的行为。 |
结果异常时如何继续
如果输出比预期小、位置偏移或内容区域不对,先重新确认节点名称和输入图像尺寸,再计算右、下边界,判断矩形是否越过原图范围。若确实超界,只有在工作流使用 ImageCropV2 时才依据其文档预期;若使用 ImageCrop,应核查当前安装节点的实际行为,或把请求矩形调整到图内。现有文档没有确定 ImageCrop 的超界结果,也没有为所有其他裁切节点规定统一的坐标约定。
`x=0, y=0` 是从图像左上角开始吗? 是。文档将图像左上角作为裁切矩形的起点。
裁切区域终点恰好等于图像宽度,算超界吗? 不算。若 x + width 等于图像宽度,矩形右边缘只是到达边界,并未越过;下边缘同理,用 y + height 与图像高度比较。
`ImageCrop` 会自动缩小超出原图的裁切框吗? 引用的文档没有这样说明。自动调整是 ImageCropV2 明确记载的行为,应先核实工作流使用的节点。
来源与下一步
本文依据公开文档解释操作,并使用明确标注的假设验收示例,不是软件实测。控件与可用功能可能变化,请对照所引手册和你的安装版本。
若你在 Imagild 中继续创作,可将输入要求和验收清单带到照片编辑器。上文讨论的外部软件控件属于其各自产品。