# יצירת קובץ הנפשת תלת־ממד

צומת זה בונה קובץ אנימציה תלת-ממדית מוכן לשמירה מנתוני תנוחה. ניתן לייצא GLB מונפש בכמה סגנונות חזותיים — רשת גוף מלאה, תצוגה מקדימה של מפרקים בלבד, שלד OpenPose או ריג קפסולות SCAIL — או לשמור במקום זאת קליפ לכידת תנועה BVH. הפלט מתחבר לצומת שמירת קבצים כגון Save 3D Model כדי לכתוב את הקובץ לדיסק.

## קלטים

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

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `pose_data` | נתוני תנוחה תלת-ממדיים. מקבל נתוני תנוחה של MHR (פרמטרי מודל/צורה/הבעה, נקודות מפתח MHR70, צבעים קנוניים, מסכת קודקודים לידיים) או נתוני תנוחה של Kimodo (ריג חיצוני בציר Y-up עם קודקודים חזויים לכל פריים ומצלמה). | MHR_POSE_DATA / KIMODO_POSE_DATA | כן | — |
| `format` | פורמט פלט, ששניהם מוזנים ל-Save 3D Model כדי לכתוב לדיסק. 'glb' = GLB מונפש (mesh / bones / openpose / scail). 'bvh' = קליפ לכידת תנועה BVH (שלד אחד; דורש את המודל). (ברירת מחדל: glb) | DYNAMIC_COMBO | כן | "glb"<br>"bvh" |
| `sam3d_body_model` | מודל גוף SAM3D אופציונלי. נדרש עבור הפורמטים 'bvh', 'body_mesh' ו-'bones_only', אלא אם נתוני התנוחה נושאים עקיפת שלד. | SAM3D_BODY_MODEL | לא | — |
| `fps` | קצב פריימים של האנימציה. (ברירת מחדל: 24.0) | FLOAT | כן | 1.0-240.0 |
| `camera_translation` | הטמעת pred_cam_t בתרגום של השורש: 'off' = מיקום קשירה; 'centered' = דלתא מפריים 0; 'absolute' = גולמי (Z הוא עומק המצלמה — בדרך כלל מרחק של מטרים). (ברירת מחדל: off) | COMBO | כן | "off"<br>"centered"<br>"absolute" |
| `track_index` | בחירת רצועה: -1 = כל הרצועות; ≥0 = רצועה בודדת. (ברירת מחדל: -1) | INT | כן | -1 עד 15 |

### קלטים של GLB

קלטים אלה מופיעים כאשר `format` מוגדר ל-"glb".

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `mesh_style` | סגנון חזותי של ה-GLB: 'body_mesh' = Armature אמיתי (127 עצמות, skinning, keyframes מסוג TRS, 72 מורפים לפנים; דורש מודל). 'bones_only' = פרימיטיבים בצורת עצם בכל מפרק (Armature לתצוגה מקדימה). 'openpose' = שלד תלת-ממדי OpenPose-18 מנקודות מפתח. 'scail' = ריג קפסולות תלת-ממדי SCAIL (גלילים פתוחים שנאטמים בצורה צמודה על ידי ספרות מפרק). (ברירת מחדל: body_mesh) | DYNAMIC_COMBO | כן | "body_mesh"<br>"bones_only"<br>"openpose"<br>"scail" |
| `bone_smooth_window` | חלון החלקה גאוסי על keyframes של סיבוב לכל עצם / רצועות נקודות מפתח. 0 = כבוי. 7-15 מרגיע סיבובים/רעד כאשר Smooth במעלה הזרם מפספס קפיצות. (ברירת מחדל: 0) | INT | כן | 0-51, צעד 2 |

#### קלטים של Body Mesh

