گره Painter یک بوم تعاملی برای ایجاد یا ویرایش تصاویر و ماسک‌ها به‌طور مستقیم در ComfyUI فراهم می‌کند. این گره به شما امکان می‌دهد با یک بوم خالی یا یک تصویر موجود شروع کنید، با استفاده از ابزار قلم‌مو روی آن نقاشی کنید و هم تصویر نهایی و هم یک ماسک آلفای متناظر را خروجی دهد. ماسک نواحی نقاشی‌شده را مشخص می‌کند که سپس روی تصویر پایه یا رنگ پس‌زمینه ترکیب می‌شوند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
| --- | --- | --- | --- | --- |
| `تصویر` | تصویر پایه اختیاری برای نقاشی روی آن. در صورت عدم ارائه، یک بوم خالی با استفاده از رنگ پس‌زمینه، عرض و ارتفاع مشخص‌شده ایجاد می‌شود. | IMAGE | خیر | - |
| `mask` | داده‌های نقاشی که معمولاً توسط ویجت تعاملی داخلی گره تولید می‌شود. این پارامتر توسط ابزار نقاش رابط کاربری مدیریت می‌شود و برای اتصال به یک سوکت استاندارد در نظر گرفته نشده است. | STRING | بله | - |
| `عرض` | عرض بوم بر حسب پیکسل، زمانی که هیچ `تصویر` پایه‌ای ارائه نشده است استفاده می‌شود. مقدار باید مضربی از 64 باشد. پیش‌فرض 512 است. | INT | بله | 64 تا 4096 |
| `ارتفاع` | ارتفاع بوم بر حسب پیکسل، زمانی که هیچ `تصویر` پایه‌ای ارائه نشده است استفاده می‌شود. مقدار باید مضربی از 64 باشد. پیش‌فرض 512 است. | INT | بله | 64 تا 4096 |
| `رنگ پس‌زمینه` | رنگ پس‌زمینه بوم که به صورت کد هگز (مثلاً #000000) مشخص می‌شود. این تنها زمانی استفاده می‌شود که هیچ `تصویر` پایه‌ای ارائه نشده باشد. پیش‌فرض سیاه (#000000) است. | COLOR | بله | - |

**نکته:** ورودی `mask` برای کار با ویجت رابط کاربری تخصصی گره طراحی شده است. هنگامی که روی بوم نقاشی می‌کنید، ویجت به‌طور خودکار این مقدار را پر می‌کند. ورودی‌های `width` و `height` در رابط کاربری استاندارد پنهان هستند اما هنگام ایجاد یک تصویر جدید، ابعاد بوم را تعریف می‌کنند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `IMAGE` | تصویر نهایی ترکیب‌شده. این نتیجه ادغام نواحی نقاشی‌شده (از `mask`) روی `تصویر` پایه ارائه‌شده یا پس‌زمینه رنگی است. | IMAGE |
| `MASK` | ماسک کانال آلفا (شفافیت) استخراج‌شده از نقاشی. نواحی سفید نشان‌دهنده مناطق نقاشی‌شده و نواحی سیاه نشان‌دهنده پس‌زمینه دست‌نخورده هستند. | MASK |

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

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