Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/ar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/ar.md)

# نظرة عامة

تحرير صورة واحدة باستخدام Beeble SwitchX. يمكن لهذه العقدة تبديل أي عنصر في المشهد (الخلفية، الإضاءة، الزي) مع الحفاظ على وحدات البكسل الأصلية للكائن الرئيسي. قم بتوفير صورة مرجعية و/أو نص وصفي لتحديد المظهر الجديد. الحد الأقصى للدقة هو حوالي 2.77 ميجابكسل.

# المدخلات

| المعامل | نوع البيانات | إلزامي | النطاق | الوصف |
|---------|---------------|--------|---------|-------------|
| `صورة` | IMAGE | نعم | - | الصورة المصدر المراد تحريرها. |
| `وصف نصي` | STRING | نعم | - | وصف نصي للمظهر الجديد المطلوب (مثال: "فارس يرتدي درعًا لامعًا"). |
| `وضع ألفا` | COMBO | نعم | `"select"`<br>`"fill"`<br>`"custom"` | كيفية معالجة قناة الشفافية ألفا. "select" تستخدم إطارًا مفتاحيًا لتحديد الكائن الرئيسي، "fill" تستبدل الصورة بأكملها بدون قناة شفافية منفصلة، "custom" تستخدم قناعًا يوفره المستخدم. |
| `أقصى دقة` | COMBO | نعم | `"1080p"`<br>`"720p"` | الحد الأقصى لدقة الصورة الناتجة. الدقة الأعلى تستهلك رصيدًا أكثر. |
| `البذرة` | INT | نعم | - | قيمة البذرة لإمكانية إعادة إنتاج النتائج. |
| `الصورة المرجعية` | IMAGE | لا | - | صورة مرجعية اختيارية لتوجيه نمط أو مظهر عناصر المشهد الجديدة. |

**ملاحظة حول `alpha_mode`:** عند ضبط `alpha_mode` على `"select"`، يجب أيضًا توفير `alpha_keyframe` (صورة إطار مفتاحي تستخدم لتحديد الكائن الرئيسي). عند ضبطه على `"custom"`، يجب توفير `alpha_mask` (قناع من إنشاء المستخدم). عند ضبطه على `"fill"`، لا حاجة لإدخال قناة شفافية.

# المخرجات

| اسم المخرج | نوع البيانات | الوصف |
|-------------|---------------|-------------|
| `صورة` | IMAGE | الصورة المحررة مع تبديل عناصر المشهد. |
| `alpha` | MASK | قناة الشفافية ألفا المستخدمة بواسطة Beeble. فارغة في وضع "fill" الذي لا يحتوي على قناة شفافية منفصلة. |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
28 changes: 28 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
> 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/BeebleSwitchXImageEdit/en.md)

## Overview

Edit a single image with Beeble SwitchX. This node can switch anything in the scene (background, lighting, costume) while preserving the original subject's pixels. Provide a reference image and/or text prompt to describe the new look. Maximum resolution is approximately 2.77 megapixels.

## Inputs

| Parameter | Data Type | Required | Range | Description |
|-----------|-----------|----------|-------|-------------|
| `image` | IMAGE | Yes | - | The source image to edit. |
| `prompt` | STRING | Yes | - | A text description of the desired new look (e.g., "a knight in shining armor"). |
| `alpha_mode` | COMBO | Yes | `"select"`<br>`"fill"`<br>`"custom"` | How to handle the alpha matte. "select" uses a keyframe to select the subject, "fill" replaces the entire image without a separate matte, "custom" uses a user-provided mask. |
| `max_resolution` | COMBO | Yes | `"1080p"`<br>`"720p"` | The maximum resolution for the output image. Higher resolution costs more credits. |
| `seed` | INT | Yes | - | A seed value for reproducibility. |
| `reference_image` | IMAGE | No | - | An optional reference image to guide the style or appearance of the new scene elements. |

**Note on `alpha_mode`:** When `alpha_mode` is set to `"select"`, you must also provide an `alpha_keyframe` (a keyframe image used to select the subject). When set to `"custom"`, you must provide an `alpha_mask` (a user-created mask). When set to `"fill"`, no alpha input is needed.

## Outputs

