# Topaz שיפור תמונה

Topaz Image Enhance מחיל הגדלה ושיפור תמונה בסטנדרט תעשייתי על תמונת קלט בודדת באמצעות מודלים של Topaz. הוא שולח את התמונה ל-API של Topaz, מעבד אותה עם המודל הנבחר ומחזיר את התוצאה המשופרת. ניתן לבחור מבין ארבעה מודלים: Reimagine, Bloom 2, Wonder 3.5 ו-Wonder 4.

## קלטים

### קלטים משותפים

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `image` | תמונת הקלט לשיפור. נתמכת תמונת קלט אחת בלבד. | IMAGE | כן | תמונה בודדת |
| `model` | מודל השיפור של Topaz לשימוש. המודל הנבחר קובע אילו הגדרות ספציפיות למודל יופיעו. | DYNAMIC_COMBO | כן | `"Reimagine"`<br>`"Bloom 2"`<br>`"Wonder 3.5"`<br>`"Wonder 4"` |
| `output_width` | ערך אפס פירושו חישוב אוטומטי (בדרך כלל זה יהיה הגודל המקורי או מותאם בפרופורציה ל-`output_height` אם צוין). Wonder 3.5 ו-Wonder 4 תומכים בגורמי הגדלה מ-1x עד 6x, ו-Bloom 2 מ-1x עד 12x. Bloom 2, Wonder 3.5 ו-Wonder 4 תמיד שומרים על יחס הרוחב-גובה של הקלט: אם שני הגדלים מוגדרים והיחס שלהם שונה, ההגדלה הגדולה יותר גוברת, כך שהפלט גדול מהגודל המבוקש והמחיר גבוה מהמחיר של הגודל המבוקש. (ברירת מחדל: 0) | INT | לא | 0 עד 32000 |
| `output_height` | ערך אפס פירושו לפלוט באותו גובה כמו המקור או מותאם בפרופורציה ל-`output_width` אם צוין. Wonder 3.5 ו-Wonder 4 תומכים בגורמי הגדלה מ-1x עד 6x, ו-Bloom 2 מ-1x עד 12x. Bloom 2, Wonder 3.5 ו-Wonder 4 תמיד שומרים על יחס הרוחב-גובה של הקלט: אם שני הגדלים מוגדרים והיחס שלהם שונה, ההגדלה הגדולה יותר גוברת, כך שהפלט גדול מהגודל המבוקש והמחיר גבוה מהמחיר של הגודל המבוקש. (ברירת מחדל: 0) | INT | לא | 0 עד 32000 |

### קלטים של Reimagine

הגדרות אלו חלות כאשר `model` מוגדר ל-`"Reimagine"`.

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `prompt` | הנחיית טקסט אופציונלית להכוונת הגדלה יצירתית. (ברירת מחדל: "") | STRING | כן | כל טקסט |
| `creativity` | רמת יצירתיות לשיפור. (ברירת מחדל: 3) | INT | כן | 1 עד 9 |
| `subject_detection` | מצב זיהוי נושא (מתקדם). | COMBO | כן | `"All"`<br>`"Foreground"`<br>`"Background"` |
| `face_enhancement` | שפר פנים (אם קיימות) במהלך העיבוד. (ברירת מחדל: True) | BOOLEAN | כן | true<br>false |
| `face_enhancement_creativity` | הגדר את רמת היצירתיות לשיפור הפנים. (ברירת מחדל: 0.0) | FLOAT | כן | 0.0 עד 1.0 |
| `face_enhancement_strength` | שולט עד כמה הפנים המשופרות חדות ביחס לרקע. (ברירת מחדל: 1.0) | FLOAT | כן | 0.0 עד 1.0 |
| `face_preservation` | שמור על זהות הפנים של המצולמים. (ברירת מחדל: True) | BOOLEAN | כן | true<br>false |
| `color_preservation` | שמור על הצבעים המקוריים. (ברירת מחדל: True) | BOOLEAN | כן | true<br>false |
| `crop_to_fill` | כברירת מחדל, התמונה מוצגת עם שוליים (letterboxed) כאשר יחס הרוחב-גובה של הפלט שונה. הפעל כדי לחתוך את התמונה כך שתמלא את ממדי הפלט. (ברירת מחדל: False) | BOOLEAN | כן | true<br>false |

