docs: weekly node update — 17 new nodes (Wan3/Pixverse V6/SAM3D Body/Recraft V4) + 24 changed node en.md refresh

comfyui_embedded_docs/docs/BuildPoseFile/ar.md

@@ -0,0 +1,103 @@
+# إنشاء ملف رسوم متحركة ثلاثي الأبعاد
+
+تبني هذه العقدة ملف رسوم متحركة ثلاثي الأبعاد جاهزًا للحفظ من بيانات الوضعية. يمكنك تصدير ملف 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`