| Output Name | Data Type | Description |
|-------------|-----------|-------------|
| `image` | IMAGE | The edited image with the scene elements switched. |
| `alpha` | MASK | The alpha matte used by Beeble. Empty for "fill" mode, which has no separate matte. |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
30 changes: 30 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
> 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/BeebleSwitchXImageEdit/es.md)

# BeebleSwitchXImageEdit

## Resumen

Edita una sola imagen con Beeble SwitchX. Este nodo puede cambiar cualquier elemento de la escena (fondo, iluminación, vestimenta) mientras preserva los píxeles del sujeto original. Proporciona una imagen de referencia y/o un prompt de texto para describir el nuevo aspecto. La resolución máxima es de aproximadamente 2,77 megapíxeles.

## Entradas

| Parámetro | Tipo de Dato | Obligatorio | Rango | Descripción |
|-----------|--------------|-------------|-------|-------------|
| `imagen` | IMAGE | Sí | - | La imagen de origen a editar. |
| `prompt` | STRING | Sí | - | Una descripción textual del nuevo aspecto deseado (ej., "un caballero con armadura brillante"). |
| `modo_alpha` | COMBO | Sí | `"select"`<br>`"fill"`<br>`"custom"` | Cómo manejar el matte alfa. "select" usa un fotograma clave para seleccionar el sujeto, "fill" reemplaza toda la imagen sin un matte separado, "custom" usa una máscara proporcionada por el usuario. |
| `resolución_máxima` | COMBO | Sí | `"1080p"`<br>`"720p"` | La resolución máxima para la imagen de salida. Una resolución más alta consume más créditos. |
| `semilla` | INT | Sí | - | Un valor de semilla para reproducibilidad. |
| `imagen_de_referencia` | IMAGE | No | - | Una imagen de referencia opcional para guiar el estilo o la apariencia de los nuevos elementos de la escena. |

**Nota sobre `alpha_mode`:** Cuando `alpha_mode` está configurado en `"select"`, también debes proporcionar un `alpha_keyframe` (una imagen de fotograma clave usada para seleccionar el sujeto). Cuando está configurado en `"custom"`, debes proporcionar un `alpha_mask` (una máscara creada por el usuario). Cuando está configurado en `"fill"`, no se necesita entrada alfa.

## Salidas

| Nombre de Salida | Tipo de Dato | Descripción |
|------------------|--------------|-------------|
| `alfa` | IMAGE | La imagen editada con los elementos de la escena cambiados. |
| `alpha` | MASK | El matte alfa utilizado por Beeble. Vacío para el modo "fill", que no tiene matte separado. |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
28 changes: 28 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/fa.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/fa.md)

## نمای کلی

یک تصویر را با استفاده از Beeble SwitchX ویرایش کنید. این گره می‌تواند هر چیزی را در صحنه (پس‌زمینه، نورپردازی، لباس) تغییر دهد، در حالی که پیکسل‌های سوژه اصلی را حفظ می‌کند. یک تصویر مرجع و/یا توضیح متنی برای توصیف ظاهر جدید ارائه دهید. حداکثر رزولوشن تقریباً ۲.۷۷ مگاپیکسل است.

## ورودی‌ها

| پارامتر | نوع داده | الزامی | محدوده | توضیحات |
|-----------|-----------|----------|-------|-------------|
| `تصویر` | IMAGE | بله | - | تصویر مبدأ برای ویرایش. |
| `پرامپت` | STRING | بله | - | توضیح متنی از ظاهر جدید مورد نظر (مثلاً «یک شوالیه در زره درخشان»). |
| `حالت آلفا` | COMBO | بله | `"select"`<br>`"fill"`<br>`"custom"` | نحوه مدیریت مات آلفا. «select» از یک فریم کلیدی برای انتخاب سوژه استفاده می‌کند، «fill» کل تصویر را بدون مات جداگانه جایگزین می‌کند، «custom» از یک ماسک ارائه‌شده توسط کاربر استفاده می‌کند. |
| `حداکثر وضوح` | COMBO | بله | `"1080p"`<br>`"720p"` | حداکثر رزولوشن برای تصویر خروجی. رزولوشن بالاتر هزینه اعتبار بیشتری دارد. |
| `seed` | INT | بله | - | یک مقدار seed برای تکرارپذیری. |
| `تصویر مرجع` | IMAGE | خیر | - | یک تصویر مرجع اختیاری برای هدایت سبک یا ظاهر عناصر جدید صحنه. |

