# إنشاء ملف رسوم متحركة ثلاثي الأبعاد

تبني هذه العقدة ملف رسوم متحركة ثلاثي الأبعاد جاهزًا للحفظ من بيانات الوضعية. يمكنك تصدير ملف GLB متحرك بعدة أنماط بصرية — شبكة كاملة للجسم، أو معاينة العظام فقط، أو هيكل OpenPose، أو هيكل كبسولات SCAIL — أو حفظ مقطع التقاط حركة BVH بدلاً من ذلك. يُوصَّل المخرج بعقدة حفظ ملفات مثل Save 3D Model لكتابة الملف على القرص.

## المدخلات

### المدخلات العامة

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `pose_data` | بيانات الوضعية ثلاثية الأبعاد. تقبل بيانات وضعية MHR (معاملات النموذج/الشكل/التعبير، النقاط المفتاحية MHR70، الألوان الأساسية، قناع رؤوس اليد) أو بيانات وضعية Kimodo (هيكل خارجي بمحور Y للأعلى مع رؤوس متوقعة لكل إطار وكاميرا). | MHR_POSE_DATA / KIMODO_POSE_DATA | نعم | — |
| `format` | تنسيق المخرج، ويُمرَّر إلى Save 3D Model لكتابته على القرص. 'glb' = GLB متحرك (شبكة / عظام / 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' = هيكل عظمي حقيقي (127 عظمة، تثبيت الشبكة بالعظام، مفاتيح TRS، 72 مورف وجه؛ يتطلب النموذج). 'bones_only' = بدائيات بأشكال عظمية عند كل مفصل (هيكل للمعاينة). 'openpose' = هيكل OpenPose-18 ثلاثي الأبعاد من النقاط المفتاحية. 'scail' = هيكل كبسولات SCAIL ثلاثي الأبعاد (أسطوانات مفتوحة تُسدّ نهاياتها بكرات المفاصل). (الافتراضي: body_mesh) | DYNAMIC_COMBO | نعم | "body_mesh"<br>"bones_only"<br>"openpose"<br>"scail" |
| `bone_smooth_window` | نافذة تنعيم غاوسية على مفاتيح دوران كل عظمة / مسارات النقاط المفتاحية. 0 = معطلة. 7-15 تهدئ الدورات والارتعاش عندما يفوت التنعيم المسبق القمم الحادة. (الافتراضي: 0) | INT | نعم | 0-51, step 2 |

#### مدخلات شبكة الجسم

تظهر عندما يكون `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". ألوان رؤوس لكل عظمة (مادة غير مضاءة). '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` أحد متغيرات قوس قزح. يُدير محور تدرج قوس قزح حول Z (الأمام). يفرّق بين اليسار واليمين. (الافتراضي: -35.0) | FLOAT | نعم | -90.0 إلى 90.0 |
| `rainbow_tilt_x` | يظهر عندما يكون `shader` أحد متغيرات قوس قزح. يُدير محور تدرج قوس قزح حول X (اليمين). يفرّق بين الأمام والخلف. (الافتراضي: 0.0) | FLOAT | نعم | -90.0 إلى 90.0 |
| `person_palette_falloff` | يظهر عندما يكون `shader` أحد متغيرات قوس قزح. إضعاف تشبع اللون لكل شخص: يحصل كل مسار على مزيج باستيل بنسبة (1 - falloff^k). (الافتراضي: 0.6) | FLOAT | نعم | 0.1-1.0 |

#### مدخلات العظام فقط

تظهر عندما يكون `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` | ألوان رؤوس لكل عظمة (مادة غير مضاءة). '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` | نصف عرض الطرف بالمتر. يُقيَّد تلقائيًا إلى 0.1 × طول العظمة. (الافتراضي: 0.008) | FLOAT | نعم | 0.002-0.05 |
| `include_hands` | إلحاق 21+21 يد OpenPose (رسغ + 5 أصابع × 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 × marker_radius_m. (الافتراضي: 0.0) | FLOAT | نعم | 0.0-0.05 |

#### مدخلات SCAIL

تظهر عندما يكون `mesh_style` هو "scail".

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `stick_radius_m` | نصف قطر الأسطوانة بالمتر. العظام أسطوانات مفتوحة بنصف قطر ثابت؛ كرات المفاصل (بحجم تلقائي مطابق) تسدّ النهايات المفتوحة. القيمة المرجعية SCAIL = 0.0215 م. (الافتراضي: 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`، ما لم تكن بيانات الوضعية نفسها تحمل تجاوز هيكل (قاموس `_skeleton_override`، مثلاً من عقدة KimodoSample). ترفع العقدة خطأً إذا لم يتوفر أي منهما. نمطا `openpose` و`scail` مستقلان عن الهيكل ويعملان مباشرة من النقاط المفتاحية دون الحاجة إلى نموذج الجسم.
- في صيغة `bvh`، يحتوي المخرج على هيكل واحد. عندما تكون `track_index` = -1 (كل المسارات)، يُستخدم المسار الأول.
- خيارا `face_style` بقيمتي `full` و`eyes_mouth` يتطلبان `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/ar.md)

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