# حفظ سحابة النقاط

يقوم عقدة حفظ سحابة النقاط بحفظ ملف سحابة نقاط ثلاثية الأبعاد في دليل الإخراج، مع توفير بيانات معاينة اختيارية لعارض العرض ثلاثي الأبعاد. تتعامل هذه العقدة مع تسمية الملفات وحفظها، بالإضافة إلى تمرير معلومات الكاميرا والنموذج لأغراض العرض.

## المدخلات

| المعامل | الوصف | نوع البيانات | إلزامي | النطاق |
|----------|-------|---------------|---------|--------|
| `model_3d` | ملف سحابة النقاط (.ply) | FILE3D_POINT_CLOUD_ANY أو FILE3D_PLY | نعم | - |
| `filename_prefix` | بادئة اسم الملف المحفوظ (الافتراضي: "3d/ComfyUI") | STRING | نعم | - |
| `viewport_state` | حالة منفذ العرض الحالية التي تحتوي على معلومات الكاميرا والنموذج | LOAD3D | نعم | - |
| `model_3d_info` | معلومات إضافية عن النموذج لعارض العرض ثلاثي الأبعاد | LOAD3D_MODEL_INFO | لا | - |
| `camera_info` | معلومات الكاميرا لعارض العرض ثلاثي الأبعاد | LOAD3D_CAMERA | لا | - |
| `width` | عرض شاشة المعاينة بالبكسل (الافتراضي: 1024) | INT | نعم | 1 إلى 4096 |
| `height` | ارتفاع شاشة المعاينة بالبكسل (الافتراضي: 1024) | INT | نعم | 1 إلى 4096 |
يُكتب الملف المحفوظ في دليل الإخراج باستخدام `filename_prefix` مع إلحاق عدّاد من 5 أرقام (مثل `3d/ComfyUI_00001.ply`). عندما لا يكون مدخل `camera_info` الاختياري متصلاً، تؤخذ معلومات الكاميرا من `viewport_state`؛ وبالمثل، عندما لا يكون `model_3d_info` متصلاً، تؤخذ معلومات النموذج من `viewport_state` (أو قائمة فارغة إذا لم تتوفر أي معلومات).

## المخرجات

| اسم المخرج | الوصف | نوع البيانات |
|-------------|-------|---------------|
| `model_3d` | ملف سحابة النقاط المحفوظ | FILE3D_POINT_CLOUD_ANY |
| `model_3d_info` | معلومات النموذج لعارض العرض ثلاثي الأبعاد | LOAD3D_MODEL_INFO |
| `camera_info` | معلومات الكاميرا لعارض العرض ثلاثي الأبعاد | LOAD3D_CAMERA |
| `width` | عرض شاشة المعاينة | INT |
| `height` | ارتفاع شاشة المعاينة | INT |

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

---
**Source fingerprint (SHA-256):** `ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a`