**نکته درباره `alpha_mode`:** وقتی `alpha_mode` روی `"select"` تنظیم شده است، باید یک `alpha_keyframe` (یک تصویر فریم کلیدی برای انتخاب سوژه) نیز ارائه دهید. وقتی روی `"custom"` تنظیم شده است، باید یک `alpha_mask` (یک ماسک ساخته‌شده توسط کاربر) ارائه دهید. وقتی روی `"fill"` تنظیم شده است، نیازی به ورودی آلفا نیست.

## خروجی‌ها

| نام خروجی | نوع داده | توضیحات |
|-------------|-----------|-------------|
| `تصویر` | IMAGE | تصویر ویرایش‌شده با عناصر صحنه تغییر یافته. |
| `alpha` | MASK | مات آلفای استفاده‌شده توسط Beeble. برای حالت «fill» که مات جداگانه‌ای ندارد، خالی است. |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
28 changes: 28 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/fr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/fr.md)

# Aperçu

Modifiez une seule image avec Beeble SwitchX. Ce nœud peut changer n'importe quel élément de la scène (arrière-plan, éclairage, costume) tout en préservant les pixels du sujet d'origine. Fournissez une image de référence et/ou une invite textuelle pour décrire le nouvel aspect. La résolution maximale est d'environ 2,77 mégapixels.

## Entrées

| Paramètre | Type de données | Requis | Plage | Description |
|-----------|-----------------|--------|-------|-------------|
| `image` | IMAGE | Oui | - | L'image source à modifier. |
| `invite` | STRING | Oui | - | Une description textuelle du nouvel aspect souhaité (par exemple, "un chevalier en armure étincelante"). |
| `mode alpha` | COMBO | Oui | `"select"`<br>`"fill"`<br>`"custom"` | Comment gérer le mat alpha. "select" utilise une image clé pour sélectionner le sujet, "fill" remplace l'image entière sans mat séparé, "custom" utilise un masque fourni par l'utilisateur. |
| `résolution maximale` | COMBO | Oui | `"1080p"`<br>`"720p"` | La résolution maximale de l'image de sortie. Une résolution plus élevée coûte plus de crédits. |
| `graine` | INT | Oui | - | Une valeur de graine pour la reproductibilité. |
| `image de référence` | IMAGE | Non | - | Une image de référence optionnelle pour guider le style ou l'apparence des nouveaux éléments de la scène. |

**Remarque sur `alpha_mode` :** Lorsque `alpha_mode` est défini sur `"select"`, vous devez également fournir une `alpha_keyframe` (une image clé utilisée pour sélectionner le sujet). Lorsqu'il est défini sur `"custom"`, vous devez fournir un `alpha_mask` (un masque créé par l'utilisateur). Lorsqu'il est défini sur `"fill"`, aucune entrée alpha n'est nécessaire.

## Sorties

| Nom de sortie | Type de données | Description |
|---------------|-----------------|-------------|
| `alpha` | IMAGE | L'image modifiée avec les éléments de la scène changés. |
| `alpha` | MASK | Le mat alpha utilisé par Beeble. Vide pour le mode "fill", qui n'a pas de mat séparé. |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
30 changes: 30 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/ja.md)

このドキュメントはAI生成です。誤りや改善のご提案がございましたら、お気軽にご貢献ください! [GitHubで編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/en.md)

## 概要

Beeble SwitchXを使用して、1枚の画像を編集します。このノードは、元の被写体のピクセルを保持しながら、シーン内の任意の要素(背景、照明、衣装)を切り替えることができます。新しい外観を説明する参照画像やテキストプロンプトを提供します。最大解像度は約2.77メガピクセルです。

## 入力

