# برش تصویر بر اساس ماسک

تصویر را به جعبه محدودکننده ماسک آن برش می‌دهد و سوژه‌ای مرکزشده روی یک رنگ پس‌زمینه یکدست تولید می‌کند. این گره تصویر ماسک‌شده را روی پس‌زمینه انتخاب‌شده ترکیب می‌کند و نتیجه را به ابعاد خروجی مشخص‌شده تغییر اندازه می‌دهد؛ به این ترتیب برای پایپ‌لاین‌های سه‌بعدی مناسب می‌شود که انتظار سوژه‌ای مرکزشده و بدون پس‌زمینه در یک رزولوشن ثابت دارند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `تصاویر` | تصویر ورودی یا دسته‌ای از تصاویر برای برش. | IMAGE | بله | — |
| `ماسک‌ها` | ماسک یا دسته‌ای از ماسک‌ها که ناحیه سوژه را مشخص می‌کند. یک ماسک واحد روی همه تصاویر اعمال می‌شود؛ در غیر این صورت اندازه دسته ماسک باید با اندازه دسته تصویر مطابقت داشته باشد. اگر رزولوشن ماسک با رزولوشن تصویر متفاوت باشد، ماسک به‌طور خودکار برای مطابقت تغییر اندازه داده می‌شود. | MASK | بله | — |
| `عرض` | عرض خروجی بر حسب پیکسل. (پیش‌فرض: 1024) | INT | بله | 64 تا 4096 (گام 8) |
| `ارتفاع` | ارتفاع خروجی بر حسب پیکسل. (پیش‌فرض: 1024) | INT | بله | 64 تا 4096 (گام 8) |
| `pad_factor` | حاشیه اضافی حول جعبه محدودکننده ماسک به‌صورت ضریب. (پیش‌فرض: 1.0) | FLOAT | بله | 1.0 تا 2.0 (گام 0.01) |
| `grow_mask` | ماسک را قبل از برش به اندازه این تعداد پیکسل بزرگ یا کوچک می‌کند. مقادیر مثبت ماسک را گسترش می‌دهند و مقادیر منفی آن را کوچک می‌کنند. (پیش‌فرض: 0) | INT | بله | -32 تا 32 (گام 1) |
| `پس‌زمینه` | رنگ پس‌زمینه پشت سوژه ماسک‌شده. (پیش‌فرض: #000000) | COLOR | بله | — |

نکته: ناحیه برش حول جعبه محدودکننده ماسک مرکز می‌شود و نسبت ابعاد آن با `width` / `height` مطابقت دارد. این گره به‌طور خودکار ماسک معکوس را تشخیص می‌دهد و اصلاح می‌کند (پیکسل‌های پیش‌زمینه در لبه‌ها و پس‌زمینه در مرکز). اگر ماسک هیچ پیکسل پیش‌زمینه‌ای نداشته باشد، گره ماسک معکوس را امتحان می‌کند؛ اگر آن هم خالی باشد، هشداری ثبت می‌کند و کل تصویر را برش می‌دهد. زمانی که اندازه دسته ماسک با اندازه دسته تصویر مطابقت نداشته باشد و ماسک واحد نباشد، خطا ایجاد می‌شود.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `images` | تصاویر ترکیبی برش‌خورده (سوژه ماسک‌شده روی رنگ پس‌زمینه انتخاب‌شده)، تغییر اندازه‌داده‌شده به `width` × `height`. اندازه دسته با دسته تصویر ورودی مطابقت دارد. | IMAGE |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ImageCropToMask/fa.md)

---
**Source fingerprint (SHA-256):** `fcc14b5db7318699526dd544d404f78f9d1ab362b73769276f113f2b1062b214`