מופיעים כאשר `mesh_style` הוא "body_mesh".

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `bone_vis` | צורת תצוגת עצמות, עם סקינינג קשיח לכל מפרק. 'off' = ללא תצוגת עצמות; 'octahedrons' = עצמות כיווניות בסגנון Blender. (ברירת מחדל: off) | DYNAMIC_COMBO | כן | "off"<br>"octahedrons" |
| `bone_vis_radius_m` | מופיע כאשר `bone_vis` = "octahedrons". רדיוס במטרים (רדיוס ספרה / חצי רוחב אוקטהדרון). (ברירת מחדל: 0.02) | FLOAT | כן | 0.005-0.5 |
| `bone_vis_color` | מופיע כאשר `bone_vis` = "octahedrons". צבעי קודקודים לכל עצם (חומר unlit). 'white' = ללא, 'rainbow_y' = מפל צבעים מהראש ועד כפות הרגליים. (ברירת מחדל: rainbow_y) | COMBO | כן | "white"<br>"rainbow_y" |
| `shader` | הטמעת צבעי קודקודים התואמים לשיידרים של צומת Render (COLOR_0 + KHR_materials_unlit). 'default' = ללא צבעים. (ברירת מחדל: default) | DYNAMIC_COMBO | כן | "default"<br>"rainbow"<br>"rainbow_face_normal"<br>"rainbow_face_semantic" |
| `rainbow_tilt_z` | מופיע כאשר `shader` הוא וריאנט rainbow. סיבוב ציר מפל הצבעים סביב Z (קדימה). מבדיל בין שמאל/ימין. (ברירת מחדל: -35.0) | FLOAT | כן | -90.0 עד 90.0 |
| `rainbow_tilt_x` | מופיע כאשר `shader` הוא וריאנט rainbow. סיבוב ציר מפל הצבעים סביב X (ימינה). מבדיל בין חזית/גב. (ברירת מחדל: 0.0) | FLOAT | כן | -90.0 עד 90.0 |
| `person_palette_falloff` | מופיע כאשר `shader` הוא וריאנט rainbow. הפחתת רוויה לכל אדם: כל רצועה מקבלת תערובת פסטל של (1 - falloff^k). (ברירת מחדל: 0.6) | FLOAT | כן | 0.1-1.0 |

#### קלטים של Bones Only

מופיעים כאשר `mesh_style` הוא "bones_only".

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `bone_vis` | צורת תצוגת עצמות, עם סקינינג קשיח לכל מפרק. 'octahedrons' = עצמות כיווניות בסגנון Blender (מפרק → צאצא ראשי). | DYNAMIC_COMBO | כן | "octahedrons" |
| `bone_vis_radius_m` | רדיוס במטרים (רדיוס ספרה / חצי רוחב אוקטהדרון). (ברירת מחדל: 0.02) | FLOAT | כן | 0.005-0.5 |
| `bone_vis_color` | צבעי קודקודים לכל עצם (חומר unlit). 'white' = ללא, 'rainbow_y' = מפל צבעים מהראש ועד כפות הרגליים. (ברירת מחדל: rainbow_y) | COMBO | כן | "white"<br>"rainbow_y" |

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

מופיעים כאשר `mesh_style` הוא "openpose".

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `marker_radius_m` | רדיוס ספרה במטרים. (ברירת מחדל: 0.010) | FLOAT | כן | 0.005-0.1 |
| `stick_radius_m` | חצי רוחב גפה במטרים. מוגבל אוטומטית ל-bone_length x 0.1. (ברירת מחדל: 0.008) | FLOAT | כן | 0.002-0.05 |
| `include_hands` | מוסיף 21+21 ידי OpenPose (פרק כף יד + 5 אצבעות x 4 מפרקים, בסיס→קצה) שמקורן ב-pred_keypoints_3d. (ברירת מחדל: False) | BOOLEAN | כן | True / False |
| `hand_marker_radius_m` | רדיוס ספרה של יד במטרים. (ברירת מחדל: 0.005) | FLOAT | כן | 0.001-0.1 |
| `hand_stick_radius_m` | חצי רוחב איבר היד במטרים. (ברירת מחדל: 0.003) | FLOAT | כן | 0.001-0.05 |
| `face_style` | ציוני דרך של קו מתאר הפנים שנדגמים מ-pred_vertices במזהי קודקודים קבועים של רשת הראש (דורש canonical_colors ב-pose_data). 'full' = כל ~30 הנקודות; 'eyes_mouth' = עיניים + שפתיים חיצוניות בלבד. (ברירת מחדל: disabled) | COMBO | כן | "disabled"<br>"full"<br>"eyes_mouth" |
| `face_marker_radius_m` | רדיוס נקודת פנים. 0 = אוטומטי = 0.3 x marker_radius_m. (ברירת מחדל: 0.0) | FLOAT | כן | 0.0-0.05 |

