# عقدة تحويل الصورة إلى نموذج ثلاثي الأبعاد من Tencent

تقوم هذه العقدة باستخدام واجهة برمجة تطبيقات Hunyuan3D Pro من Tencent لإنشاء نموذج ثلاثي الأبعاد من صورة واحدة أو أكثر من الصور المدخلة. تقوم بمعالجة الصور، وإرسالها إلى واجهة البرمجة، وإرجاع ملفات النموذج ثلاثي الأبعاد المُنشأة بتنسيقي GLB وOBJ، بالإضافة إلى خرائط النسيج الاختيارية.

## المدخلات

| المعامل | الوصف | نوع البيانات | إلزامي | النطاق |
| --- | --- | --- | --- | --- |
| `النموذج` | إصدار نموذج Hunyuan3D المراد استخدامه. خيار المضلعات المنخفضة غير متاح لإصدار `3.1`. | COMBO | نعم | `"3.0"`<br>`"3.1"` |
| `الصورة` | الصورة المدخلة الأساسية المستخدمة لإنشاء النموذج ثلاثي الأبعاد. يجب أن لا يقل حجمها عن 128×128 بكسل. | IMAGE | نعم | - |
| `الصورة اليسرى` | صورة اختيارية للجانب الأيسر من الجسم لإنشاء عرض متعدد الزوايا. يجب أن لا يقل حجمها عن 128×128 بكسل. | IMAGE | لا | - |
| `الصورة اليمنى` | صورة اختيارية للجانب الأيمن من الجسم لإنشاء عرض متعدد الزوايا. يجب أن لا يقل حجمها عن 128×128 بكسل. | IMAGE | لا | - |
| `الصورة الخلفية` | صورة اختيارية للجانب الخلفي من الجسم لإنشاء عرض متعدد الزوايا. يجب أن لا يقل حجمها عن 128×128 بكسل. | IMAGE | لا | - |
| `عدد الأوجه` | العدد المستهدف من الأسطح للنموذج ثلاثي الأبعاد المُنشأ (الافتراضي: 500000). | INT | نعم | 3000 - 1500000 |
| `نوع التوليد` | نوع النموذج ثلاثي الأبعاد المراد إنشاؤه. يؤدي اختيار خيار إلى إظهار معاملات إضافية ذات صلة. | DYNAMICCOMBO | نعم | `"Normal"`<br>`"LowPoly"`<br>`"Geometry"` |
| `generate_type.pbr` | يُفعّل إنشاء مواد العرض الفيزيائي الواقعي (PBR). هذا المعامل يظهر فقط عندما تكون قيمة `نوع التوليد` مضبوطة على "Normal" أو "LowPoly" (الافتراضي: False). | BOOLEAN | لا | - |
| `generate_type.polygon_type` | نوع المضلع المستخدم للشبكة. هذا المعامل يظهر فقط عندما تكون قيمة `نوع التوليد` مضبوطة على "LowPoly". | COMBO | لا | `"triangle"`<br>`"quadrilateral"` |
| `البذرة` | قيمة بذرة لعملية الإنشاء. تتحكم البذرة في ما إذا كانت العقدة ستعيد التشغيل؛ النتائج غير حتمية بغض النظر عن البذرة (الافتراضي: 0). | INT | نعم | 0 - 2147483647 |

**ملاحظة:** يجب أن لا يقل الحد الأدنى للعرض والارتفاع لجميع الصور المدخلة عن 128 بكسل. يتم تقليل حجم الصور تلقائياً إذا تجاوز طول أطول جانب فيها 4900 بكسل.

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
| --- | --- | --- |
| `GLB` | مخرج قديم للتوافق مع الإصدارات السابقة. | STRING |
| `OBJ` | النموذج ثلاثي الأبعاد المُنشأ بتنسيق ملف GLB (تنسيق نقل GL الثنائي). | FILE3DGLB |
| `texture_image` | النموذج ثلاثي الأبعاد المُنشأ بتنسيق ملف OBJ (Wavefront). | FILE3DOBJ |
| `optional_metallic` | صورة النسيج للنموذج ثلاثي الأبعاد المُنشأ. | IMAGE |
| `optional_normal` | خريطة المعدنية لمواد العرض الفيزيائي الواقعي. تُرجع صورة سوداء إذا لم تكن متوفرة. | IMAGE |
| `optional_roughness` | خريطة العمودية لمواد العرض الفيزيائي الواقعي. تُرجع صورة سوداء إذا لم تكن متوفرة. | IMAGE |
| `optional_roughness` | خريطة الخشونة لمواد العرض الفيزيائي الواقعي. تُرجع صورة سوداء إذا لم تكن متوفرة. | IMAGE |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TencentImageToModelNode/ar.md)

---
**Source fingerprint (SHA-256):** `56ac9e55bd9bb3a5c7c46c2de1ea06921cf41c0971471f6d0b64166722705e4d`
