# Patina Material

تولید یک ماده PBR کامل و بدون‌درز با قابلیت کاشی‌شدن از یک توصیف متنی: یک بافت پایه به‌همراه حداکثر پنج نقشه مواد، با بزرگ‌نمایی اختیاری نقشه‌ها توسط SeedVR. یک تصویر ورودی می‌تواند نتیجه را به‌صورت یک پاس image-to-image هدایت کند، و یک تصویر ورودی همراه با ماسک آن را به پاس inpaint تبدیل می‌کند. از آن برای تولید سطوح آماده بازی یا آماده 3D بدون اسکن یک ماده واقعی استفاده کنید.

## ورودی‌ها

| پارامتر | توضیح | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `prompt` | توصیف ماده یا بافت برای تولید. | STRING | بله | متن چندخطی |
| `image_size` | اندازه بافت خروجی. انتخاب `"custom"` ورودی‌های `width` و `height` را نمایش می‌دهد. پیش‌فرض: `"1:1 (1024x1024)"`. | DYNAMIC_COMBO | بله | `"1:1 (1024x1024)"`<br>`"1:1 (512x512)"`<br>`"4:3 (1024x768)"`<br>`"3:4 (768x1024)"`<br>`"16:9 (1024x576)"`<br>`"9:16 (576x1024)"`<br>`"custom"` |
| `basecolor` | نقشه basecolor (albedo) را تولید می‌کند. پیش‌فرض: True. | BOOLEAN | بله | true<br>false |
| `normal` | نقشه normal را تولید می‌کند. پیش‌فرض: True. | BOOLEAN | بله | true<br>false |
| `roughness` | نقشه roughness را تولید می‌کند. پیش‌فرض: False. | BOOLEAN | بله | true<br>false |
| `metalness` | نقشه metalness را تولید می‌کند. پیش‌فرض: False. | BOOLEAN | بله | true<br>false |
| `height` | نقشه height (جابه‌جایی) را تولید می‌کند. پیش‌فرض: False. | BOOLEAN | بله | true<br>false |
| `upscale_factor` | بزرگ‌نمایی بدون‌درز نقشه‌های PBR با SeedVR. بافت پایه بزرگ‌نمایی نمی‌شود، و 4x یک نقشه 2048 پیکسلی را به یک نقشه 8K تبدیل می‌کند. پیش‌فرض: 0 (خاموش). | INT | بله | 0 تا 4 (گام 2) |
| `seed` | دانه برای تولید قابل‌تکرار. پیش‌فرض: 42. | INT | بله | 0 تا 2147483646 |
| `tiling_mode` | جهت کاشی‌کاری: همه‌جهته، افقی یا عمودی. تنظیم پیشرفته. پیش‌فرض: `"both"`. | COMBO | بله | `"both"`<br>`"horizontal"`<br>`"vertical"` |
| `num_inference_steps` | گام‌های نویززدایی برای تولید بافت. تنظیم پیشرفته. پیش‌فرض: 8. | INT | بله | 1 تا 8 |
| `tile_size` | اندازه کاشی در فضای latent، که 64 یعنی 512 پیکسل و 128 یعنی 1024 پیکسل. تنظیم پیشرفته. پیش‌فرض: 128. | INT | بله | 32 تا 256 (گام 2) |
| `tile_stride` | گام کاشی در فضای latent. تنظیم پیشرفته. پیش‌فرض: 64. | INT | بله | 16 تا 128 (گام 2) |
| `image` | تصویر منبع اختیاری. به‌تنهایی پاس image-to-image را اجرا می‌کند؛ همراه با ماسک، پاس inpaint را اجرا می‌کند. | IMAGE | خیر | - |
| `mask` | ماسک inpaint اختیاری، به یک تصویر ورودی نیاز دارد. نواحی سفید بازتولید می‌شوند و نواحی سیاه حفظ می‌شوند. | MASK | خیر | - |
| `strength` | میزان تغییر تصویر ورودی. فقط زمانی استفاده می‌شود که تصویری متصل باشد. تنظیم پیشرفته. پیش‌فرض: 0.6. | FLOAT | بله | 0.01 تا 1.0 (گام 0.01) |
| `prompt_expansion` | پرامپت را با یک مدل زبانی برای جزئیات بافت غنی‌تر گسترش می‌دهد. به‌طور پیش‌فرض خاموش است، زیرا گسترش، پرامپت را به‌صورت یک عکس بازتعریف می‌کند و معمولاً نقشه metalness را کم‌رنگ می‌کند. تنظیم پیشرفته. | BOOLEAN | بله | true<br>false |
| `safety_checker` | بررسی ایمنی محتوای ارائه‌دهنده را روی درخواست اجرا می‌کند. تنظیم پیشرفته. پیش‌فرض: False. | BOOLEAN | بله | true<br>false |

### ورودی‌های اندازه تصویر سفارشی

این ورودی‌ها زمانی ظاهر می‌شوند که `image_size` روی `"custom"` تنظیم شده باشد.

| پارامتر | توضیح | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `image_size.width` | عرض بافت بر حسب پیکسل. پیش‌فرض: 1024. | INT | بله | 512 تا 2048 (گام 16) |
| `image_size.height` | ارتفاع بافت بر حسب پیکسل. پیش‌فرض: 1024. | INT | بله | 512 تا 2048 (گام 16) |

**محدودیت‌ها و رفتار:**

* فعال نکردن هیچ نقشه موادی مجاز است: در این حالت گره فقط بافت پایه را برمی‌گرداند و همه خروجی‌های نقشه به‌صورت یک جانگهدار 1x1 باقی می‌مانند.
* ماسک به یک تصویر ورودی نیاز دارد؛ ماسک به‌تنهایی خطا ایجاد می‌کند.
* نتیجه 8K از بزرگ‌نمایی 4x نقشه‌های یک رندر 2048 پیکسلی به‌دست می‌آید، نه از یک تولید 8K واحد.

## خروجی‌ها

| نام خروجی | توضیح | نوع داده |
|-------------|-------------|-----------|
| `texture` | بافت پایه ماده، بدون اعمال هیچ نقشه‌ای. | IMAGE |
| `basecolor` | نقشه basecolor (albedo)، یا یک جانگهدار 1x1 وقتی آن نقشه غیرفعال است. | IMAGE |
| `normal` | نقشه normal، یا یک جانگهدار 1x1 وقتی آن نقشه غیرفعال است. | IMAGE |
| `roughness` | نقشه roughness، یا یک جانگهدار 1x1 وقتی آن نقشه غیرفعال است. | IMAGE |
| `metalness` | نقشه metalness، یا یک جانگهدار 1x1 وقتی آن نقشه غیرفعال است. | IMAGE |
| `height` | نقشه height (جابه‌جایی)، یا یک جانگهدار 1x1 وقتی آن نقشه غیرفعال است. | IMAGE |
| `expanded_prompt` | پرامپتی که ارائه‌دهنده واقعاً استفاده کرده است، که تنها زمانی با ورودی تفاوت دارد که `prompt_expansion` فعال باشد. | STRING |

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

---
**Source fingerprint (SHA-256):** `4e8305fa56a29dce72c54de12ae05207e8de39a1fea1f4753906c26e8af60383`
