> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# CropByBBoxes - ComfyUI Built-in Node Documentation

> Complete documentation for the CropByBBoxes node in ComfyUI. Learn its inputs, outputs, parameters and usage.

CropByBBoxes 节点从输入图像批次中提取并调整特定矩形区域的大小。它使用提供的边界框坐标来定义每个图像的裁剪区域。裁剪后的区域会被调整到指定的输出尺寸，并可以选择拉伸裁剪区域或填充以保持其原始宽高比。

## 输入

| 参数              | 描述                                               | 数据类型        | 是否必需 | 范围                       |
| --------------- | ------------------------------------------------ | ----------- | ---- | ------------------------ |
| `image`         | 待裁剪的输入图像批次。                                      | IMAGE       | 是    | -                        |
| `bboxes`        | 定义裁剪区域的边界框列表。此输入为强制连接，必须连接。                      | BOUNDINGBOX | 是    | -                        |
| `output_width`  | 每个裁剪区域调整后的宽度（默认值：512）。                           | INT         | 否    | 64 - 4096                |
| `output_height` | 每个裁剪区域调整后的高度（默认值：512）。                           | INT         | 否    | 64 - 4096                |
| `padding`       | 裁剪前在边界框每侧添加的额外像素填充（默认值：0）。                       | INT         | 否    | 0 - 1024                 |
| `保持宽高比`         | 是否拉伸裁剪区域以适配输出尺寸，或使用黑色像素填充以保持其宽高比（默认值："stretch"）。 | COMBO       | 否    | `"stretch"`<br />`"pad"` |

**注意：** 该节点每次处理一帧图像。如果为单帧提供了多个边界框，则会计算一个单一的裁剪区域，该区域是所有提供框的并集（包含所有框的最小矩形）。如果计算出的裁剪区域无效（例如宽度或高度为零），节点将从图像的中心顶部创建一个备用裁剪区域。

## 输出

| 输出名称    | 描述                       | 数据类型  |
| ------- | ------------------------ | ----- |
| `image` | 所有裁剪并调整大小后的区域，堆叠成一个图像批次。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CropByBBoxes/zh.md)

***

**Source fingerprint (SHA-256):** `9c0b3078405567911731c42e1873c57c77363e21ef6805769730667c811b0a0b`