#### קלטים של SCAIL

מופיעים כאשר `mesh_style` הוא "scail".

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `stick_radius_m` | רדיוס גליל במטרים. העצמות הן גלילים פתוחים ברדיוס קבוע; ספרות מפרק (בגודל אוטומטי להתאמה) אוטמות את הקצוות הפתוחים. ייחוס SCAIL = 0.0215 m. (ברירת מחדל: 0.022) | FLOAT | כן | 0.002-0.1 |
| `marker_radius_m` | רדיוס ספרת מפרק. 0 = אוטומטי = stick_radius_m (אטימה צמודה). (ברירת מחדל: 0.0) | FLOAT | כן | 0.0-0.1 |
| `material_roughness` | חספוס PBR. ייחוס SCAIL = 0.3. 1 = מט; 0 = כרום. (ברירת מחדל: 0.3) | FLOAT | כן | 0.0-1.0 |
| `include_hands` | מוסיף 21+21 נקודות מפתח של ידיים + מקלות קפסולה לכל רצועה. (ברירת מחדל: False) | BOOLEAN | כן | True / False |
| `hand_marker_radius_m` | רדיוס ספרה של יד במטרים. (ברירת מחדל: 0.005) | FLOAT | כן | 0.001-0.05 |
| `hand_stick_radius_m` | רדיוס גליל יד במטרים. (ברירת מחדל: 0.003) | FLOAT | כן | 0.001-0.05 |
| `face_style` | ציוני דרך של קו מתאר הפנים שנדגמים מ-pred_vertices (דורש canonical_colors ב-pose_data). 'full' = כל ~30 הנקודות; 'eyes_mouth' = עיניים + שפתיים חיצוניות בלבד. (ברירת מחדל: disabled) | COMBO | כן | "disabled"<br>"full"<br>"eyes_mouth" |

### קלטים של BVH

מופיעים כאשר `format` מוגדר ל-"bvh".

| פרמטר | תיאור | סוג נתונים | חובה | טווח |
|-----------|-------------|-----------|----------|-------|
| `units` | יחידות OFFSET/מיקום של BVH. 'cm' הוא התקן ללכידת תנועה. (ברירת מחדל: cm) | COMBO | כן | "cm"<br>"m" |

**הערות:**

- הפורמט `bvh` וסגנונות הרשת `body_mesh` ו-`bones_only` דורשים את הקלט `sam3d_body_model`, אלא אם ה-`pose_data` עצמו נושא עקיפת שלד (dict בשם `_skeleton_override`, למשל מצומת KimodoSample). הצומת מעלה שגיאה אם אף אחד מהם אינו זמין. הסגנונות `openpose` ו-`scail` אינם תלויים בריג ועובדים ישירות מנקודות מפתח ללא מודל הגוף.
- בפורמט `bvh`, הפלט מכיל שלד בודד. כאשר `track_index` הוא -1 (כל הרצועות), נעשה שימוש ברצועה הראשונה.
- האפשרויות `full` ו-`eyes_mouth` של `face_style` דורשות `canonical_colors` בנתוני התנוחה, שקיימים כאשר נתוני התנוחה מגיעים מצינור MHR יחד עם מודל הגוף.
- `bone_smooth_window` מתקדם בצעדים של 2 בין 0 ל-51.

## פלטים

| שם פלט | תיאור | סוג נתונים |
|-------------|-------------|-----------|
| `model_3d` | קובץ האנימציה שנוצר: GLB מונפש או קליפ לכידת תנועה BVH, מוכן לשמירה לדיסק עם צומת כגון Save 3D Model. | 3D_FILE |

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

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