# עיבוד תנוחת גוף תלת-ממדית

מרנדר נתוני תנוחת גוף תלת־ממדיים לתמונה באמצעות סגנון לבחירה. הצומת מקבל נתוני תנוחה ממעקב גוף SAM3D ‏(MHR) או מריג חיצוני בציר Y-up כגון Kimodo, ויכול למזג את התוצאה מעל תמונת רקע אופציונלית (או קנבס שחור כאשר לא מסופקת תמונה). סגנונות הרינדור הזמינים כוללים רשת תלת־ממדית מוצללת, צללית בינארית, שלדים בסגנון OpenPose דו־ממדיים ותלת־ממדיים, וקפסולות גוף בסגנון SCAIL.

## קלטים

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

| פרמטר | תיאור | סוג נתונים | נדרש | טווח |
|-----------|-------------|-----------|----------|-------|
| `render_style` | מצב רינדור. 'mesh' = רשת MHR תלת־ממדית שעוברת רסטריזציה דרך המצלמה. 'silhouette' = מסכה בינארית של הרשת. 'openpose_2d' = שלד דו־ממדי שטוח. 'openpose_3d' = שלד OpenPose כמודל תלת־ממדי עם הצללה שטוחה. 'scail' = קפסולות SCAIL תלת־ממדיות. (ברירת מחדל: "mesh") | DYNAMIC_COMBO | כן | "mesh"<br>"silhouette"<br>"openpose_2d"<br>"openpose_3d"<br>"scail" |
| `pose_data` | נתוני תנוחה של MHR, או נתוני תנוחת ריג חיצוני בציר Y-up ‏(KimodoSample). כל סגנונות הרינדור עובדים עבור ריגים חיצוניים שנושאים מפות מפרקים של OpenPose ב-`_skeleton_override` שלהם (KimodoSample עושה זאת). | MHR_POSE_DATA or KIMODO_POSE_DATA | כן | — |
| `background` | רקע לפי פריים. אם הושמט = קנבס שחור. | IMAGE | לא | — |
| `width` | רוחב הפלט בפיקסלים. 0 = להשתמש ב-image_size המקורי של נתוני התנוחה. אם רק אחד מ-width/height מוגדר, השני נגזר תוך שמירה על יחס הגובה-רוחב המקורי. (ברירת מחדל: 0) | INT | לא | 0 עד 16384, צעד: 8 |
| `height` | גובה הפלט בפיקסלים. 0 = להשתמש ב-image_size המקורי של נתוני התנוחה. אם רק אחד מ-width/height מוגדר, השני נגזר תוך שמירה על יחס הגובה-רוחב המקורי. (ברירת מחדל: 0) | INT | לא | 0 עד 16384, צעד: 8 |
| `camera_info` | דריסת מצלמת 6DOF חופשית. כאשר מחובר, התנוחה מוקרנת מחדש דרך מצלמה זו (position/target/zoom/rotation/FoV) במקום זו שנחזתה. | LOAD_3D_CAMERA | לא | — |

### קלטים של Mesh

פרמטרים אלה מופיעים כאשר `render_style` הוא "mesh".

