# AddLayer

گره «Add Layer» یک تصویر ورودی را به یک لایه تبدیل می‌کند و آن را روی بوم قرار می‌دهد؛ یا یک پشته لایه جدید شروع می‌کند یا آن را به پشته‌ای موجود اضافه می‌کند. می‌توانید نام، موقعیت، اندازه، چرخش، تیرگی، حالت ترکیب، ترتیب قرارگیری و قرینه‌سازی افقی یا عمودی لایه را تنظیم کنید. این گره به‌عنوان آزمایشی علامت‌گذاری شده است.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `لایه‌ها` | پشته لایه‌ای که باید به آن اضافه شود. برای شروع یک پشته جدید، اتصال را خالی بگذارید. | LAYERS | خیر | — |
| `تصویر` | محتوای لایه در اندازه اصلی خود. یک دسته (batch) به لایه‌های متوالی گسترش می‌یابد. | IMAGE | بله | — |
| `ماسک` | ماسک شفافیت برای این لایه. نواحی ماسک‌شده (مقدار ۱) شفاف می‌شوند و با هر کانال آلفایی که تصویر از قبل دارد ترکیب (ضرب) می‌شوند. | MASK | خیر | — |
| `نام` | نام لایه که در ویرایشگر کامپوزیت نمایش داده می‌شود. (پیش‌فرض: "") | STRING | خیر | — |
| `x` | موقعیت افقی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION |
| `y` | موقعیت عمودی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION |
| `شفافیت` | تیرگی اولیه لایه. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0 (گام: 0.01) |
| `حالت ترکیب` | حالت ترکیب اولیه که روی لایه‌های زیرین اعمال می‌شود. در لایه پایینی روی پس‌زمینه شفاف پیش‌فرض، حالت‌های غیر از normal باعث ایجاد شفافیت می‌شوند. (پیش‌فرض: "normal") | COMBO | خیر | چند گزینه موجود است |
| `چرخش` | چرخش اولیه بر حسب درجه، در جهت عقربه‌های ساعت. (پیش‌فرض: 0.0) | FLOAT | خیر | -360.0 تا 360.0 (گام: 1.0) |
| `عرض` | عرض نمایش اولیه. ۰ عرض اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
| `ارتفاع` | ارتفاع نمایش اولیه. ۰ ارتفاع اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
| `z_index` | بازنویسی ترتیب قرارگیری. لایه‌ها به‌صورت پایدار بر اساس z_index مرتب می‌شوند؛ مقادیر برابر ترتیب فهرست را حفظ می‌کنند. (پیش‌فرض: 0) | INT | خیر | -1000 تا 1000 |
| `وارونه افقی` | قرینه‌سازی افقی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |
| `وارونه عمودی` | قرینه‌سازی عمودی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |

نکات:
- فقط `image` الزامی است؛ سایر ورودی‌ها اختیاری هستند.
- هنگامی که `layers` بدون اتصال رها شود، یک پشته لایه جدید ایجاد می‌شود. وقتی یک پشته لایه متصل باشد، لایه جدید به آن اضافه می‌شود.
- یک دسته از تصاویر در ورودی `image` چندین لایه متوالی ایجاد می‌کند.
- `width` و `height` به‌طور پیش‌فرض برابر ۰ هستند که ابعاد اصلی تصویر را حفظ می‌کند. مقادیر بیشتر از ۰ اندازه نمایش را بازنویسی می‌کنند.
- `opacity`، `blend_mode`، `rotation`، `width` و `height` فقط زمانی اعمال می‌شوند که با مقادیر پیش‌فرض خود متفاوت باشند.
- اندازه بوم یک پشته لایه متصل در خروجی حفظ می‌شود.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `layers` | پشته لایه با این لایه اضافه‌شده. | LAYERS |

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

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