Comfy-Org · lin-bot23 · Aug 8, 2026
diff --git a/comfyui_embedded_docs/docs/AddLayer/ar.md b/comfyui_embedded_docs/docs/AddLayer/ar.md
@@ -0,0 +1,41 @@
+# AddLayer
+
+عقدة إضافة الطبقة (Add Layer) تحوّل صورة الإدخال إلى طبقة وتضعها على لوحة الرسم، إما ببدء مكدس طبقات جديد أو بإلحاقها بمكدس موجود. يمكنك تعيين اسم الطبقة وموضعها وحجمها ودورانها وشفافيتها ووضع المزج وترتيب التراص والقلب الأفقي أو الرأسي. هذه العقدة مُعلَّمة كتجريبية.
+
+## المدخلات
+
+| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
+|-----------|-------------|-----------|----------|-------|
+| `layers` | مكدس الطبقات المطلوب الإلحاق به. اتركه غير موصول لبدء مكدس جديد. | LAYERS | لا | — |
+| `image` | محتوى الطبقة بحجمه الأصلي. الدفعة تتوسع إلى طبقات متتالية. | IMAGE | نعم | — |
+| `mask` | قناع الشفافية لهذه الطبقة. المناطق المُقنَّعة (القيمة 1) تصبح شفافة، وتُضرب مع أي قناة ألفا تحملها الصورة بالفعل. | MASK | لا | — |
+| `name` | اسم الطبقة المعروض في محرر التركيب. (الافتراضي: "") | STRING | لا | — |
+| `x` | الموضع الأفقي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION |
+| `y` | الموضع الرأسي الأولي على لوحة الرسم. (الافتراضي: 0) | INT | لا | من -MAX_RESOLUTION إلى MAX_RESOLUTION |
+| `opacity` | الشفافية الأولية للطبقة. (الافتراضي: 1.0) | FLOAT | لا | من 0.0 إلى 1.0 (الخطوة: 0.01) |
+| `blend_mode` | وضع المزج الأولي، ويُطبَّق على الطبقات السفلية. على الطبقة السفلية فوق الخلفية الشفافة الافتراضية، تُنتج الأوضاع غير الوضع العادي شفافية. (الافتراضي: "normal") | COMBO | لا | خيارات متعددة متاحة |
+| `rotation` | الدوران الأولي بالدرجات، في اتجاه عقارب الساعة. (الافتراضي: 0.0) | FLOAT | لا | من -360.0 إلى 360.0 (الخطوة: 1.0) |
+| `width` | العرض الأولي للطبقة. القيمة 0 تُبقي العرض الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION |
+| `height` | الارتفاع الأولي للطبقة. القيمة 0 تُبقي الارتفاع الأصلي للصورة. (الافتراضي: 0) | INT | لا | من 0 إلى MAX_RESOLUTION |
+| `z_index` | تجاوز ترتيب التراص. تُفرز الطبقات فرزًا مستقرًا حسب z_index؛ والقيم المتساوية تحتفظ بترتيبها في القائمة. (الافتراضي: 0) | INT | لا | من -1000 إلى 1000 |
+| `flip_h` | قلب الطبقة أفقيًا. (الافتراضي: False) | BOOLEAN | لا | false / true |
+| `flip_v` | قلب الطبقة رأسيًا. (الافتراضي: False) | BOOLEAN | لا | false / true |
+
+ملاحظات:
+- فقط `image` مطلوب؛ جميع المدخلات الأخرى اختيارية.
+- عندما يُترك `layers` غير موصول، يتم إنشاء مكدس طبقات جديد. وعندما يتم توصيل مكدس طبقات، تُلحق الطبقة الجديدة به.
+- تُنشئ دفعة الصور في مدخل `image` طبقات متتالية متعددة.
+- القيمتان الافتراضيتان لكل من `width` و`height` تساويان 0، مما يُبقي الأبعاد الأصلية للصورة. والقيم الأكبر من 0 تتجاوز حجم العرض.
+- لا تُطبَّق `opacity` و`blend_mode` و`rotation` و`width` و`height` إلا عندما تختلف عن قيمها الافتراضية.
+- يتم الحفاظ على حجم لوحة الرسم لمكدس الطبقات المتصل في المخرجات.
+
+## المخرجات
+
+| اسم المخرج | الوصف | نوع البيانات |
+|-------------|-------------|-----------|
+| `layers` | مكدس الطبقات مع هذه الطبقة المُلحقة به. | LAYERS |
+
+> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AddLayer/ar.md)
+
+---
+**Source fingerprint (SHA-256):** `b7bf1a012d17cb5768b49d5c0617e13562ba015f695e6c9b1d1bbefba4150f9e`
diff --git a/comfyui_embedded_docs/docs/AddLayer/en.md b/comfyui_embedded_docs/docs/AddLayer/en.md
@@ -0,0 +1,41 @@
+# AddLayer
+
+The Add Layer node turns an input image into a layer and places it on a canvas, either starting a new layer stack or appending it to an existing one. You can set the layer's name, position, size, rotation, opacity, blend mode, stacking order, and horizontal or vertical flipping. This node is marked as experimental.
+
+## Inputs
+
+| Parameter | Description | Data Type | Required | Range |
+|-----------|-------------|-----------|----------|-------|
+| `layers` | Layer stack to append to. Leave unconnected to start a new stack. | LAYERS | No | — |
+| `image` | Layer content at its native size. A batch expands to consecutive layers. | IMAGE | Yes | — |
+| `mask` | Transparency mask for this layer. Masked areas (value 1) become transparent, multiplying with any alpha channel the image already carries. | MASK | No | — |
+| `name` | Layer name shown in the compositor editor. (default: "") | STRING | No | — |
+| `x` | Initial horizontal placement on the canvas. (default: 0) | INT | No | -MAX_RESOLUTION to MAX_RESOLUTION |
+| `y` | Initial vertical placement on the canvas. (default: 0) | INT | No | -MAX_RESOLUTION to MAX_RESOLUTION |
+| `opacity` | Initial layer opacity. (default: 1.0) | FLOAT | No | 0.0 to 1.0 (step: 0.01) |
+| `blend_mode` | Initial blend mode, applied against the layers below. On the bottom layer over the default transparent background, non-normal modes produce transparency. (default: "normal") | COMBO | No | Multiple options available |
+| `rotation` | Initial rotation in degrees, clockwise. (default: 0.0) | FLOAT | No | -360.0 to 360.0 (step: 1.0) |
+| `width` | Initial display width. 0 keeps the image's native width. (default: 0) | INT | No | 0 to MAX_RESOLUTION |
+| `height` | Initial display height. 0 keeps the image's native height. (default: 0) | INT | No | 0 to MAX_RESOLUTION |
+| `z_index` | Stacking override. Layers are stable-sorted by z_index; equal values keep their list order. (default: 0) | INT | No | -1000 to 1000 |
+| `flip_h` | Flip the layer horizontally. (default: False) | BOOLEAN | No | false / true |
+| `flip_v` | Flip the layer vertically. (default: False) | BOOLEAN | No | false / true |
+
+Notes:
+- Only `image` is required; all other inputs are optional.
+- When `layers` is left unconnected, a new layer stack is created. When a layer stack is connected, the new layer is appended to it.
+- A batch of images in the `image` input creates multiple consecutive layers.
+- `width` and `height` default to 0, which keeps the image's native dimensions. Values greater than 0 override the display size.
+- `opacity`, `blend_mode`, `rotation`, `width`, and `height` are only applied when they differ from their default values.
+- The canvas size of a connected layer stack is preserved in the output.
+
+## Outputs
+
+| Output Name | Description | Data Type |
+|-------------|-------------|-----------|
+| `layers` | The layer stack with this layer appended. | LAYERS |
+
+> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AddLayer/en.md)
+
+---
+**Source fingerprint (SHA-256):** `b7bf1a012d17cb5768b49d5c0617e13562ba015f695e6c9b1d1bbefba4150f9e`
diff --git a/comfyui_embedded_docs/docs/AddLayer/es.md b/comfyui_embedded_docs/docs/AddLayer/es.md
@@ -0,0 +1,41 @@
+# AddLayer
+
+El nodo Add Layer convierte una imagen de entrada en una capa y la coloca en un lienzo, ya sea iniciando una nueva pila de capas o añadiéndola a una existente. Puede establecer el nombre, la posición, el tamaño, la rotación, la opacidad, el modo de fusión, el orden de apilamiento y el volteo horizontal o vertical de la capa. Este nodo está marcado como experimental.
+
+## Entradas
+
+| Parámetro | Descripción | Tipo de dato | Requerido | Rango |
+|-----------|-------------|--------------|-----------|-------|
+| `layers` | Pila de capas a la que se añadirá. Si se deja sin conectar, se inicia una nueva pila. | LAYERS | No | — |
+| `image` | Contenido de la capa en su tamaño nativo. Un lote se expande a capas consecutivas. | IMAGE | Sí | — |
+| `mask` | Máscara de transparencia para esta capa. Las áreas enmascaradas (valor 1) se vuelven transparentes, multiplicándose con cualquier canal alfa que la imagen ya contenga. | MASK | No | — |
+| `name` | Nombre de la capa mostrado en el editor del compositor. (predeterminado: "") | STRING | No | — |
+| `x` | Posición horizontal inicial en el lienzo. (predeterminado: 0) | INT | No | -MAX_RESOLUTION a MAX_RESOLUTION |
+| `y` | Posición vertical inicial en el lienzo. (predeterminado: 0) | INT | No | -MAX_RESOLUTION a MAX_RESOLUTION |
+| `opacity` | Opacidad inicial de la capa. (predeterminado: 1.0) | FLOAT | No | 0.0 a 1.0 (paso 0.01) |
+| `blend_mode` | Modo de fusión inicial, aplicado contra las capas inferiores. En la capa inferior sobre el fondo transparente predeterminado, los modos no normales producen transparencia. (predeterminado: "normal") | COMBO | No | Múltiples opciones disponibles |
+| `rotation` | Rotación inicial en grados, en sentido horario. (predeterminado: 0.0) | FLOAT | No | -360.0 a 360.0 (paso 1.0) |
+| `width` | Ancho de visualización inicial. 0 conserva el ancho nativo de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION |
+| `height` | Altura de visualización inicial. 0 conserva la altura nativa de la imagen. (predeterminado: 0) | INT | No | 0 a MAX_RESOLUTION |
+| `z_index` | Anulación del orden de apilamiento. Las capas se ordenan de forma estable por z_index; los valores iguales mantienen su orden en la lista. (predeterminado: 0) | INT | No | -1000 a 1000 |
+| `flip_h` | Voltear la capa horizontalmente. (predeterminado: False) | BOOLEAN | No | false / true |
+| `flip_v` | Voltear la capa verticalmente. (predeterminado: False) | BOOLEAN | No | false / true |
+
+Notas:
+- Solo se requiere `image`; todos los demás parámetros son opcionales.
+- Cuando `layers` se deja sin conectar, se crea una nueva pila de capas. Cuando se conecta una pila de capas, la nueva capa se añade a ella.
+- Un lote de imágenes en el parámetro `image` crea múltiples capas consecutivas.
+- `width` y `height` tienen como predeterminado 0, lo que conserva las dimensiones nativas de la imagen. Los valores mayores que 0 anulan el tamaño de visualización.
+- `opacity`, `blend_mode`, `rotation`, `width` y `height` solo se aplican cuando difieren de sus valores predeterminados.
+- El tamaño del lienzo de una pila de capas conectada se conserva en la salida.
+
+## Salidas
+
+| Nombre de salida | Descripción | Tipo de dato |
+|------------------|-------------|--------------|
+| `layers` | La pila de capas con esta capa añadida. | LAYERS |
+
+> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AddLayer/es.md)
+
+---
+**Source fingerprint (SHA-256):** `b7bf1a012d17cb5768b49d5c0617e13562ba015f695e6c9b1d1bbefba4150f9e`
diff --git a/comfyui_embedded_docs/docs/AddLayer/fa.md b/comfyui_embedded_docs/docs/AddLayer/fa.md
@@ -0,0 +1,41 @@
+# AddLayer
+
+گره «Add Layer» یک تصویر ورودی را به یک لایه تبدیل می‌کند و آن را روی بوم قرار می‌دهد؛ یا یک پشته لایه جدید شروع می‌کند یا آن را به پشته‌ای موجود اضافه می‌کند. می‌توانید نام، موقعیت، اندازه، چرخش، تیرگی، حالت ترکیب، ترتیب قرارگیری و قرینه‌سازی افقی یا عمودی لایه را تنظیم کنید. این گره به‌عنوان آزمایشی علامت‌گذاری شده است.
+
+## ورودی‌ها
+
+| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
+|-----------|-------------|-----------|----------|-------|
+| `layers` | پشته لایه‌ای که باید به آن اضافه شود. برای شروع یک پشته جدید، اتصال را خالی بگذارید. | LAYERS | خیر | — |
+| `image` | محتوای لایه در اندازه اصلی خود. یک دسته (batch) به لایه‌های متوالی گسترش می‌یابد. | IMAGE | بله | — |
+| `mask` | ماسک شفافیت برای این لایه. نواحی ماسک‌شده (مقدار ۱) شفاف می‌شوند و با هر کانال آلفایی که تصویر از قبل دارد ترکیب (ضرب) می‌شوند. | MASK | خیر | — |
+| `name` | نام لایه که در ویرایشگر کامپوزیت نمایش داده می‌شود. (پیش‌فرض: "") | STRING | خیر | — |
+| `x` | موقعیت افقی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION |
+| `y` | موقعیت عمودی اولیه روی بوم. (پیش‌فرض: 0) | INT | خیر | -MAX_RESOLUTION تا MAX_RESOLUTION |
+| `opacity` | تیرگی اولیه لایه. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0 (گام: 0.01) |
+| `blend_mode` | حالت ترکیب اولیه که روی لایه‌های زیرین اعمال می‌شود. در لایه پایینی روی پس‌زمینه شفاف پیش‌فرض، حالت‌های غیر از normal باعث ایجاد شفافیت می‌شوند. (پیش‌فرض: "normal") | COMBO | خیر | چند گزینه موجود است |
+| `rotation` | چرخش اولیه بر حسب درجه، در جهت عقربه‌های ساعت. (پیش‌فرض: 0.0) | FLOAT | خیر | -360.0 تا 360.0 (گام: 1.0) |
+| `width` | عرض نمایش اولیه. ۰ عرض اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
+| `height` | ارتفاع نمایش اولیه. ۰ ارتفاع اصلی تصویر را حفظ می‌کند. (پیش‌فرض: 0) | INT | خیر | 0 تا MAX_RESOLUTION |
+| `z_index` | بازنویسی ترتیب قرارگیری. لایه‌ها به‌صورت پایدار بر اساس z_index مرتب می‌شوند؛ مقادیر برابر ترتیب فهرست را حفظ می‌کنند. (پیش‌فرض: 0) | INT | خیر | -1000 تا 1000 |
+| `flip_h` | قرینه‌سازی افقی لایه. (پیش‌فرض: False) | BOOLEAN | خیر | false / true |
+| `flip_v` | قرینه‌سازی عمودی لایه. (پیش‌فرض: 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`