### קלטים של Bloom 2

הגדרות אלו חלות כאשר `model` מוגדר ל-`"Bloom 2"`.

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `prompt` | הנחיית טקסט אופציונלית ליצירה. השאר ריק כדי ליצור אוטומטית הנחיה מתמונת הקלט. (ברירת מחדל: "") | STRING | כן | כל טקסט |
| `creativity` | 1 הוא שיפור מרוסן, 9 הוא פרשנות מחודשת מובהקת עם פרטים חדשים שנוצרו. (ברירת מחדל: 3) | INT | כן | 1 עד 9 |
| `seed` | Seed ליצירה ניתנת לשחזור. (ברירת מחדל: 2) | INT | כן | 1 עד 2000 |
| `color_preservation` | שמור על הצבעים המקוריים. (ברירת מחדל: True) | BOOLEAN | כן | true<br>false |
| `grain` | הוסף גריין לתמונת הפלט. (ברירת מחדל: False) | BOOLEAN | כן | true<br>false |
| `grain_model` | מודל גריין לשימוש. מתעלמים ממנו אם הגריין מושבת. | COMBO | כן | `"silver"`<br>`"gaussian"`<br>`"grey"` |
| `grain_strength` | חוזק אפקט הגריין. מתעלמים ממנו אם הגריין מושבת. (ברירת מחדל: 0.5) | FLOAT | כן | 0.0 עד 1.0 |
| `grain_size` | גודל חלקיקי הגריין. מתעלמים ממנו אם הגריין מושבת. (ברירת מחדל: 1.0) | FLOAT | כן | 1.0 עד 5.0 |
| `grain_density` | עוצמת אפקט הגריין. מתעלמים ממנו אם הגריין מושבת. (ברירת מחדל: 0.5) | FLOAT | כן | 0.0 עד 1.0 |

### קלטים של Wonder 3.5

הגדרות אלו חלות כאשר `model` מוגדר ל-`"Wonder 3.5"`.

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `enhancement_strength` | רמת שיפור עבור תנאי קלט משתנים. (ברירת מחדל: "high") | COMBO | כן | `"low"`<br>`"medium"`<br>`"high"` |
| `grain` | הוסף גריין לתמונת הפלט. (ברירת מחדל: False) | BOOLEAN | כן | true<br>false |
| `grain_model` | מודל גריין לשימוש. מתעלמים ממנו אם הגריין מושבת. | COMBO | כן | `"silver"`<br>`"gaussian"`<br>`"grey"` |
| `grain_strength` | חוזק אפקט הגריין. מתעלמים ממנו אם הגריין מושבת. (ברירת מחדל: 0.5) | FLOAT | כן | 0.0 עד 1.0 |
| `grain_size` | גודל חלקיקי הגריין. מתעלמים ממנו אם הגריין מושבת. (ברירת מחדל: 1.0) | FLOAT | כן | 1.0 עד 5.0 |
| `grain_density` | עוצמת אפקט הגריין. מתעלמים ממנו אם הגריין מושבת. (ברירת מחדל: 0.5) | FLOAT | כן | 0.0 עד 1.0 |

**הערה:** נתמכת תמונת קלט אחת בלבד; הצומת מעלה שגיאה אם אצוות הקלט מכילה יותר מתמונה אחת. מתעלמים מהגדרות גריין (`grain_model`, `grain_strength`, `grain_size`, `grain_density`) אלא אם `grain` מופעל. עבור Bloom 2, השארת `prompt` ריק יוצרת אוטומטית הנחיה מתמונת הקלט. Wonder 4 חושף רק את הקלטים המשותפים. הפלט מוגבל ל-179 מגה-פיקסל ול-32000 פיקסלים בכל צד.

## פלטים

| שם פלט | תיאור | סוג נתונים |
|-------------|-------------|-----------|
| `IMAGE` | התמונה המשופרת והמוגדלת המוחזרת מ-API של Topaz. | IMAGE |

> מסמך זה נוצר על ידי בינה מלאכותית. אם מצאתם שגיאות או שיש לכם הצעות לשיפור, אתם מוזמנים לתרום! [עריכה ב-GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TopazImageEnhanceV2/he.md)

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