| פרמטר | תיאור | סוג נתונים | נדרש | טווח |
|-----------|-------------|-----------|----------|-------|
| `shader` | שיידר מוגדר מראש. 'normals' = נורמל פני השטח הנוכחי במרחב המצלמה (מוסכמת normal-map של OpenGL עם Y+: ‏+X→R, ‏+Y→G, ‏+Z→B). 'rainbow' = ג'ט ציר Y של הגוף בסגנון RealisDance; וריאנטים 'rainbow_face_*' מחליפים קודקודי פאות בצבעי נורמל/לפי אזור; 'depth' = אפור ליניארי. (ברירת מחדל: "default") | DYNAMIC_COMBO | לא | "default"<br>"normals"<br>"rainbow"<br>"rainbow_face_normal"<br>"rainbow_face_semantic"<br>"depth" |
| `rainbow_tilt_z` | סיבוב ציר הג'ט של rainbow סביב Z (קדימה). מבדיל בין שמאל/ימין. זמין רק כאשר `shader` הוא "rainbow", "rainbow_face_normal", או "rainbow_face_semantic". (ברירת מחדל: -35.0) | FLOAT | לא | -90.0 עד 90.0, צעד: 0.5 |
| `rainbow_tilt_x` | סיבוב ציר הג'ט של rainbow סביב X (ימינה). מבדיל בין קדמי/אחורי. זמין רק כאשר `shader` הוא "rainbow", "rainbow_face_normal", או "rainbow_face_semantic". (ברירת מחדל: 0.0) | FLOAT | לא | -90.0 עד 90.0, צעד: 0.5 |
| `opacity` | אלפא של הרשת מעל תמונת הרקע, או מעל שחור כאשר לא מחובר רקע. (ברירת מחדל: 1.0) | FLOAT | לא | 0.0 עד 1.0, צעד: 0.01 |
| `person_palette_falloff` | הפחתת רוויה לכל אדם לכיוון לבן: מסלול k מקבל מיזוג פסטלי של (1 - falloff^k) (SCAIL 'softer second person'). 1.0 = כבוי. (ברירת מחדל: 0.6) | FLOAT | לא | 0.1 עד 1.0, צעד: 0.05 |
| `region` | 'hands_only' מסנן פאות באמצעות `hand_vert_mask` המחושב מראש (משקולות LBS כנגד KPs קנוניים של כף היד) — מבודד את רשת כף היד לצורכי ניפוי באגים. אם המסכה חסרה, חוזר לרשת המלאה. (ברירת מחדל: "full_body") | COMBO | לא | "full_body"<br>"hands_only" |

### קלטים של Silhouette

כאשר `render_style` הוא "silhouette", הצומת מרנדר מסכה בינארית של הרשת התלת־ממדית. למצב זה אין פרמטרים נוספים.

### קלטים של OpenPose 2D

פרמטרים אלה מופיעים כאשר `render_style` הוא "openpose_2d".

| פרמטר | תיאור | סוג נתונים | נדרש | טווח |
|-----------|-------------|-----------|----------|-------|
| `marker_radius_px` | רדיוס נקודת מפתח של הגוף (px). (ברירת מחדל: 4) | INT | לא | 1 עד 32, צעד: 1 |
| `stick_width_px` | חצי־רוחב אליפסת גפה של הגוף (px). ברירת מחדל של DWPose = 4. (ברירת מחדל: 4) | INT | לא | 1 עד 32, צעד: 1 |
| `limb_alpha` | אלפא לכל גפה. ברירת מחדל של DWPose = 0.6. (ברירת מחדל: 0.6) | FLOAT | לא | 0.0 עד 1.0, צעד: 0.05 |
| `face_style` | 'full' = כל נקודות הציון של הפנים (sapiens-238 אם קיימות, אחרת rig-fallback ~30). 'eyes_mouth' = תת־קבוצה של rig-fallback (~12 נקודות: עיניים + שפתיים חיצוניות בלבד). 'disabled' = ללא נקודות פנים. (ברירת מחדל: "disabled") | COMBO | לא | "disabled"<br>"full"<br>"eyes_mouth" |
| `hand_style` | ציור 21+21 נקודות מפתח של ידיים + מקלות. 'disabled' = ללא ידיים. 'dwpose' = נקודות כחולות מלאות; 'openpose' = נקודות בצבעי קשת. (ברירת מחדל: "disabled") | COMBO | לא | "disabled"<br>"dwpose"<br>"openpose" |
| `person_palette_falloff` | הפחתת רוויה לכל אדם: מסלול k מתמזג לכיוון לבן לפי 1 - falloff^k. מסלול 0 נשאר חי; 1.0 מבטל את האפקט. (ברירת מחדל: 0.6) | FLOAT | לא | 0.1 עד 1.0, צעד: 0.05 |

### קלטים של OpenPose 3D

פרמטרים אלה מופיעים כאשר `render_style` הוא "openpose_3d".

| פרמטר | תיאור | סוג נתונים | נדרש | טווח |
|-----------|-------------|-----------|----------|-------|
| `radius_m` | רדיוס קפסולת גפה במטרים (דק = דמוי מקל). (ברירת מחדל: 0.015) | FLOAT | לא | 0.004 עד 0.1, צעד: 0.001 |
| `include_hands` | לצייר 21+21 נקודות מפתח של ידיים כקפסולות תלת־ממדיות. (ברירת מחדל: True) | BOOLEAN | לא | True או False |
| `person_palette_falloff` | הפחתת רוויה לכל אדם: מסלול k מתמזג לכיוון לבן לפי 1 - falloff^k. מסלול 0 נשאר חי; 1.0 מבטל את האפקט. (ברירת מחדל: 0.6) | FLOAT | לא | 0.1 עד 1.0, צעד: 0.05 |

