عقدة تحميل الرسوم المتحركة ثلاثية الأبعاد (Load3DAnimation) هي عقدة أساسية لتحميل ومعالجة ملفات النماذج ثلاثية الأبعاد. عند تحميل العقدة، تقوم تلقائيًا باسترداد الموارد ثلاثية الأبعاد المتاحة من المسار `ComfyUI/input/3d/`. يمكنك أيضًا رفع ملفات ثلاثية الأبعاد مدعومة للمعاينة باستخدام وظيفة الرفع.

> - معظم وظائف هذه العقدة مماثلة لوظائف عقدة التحميل ثلاثي الأبعاد (Load 3D)، ولكن هذه العقدة تدعم تحميل النماذج ذات الرسوم المتحركة، ويمكنك معاينة الرسوم المتحركة المقابلة في العقدة.
> - محتوى هذه الوثيقة مطابق لمحتوى وثيقة عقدة التحميل ثلاثي الأبعاد (Load3D)، لأن قدراتها متطابقة باستثناء معاينة وتشغيل الرسوم المتحركة.

**الصيغ المدعومة**
حاليًا، تدعم هذه العقدة صيغ ملفات ثلاثية الأبعاد متعددة، بما في ذلك `.gltf` و `.glb` و `.obj` و `.fbx` و `.stl`.

**تفضيلات العقد ثلاثية الأبعاد**
يمكن تكوين بعض التفضيلات ذات الصلة بالعقد ثلاثية الأبعاد في قائمة إعدادات ComfyUI. يُرجى الرجوع إلى الوثائق التالية للإعدادات المقابلة:

