دليل التثبيت (Windows)
سيساعدك هذا الدليل على تثبيت وتكوين MipMapEngine على أنظمة Windows و Linux.
📋 متطلبات النظام
متطلبات الأجهزة
| المكون | الحد الأدنى من المتطلبات | التكوين الموصى به |
|---|---|---|
| المعالج | Intel i5 أو ما يعادله | Intel i7/i9 أو AMD Ryzen 7/9 |
| الذاكرة | 16 جيجابايت | 32 جيجابايت أو أكثر |
| بطاقة الرسومات | NVIDIA GTX 1050 Ti | NVIDIA RTX 3070 أو أعلى |
| التخزين | 50 جيجابايت مساحة متاحة | 2 تيرابايت SSD |
بطاقات الرسومات المدعومة
MipMapEngine يدعم حاليًا فقط بطاقات رسومات NVIDIA
- متطلبات بنية GPU: قدرة الحوسبة ≥ 5.0
- متطلبات الذاكرة: ذاكرة GPU VRAM ≥ 4 جيجابايت
متطلبات إصدار التعريف
- Windows: تعريف NVIDIA ≥ 528.33
- Linux: تعريف NVIDIA ≥ 525.60.33
🪟 تثبيت Windows
الخطوة 1: فحص بيئة النظام
استخدم نص فحص الأجهزة المقدم من SDK مباشرة:
# Windows
Step1_Hardware_Check_EN.bat
# أو تشغيل يدوي
hardware_check.exe
إذا لم يعمل الأمر أعلاه. للفحص اليدوي، يمكنك استخدام الأوامر التالية:
# فحص إصدار تعريف NVIDIA
nvidia-smi
# فحص إصدار النظام
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"
الخطوة 2: تثبيت تعريف Virbox
- تحميل أدوات مستخدم Virbox: https://lm.virbox.com/tools.html
- تشغيل المثبت واتباع المعالج لإكمال التثبيت
- إعادة تشغيل الكمبيوتر
ملاحظة
Virbox هي أداة التشفير والترخيص الخاصة بـ SDK، والتي يجب تثبيتها قبل الاستخدام.
الخطوة 3: تثبيت SDK
- استخراج حزمة SDK
استخدم برنامج استخراج الملفات أو PowerShell
# الاستخراج إلى دليل محدد
Expand-Archive -Path "MipMapEngine-SDK-4.0.zip" -DestinationPath "C:\MipMap\SDK"
- تعيين متغيرات البيئة (اختياري)
نصيحة
- إذا اخترت عدم تعيين متغيرات البيئة، تأكد من استخدام مسار ملف SDK الصحيح عند استدعاء SDK لاحقًا
# إضافة SDK إلى مسار النظام
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\MipMap\SDK\bin", "User")
- التحقق من التثبيت
# فحص الملفات القابلة للتنفيذ
reconstruct_full_engine.exe --version
الخطوة 4: تفعيل الترخيص
ملاحظة
- قبل تفعيل الترخيص، يرجى التأكد من اجتياز فحص بيئة الأجهزة أعلاه
# تفعيل الترخيص
license_engine.exe -bind YOUR-LICENSE-KEY
# التحقق من حالة التفعيل
license_engine.exe -enum license_info.json
🚨 المشاكل الشائعة
مشاكل Windows
خطأ: إصدار تعريف NVIDIA منخفض جدًا
الحل:
- زيارة صفحة تحميل تعريف NVIDIA
- اختر طراز بطاقة الرسومات الخاصة بك
- تحميل وتثبيت أحدث تعريف
📁 هيكل الدليل
بعد التثبيت، يكون هيكل دليل SDK كما يلي:
MipMap-SDK/
├── bin/ # الملفات القابلة للتنفيذ
│ ├── reconstruct_full_engine.exe # محرك إعادة البناء الكامل
│ ├── license_engine.exe # إدارة الترخيص
│ ├── task_json_check.exe # أداة التحقق من ملف التكوين
│ ├── hardware_check.exe # أداة الكشف عن الأجهزة
│ └── libraries # مكتبات الربط الديناميكي للتشغيل
├── gdal_data/ # ملفات بيانات GDAL
├── example/ # مشاريع الأمثلة
│ ├── 1_reconstruct_full_basic.json
│ ├── 2_group_cameras.json
│ ├── 3_custom_image_pos.json
│ ├── sample-images/ # صور عينة
│ └── Step*.bat # نصوص التشغيل
└── docs/ # الوثائق غير المتصلة
✅ قائمة فحص التثبيت
- تحديث تعريف بطاقة رسومات NVIDIA إلى الإصدار المطلوب
- تثبيت تعريف Virbox وتشغيله
- استخراج ملفات SDK بشكل صحيح
- تكوين متغيرات البيئة
- تفعيل الترخيص بنجاح
🚀 الخطوات التالية
اكتمل التثبيت! الآن يمكنك:
- 📚 قراءة دليل البداية السريعة لبدء مشروعك الأول
- 🔧 مراجعة المفاهيم الأساسية لتعلم المزيد من خيارات التكوين
- 💡 استكشاف مرجع API لتعلم الاستخدام التفصيلي
نصيحة: تواجه مشاكل أثناء التثبيت؟ تحقق من استكشاف الأخطاء وإصلاحها أو اتصل بالدعم الفني.
لديك مشاكل؟ تحقق من دليل استكشاف الأخطاء وإصلاحها أو اتصل بالدعم الفني.