### קלטים של SCAIL

פרמטרים אלה מופיעים כאשר `render_style` הוא "scail".

| פרמטר | תיאור | סוג נתונים | נדרש | טווח |
|-----------|-------------|-----------|----------|-------|
| `radius_m` | רדיוס קפסולה במטרים (רפרנס SCAIL: ~0.022 מ'). (ברירת מחדל: 0.022) | FLOAT | לא | 0.005 עד 0.2, צעד: 0.001 |
| `hand_style` | למזג ידי OpenPose דו־ממדיות מעל גוף הקפסולות התלת־ממדי (תואם SCAIL — ללא קפסולות יד תלת־ממדיות). 'disabled' = ללא ידיים. 'dwpose' = נקודות יד כחולות מלאות; 'openpose' = נקודות בצבעי קשת. המקלות נשארים בצבעי קשת לכל אצבע בכל מקרה. (ברירת מחדל: "dwpose") | COMBO | לא | "disabled"<br>"dwpose"<br>"openpose" |
| `face_style` | 'full' = כל נקודות הציון של הפנים (sapiens-238 אם קיימות, אחרת rig-fallback ~30). 'eyes_mouth' = תת־קבוצה של rig-fallback (~12 נקודות: עיניים + שפתיים חיצוניות בלבד). 'disabled' = ללא נקודות פנים. (ברירת מחדל: "disabled") | COMBO | לא | "disabled"<br>"full"<br>"eyes_mouth" |
| `person_palette_falloff` | הפחתת רוויה לכל אדם: מסלול k מתמזג לכיוון לבן לפי 1 - falloff^k. מסלול 0 נשאר חי; 1.0 מבטל את האפקט. (ברירת מחדל: 0.6) | FLOAT | לא | 0.1 עד 1.0, צעד: 0.05 |

### הערות

- אם גם `width` וגם `height` הם 0, הפלט משתמש בגודל התמונה המקורי של נתוני התנוחה. אם רק אחד מהם מוגדר, השני נגזר תוך שמירה על יחס הגובה-רוחב המקורי. רקע `background` מחובר מותאם לגודל רזולוציית הרינדור.
- כאשר `camera_info` מחובר, התנוחה מוקרנת מחדש דרך המצלמה הזו במקום זו שנחזתה.
- במצב mesh, `rainbow_tilt_z` ו-`rainbow_tilt_x` זמינים רק כאשר `shader` מוגדר ל-"rainbow", "rainbow_face_normal", או "rainbow_face_semantic".
- במצב mesh, כאשר `region` הוא "hands_only", מסנן אזור כף היד דורש שנתוני התנוחה יכילו מסכת קודקודים של כף היד; אם המסכה חסרה, הרשת המלאה תרנדר במקום.
- במצב scail, ידיים מצוירות כשכבת-על OpenPose דו־ממדית מעל גוף הקפסולות התלת־ממדי ולא כקפסולות תלת־ממדיות; הגדרת `hand_style` ל-"disabled" מסירה אותן לחלוטין.
- כאשר רזולוציית הפלט שונה מהרזולוציה המקורית של נתוני התנוחה, גדלי הסמנים והמקלות של openpose_2d מותאמים בפרופורציה.
- אם לרקע יש פחות פריימים מנתוני התנוחה, הפריים האחרון של הרקע נעשה בו שימוש חוזר עבור הפריימים הנותרים.
- הפלט מכיל פריים אחד לכל פריים תנוחה בקלט. אם נתוני התנוחה אינם מכילים פריימים, מוחזרת תמונה שחורה בודדת.

## פלטים

| שם פלט | תיאור | סוג נתונים |
|-------------|-------------|-----------|
| `image` | הפריימים המרונדרים: נתוני התנוחה מצוירים בסגנון הרינדור הנבחר, ממוזגים מעל הרקע כאשר הוא מחובר, או מעל שחור אחרת. פריים אחד לכל פריים תנוחה בקלט, מוחזרים כתמונה אחת באצווה. | IMAGE |

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

---
**Source fingerprint (SHA-256):** `96556283cf07727e6b4bb3549537bf925ed771bab8607f65c93ab54a5f0e9ba5`