[قائمة الإعدادات](https://docs.comfy.org/interface/settings/3d)

بالإضافة إلى المخرجات المعتادة للعقد، تحتوي عقدة التحميل ثلاثي الأبعاد (Load3D) على العديد من الإعدادات المتعلقة بعرض المنظور ثلاثي الأبعاد في قائمة اللوحة الفنية.

## المدخلات

| اسم المعامل | الوصف | النوع | القيمة الافتراضية | النطاق |
| --- | --- | --- | --- | --- |
| model_file | مسار ملف النموذج ثلاثي الأبعاد، يدعم الرفع، ويقرأ افتراضيًا ملفات النموذج من `ComfyUI/input/3d/` | اختيار ملف | - | الصيغ المدعومة |
| width | عرض عرض اللوحة الفنية | INT | 1024 | 1-4096 |
| height | ارتفاع عرض اللوحة الفنية | INT | 1024 | 1-4096 |

## المخرجات

| اسم المعامل | الوصف | نوع البيانات |
| --- | --- | --- |
| image | الصورة المقدمة من اللوحة الفنية | IMAGE |
| mask | قناع يحتوي على موضع النموذج الحالي | MASK |
| mesh_path | مسار ملف النموذج | STRING |
| normal | خريطة الاتجاهات الطبيعية | IMAGE |
| lineart | مخرجات صورة الفن الخطي، يمكن ضبط `edge_threshold` المقابل في قائمة نموذج اللوحة الفنية | IMAGE |
| camera_info | معلومات الكاميرا | LOAD3D_CAMERA |
| recording_video | الفيديو المسجل (فقط عند وجود تسجيل) | VIDEO |

معاينة جميع المخرجات:
![عرض توضيحي للتشغيل](../Load3D/asset/load3d_outputs.webp)

## وصف منطقة اللوحة الفنية

تحتوي منطقة اللوحة الفنية لعقدة التحميل ثلاثي الأبعاد (Load3D) على العديد من عمليات العرض، بما في ذلك:

- إعدادات عرض المعاينة (الشبكة، لون الخلفية، عرض المعاينة)
- التحكم في الكاميرا: التحكم في مجال الرؤية (FOV)، نوع الكاميرا
- شدة الإضاءة العامة: ضبط شدة الإضاءة
- تسجيل الفيديو: تسجيل وتصدير مقاطع الفيديو
- تصدير النموذج: يدعم صيغ `GLB` و `OBJ` و `STL`
- والمزيد

![واجهة مستخدم عقدة التحميل ثلاثي الأبعاد](../Load3D/asset/load3d_ui.jpg)

1. يحتوي على قوائم متعددة وقوائم مخفية لعقدة التحميل ثلاثي الأبعاد
2. قائمة `لتغيير حجم نافذة المعاينة` و `تسجيل فيديو اللوحة الفنية`
3. محور تشغيل العرض ثلاثي الأبعاد
4. صورة مصغرة للمعاينة
5. إعدادات حجم المعاينة، قم بقياس عرض نافذة المعاينة عن طريق تعيين الأبعاد ثم تغيير حجم النافذة

### 1. عمليات العرض

<video controls width="640" height="360">
  <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/view_operations.mp4" type="video/mp4">
  متصفحك لا يدعم تشغيل الفيديو.
</video>

عمليات التحكم في العرض:

- النقر بزر الماوس الأيسر + السحب: تدوير العرض
- النقر بزر الماوس الأيمن + السحب: تحريك العرض
- تمرير العجلة الوسطى أو النقر بزر الماوس الأوسط + السحب: تكبير/تصغير
- محور الإحداثيات: تبديل طرق العرض

### 2. وظائف القائمة اليسرى

![القائمة](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu.webp)

في اللوحة الفنية، بعض الإعدادات مخفية في القائمة. انقر على زر القائمة لتوسيع قوائم مختلفة

- 1. المشهد (Scene): يحتوي على شبكة نافذة المعاينة، لون الخلفية، إعدادات المعاينة
- 2. النموذج (Model): وضع عرض النموذج، مواد النسيج، إعدادات الاتجاه العلوي
- 3. الكاميرا (Camera): التبديل بين العرض المتعامد والمنظوري، وتعيين حجم زاوية المنظور
- 4. الإضاءة (Light): شدة الإضاءة العامة للمشهد
- 5. التصدير (Export): تصدير النموذج إلى صيغ أخرى (GLB, OBJ, STL)

#### المشهد

![قائمة المشهد](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp)

توفر قائمة المشهد بعض وظائف إعدادات المشهد الأساسية

1. إظهار/إخفاء الشبكة
2. تعيين لون الخلفية
3. انقر لرفع صورة خلفية
4. إخفاء المعاينة

#### النموذج

![قائمة النموذج](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp)

توفر قائمة النموذج بعض الوظائف المتعلقة بالنموذج

1. **الاتجاه العلوي**: تحديد المحور الذي يمثل الاتجاه العلوي للنموذج
2. **وضع المواد**: تبديل أوضاع عرض النموذج - الأصلي، الاتجاهات الطبيعية، الإطار السلكي، الفن الخطي

#### الكاميرا

![قائمة الكاميرا](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp)

توفر هذه القائمة التبديل بين العرض المتعامد والمنظوري، وإعدادات حجم زاوية المنظور

1. **الكاميرا**: التبديل السريع بين العرض المتعامد والعرض المتعامد
2. **مجال الرؤية (FOV)**: ضبط زاوية مجال الرؤية

#### الإضاءة

![قائمة الإضاءة](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp)

من خلال هذه القائمة، يمكنك ضبط شدة الإضاءة العامة للمشهد بسرعة

#### التصدير

![قائمة التصدير](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp)

توفر هذه القائمة إمكانية التحويل السريع وتصدير صيغ النماذج

### 3. وظائف القائمة اليمنى

<video controls width="640" height="360">
  <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/recording.mp4" type="video/mp4">
  متصفحك لا يدعم تشغيل الفيديو.
</video>

للقائمة اليمنى وظيفتان رئيسيتان:

1. **إعادة تعيين نسبة العرض**: بعد النقر على الزر، سيقوم العرض بضبط نسبة مساحة عرض اللوحة الفنية وفقًا للعرض والارتفاع المحددين
2. **تسجيل الفيديو**: يتيح لك تسجيل عمليات العرض ثلاثي الأبعاد الحالية كفيديو، ويسمح بالاستيراد، ويمكن إخراجه كـ `recording_video` إلى العقد اللاحقة

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