# تصيير وضعية الجسم ثلاثية الأبعاد

يُرسم بيانات وضعية الجسم ثلاثية الأبعاد إلى صورة باستخدام نمط قابل للاختيار. تقبل العقدة بيانات الوضعية من متتبّع جسم SAM3D (MHR) أو من هيكل خارجي باتجاه Y مثل 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 (KimodoSample). تعمل جميع أنماط العرض مع الهياكل الخارجية التي تحمل خرائط مفاصل OpenPose في `_skeleton_override` الخاصة بها (يفعل KimodoSample ذلك). | MHR_POSE_DATA أو KIMODO_POSE_DATA | نعم | — |
| `background` | خلفية لكل إطار. عند حذفها = لوحة سوداء. | IMAGE | لا | — |
| `width` | عرض المخرجات بالبكسل. 0 = استخدام image_size الأصلي لبيانات الوضعية. إذا تم تعيين واحد فقط من العرض/الارتفاع، يُشتق الآخر مع الحفاظ على النسبة الأصلية. (افتراضي: 0) | INT | لا | 0 إلى 16384, step 8 |
| `height` | ارتفاع المخرجات بالبكسل. 0 = استخدام image_size الأصلي لبيانات الوضعية. إذا تم تعيين واحد فقط من العرض/الارتفاع، يُشتق الآخر مع الحفاظ على النسبة الأصلية. (افتراضي: 0) | INT | لا | 0 إلى 16384, step 8 |
| `camera_info` | تجاوز كاميرا حرة 6DOF. عند توصيله، تُعاد إسقاط الوضعية عبر هذه الكاميرا (الموضع/الهدف/التكبير/الدوران/مجال الرؤية) بدلًا من الكاميرا المتوقعة. | LOAD_3D_CAMERA | لا | — |

### مدخلات Mesh

تظهر هذه المعاملات عندما يكون `render_style` هو "mesh".

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `shader` | تظليل مُعد مسبقًا. 'normals' = الطبيعي السطحي الحالي في فضاء الكاميرا (اصطلاح خريطة الطبيعي 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` | تدوير محور تدفق قوس قزح حول Z (للأمام). يميز اليسار/اليمين. متاح فقط عندما يكون `shader` هو "rainbow" أو "rainbow_face_normal" أو "rainbow_face_semantic". (افتراضي: -35.0) | FLOAT | لا | -90.0 إلى 90.0, step 0.5 |
| `rainbow_tilt_x` | تدوير محور تدفق قوس قزح حول X (لليمين). يميز الأمام/الخلف. متاح فقط عندما يكون `shader` هو "rainbow" أو "rainbow_face_normal" أو "rainbow_face_semantic". (افتراضي: 0.0) | FLOAT | لا | -90.0 إلى 90.0, step 0.5 |
| `opacity` | شفافية الشبكة فوق صورة الخلفية، أو فوق الأسود عند عدم توصيل أي منها. (افتراضي: 1.0) | FLOAT | لا | 0.0 إلى 1.0, step 0.01 |
| `person_palette_falloff` | إزالة تشبع لكل شخص نحو الأبيض: يحصل المسار k على مزيج باستيل بمقدار (1 - falloff^k) (SCAIL 'softer second person'). 1.0 = إيقاف. (افتراضي: 0.6) | FLOAT | لا | 0.1 إلى 1.0, step 0.05 |
| `region` | 'hands_only' يرشح الوجوه عبر `hand_vert_mask` المحسوب مسبقًا (أوزان LBS مقابل نقاط مفاصل اليد الأساسية) — يعزل شبكة اليد لأغراض التصحيح. يعود إلى الشبكة الكاملة إذا كان القناع مفقودًا. (افتراضي: "full_body") | COMBO | لا | "full_body"<br>"hands_only" |

### مدخلات Silhouette

عندما يكون `render_style` هو "silhouette"، ترسم العقدة قناعًا ثنائيًا للشبكة ثلاثية الأبعاد. لا يحتوي هذا النمط على معاملات إضافية.

### مدخلات OpenPose 2D

تظهر هذه المعاملات عندما يكون `render_style` هو "openpose_2d".

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `marker_radius_px` | نصف قطر نقطة مفصل الجسم (بكسل). (افتراضي: 4) | INT | لا | 1 إلى 32, step 1 |
| `stick_width_px` | نصف عرض القطع الناقص لطرف الجسم (بكسل). القيمة الافتراضية في DWPose = 4. (افتراضي: 4) | INT | لا | 1 إلى 32, step 1 |
| `limb_alpha` | شفافية كل طرف. القيمة الافتراضية في DWPose = 0.6. (افتراضي: 0.6) | FLOAT | لا | 0.0 إلى 1.0, step 0.05 |
| `face_style` | 'full' = جميع معالم الوجه (sapiens-238 إن وُجد، وإلا الاحتياطي للهيكل ~30). 'eyes_mouth' = مجموعة فرعية من الاحتياطي للهيكل (~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, step 0.05 |

### مدخلات OpenPose 3D

تظهر هذه المعاملات عندما يكون `render_style` هو "openpose_3d".

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `radius_m` | نصف قطر كبسولة الطرف بالأمتار (رقيق = يشبه العصا). (افتراضي: 0.015) | FLOAT | لا | 0.004 إلى 0.1, step 0.001 |
| `include_hands` | رسم 21+21 نقطة مفصل لليد ككبسولات ثلاثية الأبعاد. (افتراضي: True) | BOOLEAN | لا | True or False |
| `person_palette_falloff` | إزالة تشبع لكل شخص: المسار k يمزج نحو الأبيض بمقدار 1 - falloff^k. يبقى المسار 0 زاهيًا؛ 1.0 يعطّل التلاشي. (افتراضي: 0.6) | FLOAT | لا | 0.1 إلى 1.0, step 0.05 |

### مدخلات SCAIL

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

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `radius_m` | نصف قطر الكبسولة بالأمتار (مرجع SCAIL: ~0.022 م). (افتراضي: 0.022) | FLOAT | لا | 0.005 إلى 0.2, step 0.001 |
| `hand_style` | تركيب أيدي OpenPose ثنائية الأبعاد فوق جسم الكبسولة ثلاثي الأبعاد (يطابق SCAIL — بدون كبسولات يد ثلاثية الأبعاد). 'disabled' = بدون أيدٍ. 'dwpose' = نقاط يد زرقاء صلبة؛ 'openpose' = نقاط قوس قزح. تبقى العصي بألوان قوس قزح لكل إصبع في كلتا الحالتين. (افتراضي: "dwpose") | COMBO | لا | "disabled"<br>"dwpose"<br>"openpose" |
| `face_style` | 'full' = جميع معالم الوجه (sapiens-238 إن وُجد، وإلا الاحتياطي للهيكل ~30). 'eyes_mouth' = مجموعة فرعية من الاحتياطي للهيكل (~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, step 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/ar.md)

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