Guida all'installazione (Windows)
Questa guida ti aiuterà a installare e configurare MipMapEngine su sistemi Windows e Linux.
📋 Requisiti di sistema
Requisiti hardware
| Componente | Requisiti minimi | Configurazione consigliata |
|---|---|---|
| CPU | Intel i5 o equivalente | Intel i7/i9 o AMD Ryzen 7/9 |
| Memoria | 16 GB | 32 GB o superiore |
| Scheda grafica | NVIDIA GTX 1050 Ti | NVIDIA RTX 3070 o superiore |
| Archiviazione | 50 GB di spazio disponibile | 2 TB SSD |
Schede grafiche supportate
MipMapEngine attualmente supporta solo schede grafiche NVIDIA
- Requisiti architettura GPU: Capacità di calcolo ≥ 5.0
- Requisiti di memoria: GPU VRAM ≥ 4GB
Requisiti versione driver
- Windows: Driver NVIDIA ≥ 528.33
- Linux: Driver NVIDIA ≥ 525.60.33
🪟 Installazione Windows
Passo 1: Verifica ambiente di sistema
Usa direttamente lo script di verifica hardware fornito dall'SDK:
# Windows
Step1_Hardware_Check_EN.bat
# O esegui manualmente
hardware_check.exe
Se il comando sopra non funziona. Per la verifica manuale, puoi usare i seguenti comandi:
# Verifica versione driver NVIDIA
nvidia-smi
# Verifica versione sistema
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"
Passo 2: Installa driver Virbox
- Scarica Virbox User Tools: https://lm.virbox.com/tools.html
- Esegui l'installer e segui la procedura guidata per completare l'installazione
- Riavvia il computer
Nota
Virbox è lo strumento di crittografia e autorizzazione dell'SDK, che deve essere installato prima dell'uso.
Passo 3: Installa SDK
- Estrai pacchetto SDK
Usa software di estrazione file o PowerShell
# Estrai nella directory specificata
Expand-Archive -Path "MipMapEngine-SDK-4.0.zip" -DestinationPath "C:\MipMap\SDK"
- Imposta variabili d'ambiente (opzionale)
Suggerimento
- Se scegli di non impostare le variabili d'ambiente, assicurati di usare il percorso file SDK corretto quando chiami l'SDK successivamente
# Aggiungi SDK al percorso di sistema
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\MipMap\SDK\bin", "User")
- Verifica installazione
# Controlla file eseguibili
reconstruct_full_engine.exe --version
Passo 4: Attiva licenza
Nota
- Prima di attivare la licenza, assicurati che il controllo dell'ambiente hardware sopra sia stato superato
# Attiva licenza
license_engine.exe -bind YOUR-LICENSE-KEY
# Verifica stato attivazione
license_engine.exe -enum license_info.json
🚨 Problemi comuni
Problemi Windows
Errore: Versione driver NVIDIA troppo bassa
Soluzione:
- Visita la pagina di download driver NVIDIA
- Seleziona il modello della tua scheda grafica
- Scarica e installa il driver più recente
📁 Struttura directory
Dopo l'installazione, la struttura della directory SDK è la seguente:
MipMap-SDK/
├── bin/ # Eseguibili
│ ├── reconstruct_full_engine.exe # Motore di ricostruzione completo
│ ├── license_engine.exe # Gestione licenze
│ ├── task_json_check.exe # Strumento di validazione file di configurazione
│ ├── hardware_check.exe # Strumento di rilevamento hardware
│ └── libraries # Librerie dinamiche di runtime
├── gdal_data/ # File di dati GDAL
├── example/ # Progetti di esempio
│ ├── 1_reconstruct_full_basic.json
│ ├── 2_group_cameras.json
│ ├── 3_custom_image_pos.json
│ ├── sample-images/ # Immagini di esempio
│ └── Step*.bat # Script di esecuzione
└── docs/ # Documentazione offline
✅ Checklist installazione
- Driver scheda grafica NVIDIA aggiornato alla versione richiesta
- Driver Virbox installato e in esecuzione
- File SDK estratti correttamente
- Variabili d'ambiente configurate
- Licenza attivata con successo
🚀 Prossimi passi
Installazione completata! Ora puoi:
- 📚 Leggere la guida Avvio rapido per iniziare il tuo primo progetto
- 🔧 Controllare Concetti di base per imparare altre opzioni di configurazione
- 💡 Esplorare Riferimento API per imparare l'uso dettagliato
Suggerimento: Incontri problemi durante l'installazione? Controlla Risoluzione dei problemi o contatta il supporto tecnico.
Hai problemi? Controlla la guida alla risoluzione dei problemi o contatta il supporto tecnico.