Skip to content

Restore 3D docs #81

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
comfyui-wiki wants to merge 2 commits into from
Closed

Restore 3D docs #81

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bd337bc
Restore 3D node docs with images and correct parameter tables.
comfyui-wiki May 21, 2026
91fe59e
Fix parameter name in Persian documentation for Load3D node by changi…
comfyui-wiki May 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
110 changes: 54 additions & 56 deletions comfyui_embedded_docs/docs/Load3D/ar.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,85 +1,83 @@
> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3D/ar.md)
> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3D/ar.md)

بالتأكيد، إليك الترجمة العربية للوثيقة التقنية الخاصة بعقدة ComfyUI، مع الالتزام التام بقواعد الترجمة المحددة:

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

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

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

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

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

## المدخلات

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

## المخرجات

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

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

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

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

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

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

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

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

<video controls width="640" height="360">
<source src="./asset/view_operations.mp4" type="video/mp4">
متصفحك لا يدعم تشغيل الفيديو.
المتصفح الخاص بك لا يدعم تشغيل الفيديو.
</video>

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

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

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

![القائمة](./asset/menu.webp)

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

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

#### المشهد
Expand All @@ -99,38 +97,38 @@

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

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

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

![قائمة الكاميرا](./asset/menu_camera.webp)

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

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

#### الإضاءة
#### الضوء

![قائمة الإضاءة](./asset/menu_light.webp)
![قائمة الضوء](./asset/menu_light.webp)

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

#### التصدير

![قائمة التصدير](./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/view_operations.mp4" type="video/mp4">
متصفحك لا يدعم تشغيل الفيديو.
<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>

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

1. **إعادة تعيين نسبة العرض**: بعد النقر على الزر، ستقوم نافذة العرض بضبط نسبة منطقة عرض اللوحة وفقاً للعرض والارتفاع المحددين
2. **تسجيل الفيديو**: يتيح لك تسجيل عمليات العرض ثلاثي الأبعاد الحالية كفيديو، ويسمح بالاستيراد، ويمكن إخراجه كـ `recording_video` إلى العقد اللاحقة
1. **إعادة تعيين نسبة العرض**: بعد النقر على الزر، سيقوم العرض بضبط نسبة منطقة عرض لوحة الرسم وفقًا للعرض والارتفاع المحددين
2. **تسجيل الفيديو**: يسمح لك بتسجيل عمليات العرض ثلاثي الأبعاد الحالية كفيديو، يسمح بالاستيراد، ويمكن إخراجه كـ `recording_video` إلى العُقد اللاحقة
2 changes: 1 addition & 1 deletion comfyui_embedded_docs/docs/Load3D/en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ This menu provides the ability to quickly convert and export model formats
### 3. Right Menu Functions

<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">
<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">
Your browser does not support video playback.
</video>

Expand Down
Loading
Loading