## 概述

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-TW.md)

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