| パラメータ | データ型 | 必須 | 範囲 | 説明 |
|-----------|-----------|----------|-------|-------------|
| `画像` | IMAGE | はい | - | 編集する元の画像です。 |
| `プロンプト` | STRING | はい | - | 希望する新しい外観のテキストによる説明です(例:「輝く鎧を着た騎士」)。 |
| `アルファモード` | COMBO | はい | `"select"`<br>`"fill"`<br>`"custom"` | アルファマットの処理方法を指定します。"select"はキーフレームを使用して被写体を選択し、"fill"は個別のマットなしで画像全体を置き換え、"custom"はユーザー提供のマスクを使用します。 |
| `最大解像度` | COMBO | はい | `"1080p"`<br>`"720p"` | 出力画像の最大解像度です。解像度が高いほど、消費クレジットが増加します。 |
| `シード` | INT | はい | - | 再現性のためのシード値です。 |
| `参照画像` | IMAGE | いいえ | - | 新しいシーン要素のスタイルや外観をガイドするための、オプションの参照画像です。 |

**`alpha_mode`に関する注意:** `alpha_mode`が`"select"`に設定されている場合、`alpha_keyframe`(被写体を選択するために使用するキーフレーム画像)も提供する必要があります。`"custom"`に設定されている場合、`alpha_mask`(ユーザー作成のマスク)を提供する必要があります。`"fill"`に設定されている場合、アルファ入力は不要です。

## 出力

| 出力名 | データ型 | 説明 |
|-------------|-----------|-------------|
| `アルファ` | IMAGE | シーン要素が切り替えられた編集済み画像です。 |
| `alpha` | MASK | Beebleによって使用されたアルファマットです。"fill"モードの場合は空で、個別のマットはありません。 |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
30 changes: 30 additions & 0 deletions comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/ko.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/ko.md)

# BeebleSwitchXImageEdit

## 개요

Beeble SwitchX를 사용하여 단일 이미지를 편집합니다. 이 노드는 원본 피사체의 픽셀을 보존하면서 장면의 모든 요소(배경, 조명, 의상)를 전환할 수 있습니다. 새로운 모습을 설명하기 위해 참조 이미지 및/또는 텍스트 프롬프트를 제공하세요. 최대 해상도는 약 277만 화소입니다.

## 입력

| 매개변수 | 데이터 타입 | 필수 | 범위 | 설명 |
|-----------|-----------|----------|-------|-------------|
| `image` | IMAGE | 예 | - | 편집할 원본 이미지입니다. |
| `prompt` | STRING | 예 | - | 원하는 새로운 모습에 대한 텍스트 설명입니다 (예: "반짝이는 갑옷을 입은 기사"). |
| `alpha_mode` | COMBO | 예 | `"select"`<br>`"fill"`<br>`"custom"` | 알파 매트를 처리하는 방식입니다. "select"는 키프레임을 사용하여 피사체를 선택하고, "fill"은 별도의 매트 없이 전체 이미지를 대체하며, "custom"은 사용자가 제공한 마스크를 사용합니다. |
| `max_resolution` | COMBO | 예 | `"1080p"`<br>`"720p"` | 출력 이미지의 최대 해상도입니다. 해상도가 높을수록 더 많은 크레딧이 소모됩니다. |
| `seed` | INT | 예 | - | 재현성을 위한 시드 값입니다. |
| `reference_image` | IMAGE | 아니요 | - | 새 장면 요소의 스타일이나 외관을 안내하는 선택적 참조 이미지입니다. |

**`alpha_mode` 참고 사항:** `alpha_mode`가 `"select"`로 설정된 경우 `alpha_keyframe`(피사체 선택에 사용되는 키프레임 이미지)도 함께 제공해야 합니다. `"custom"`으로 설정된 경우 `alpha_mask`(사용자가 생성한 마스크)를 제공해야 합니다. `"fill"`로 설정된 경우 알파 입력이 필요하지 않습니다.

## 출력

| 출력 이름 | 데이터 타입 | 설명 |
|-------------|-----------|-------------|
| `alpha` | IMAGE | 장면 요소가 전환된 편집된 이미지입니다. |
| `alpha` | MASK | Beeble에서 사용하는 알파 매트입니다. "fill" 모드에서는 별도의 매트가 없으므로 비어 있습니다. |

---
**Source fingerprint (SHA-256):** `41f23435686626e3ade28708fcb1da192ded347b210080ee9b17834ea8b727fb`
Loading
Loading