Saltar al contenido principal

Guía de instalación (Windows)

Esta guía le ayudará a instalar y configurar MipMapEngine en sistemas Windows y Linux.

📋 Requisitos del sistema​

Requisitos de hardware​

ComponenteRequisitos mínimosConfiguración recomendada
CPUIntel i5 o equivalenteIntel i7/i9 o AMD Ryzen 7/9
Memoria16 GB32 GB o más
Tarjeta gráficaNVIDIA GTX 1050 TiNVIDIA RTX 3070 o superior
Almacenamiento50 GB de espacio disponible2 TB SSD

Tarjetas gráficas compatibles​

MipMapEngine actualmente solo admite tarjetas gráficas NVIDIA
  • Requisitos de arquitectura GPU: Capacidad de cómputo ≥ 5.0
  • Requisitos de memoria: GPU VRAM ≥ 4GB

Requisitos de versión del controlador​

  • Windows: Controlador NVIDIA ≥ 528.33
  • Linux: Controlador NVIDIA ≥ 525.60.33

🪟 Instalación de Windows​

Paso 1: Verificar el entorno del sistema​

Use el script de verificación de hardware proporcionado por el SDK directamente:

# Windows
Step1_Hardware_Check_EN.bat

# O ejecutar manualmente
hardware_check.exe

Si el comando anterior no funciona. Para la verificación manual, puede usar los siguientes comandos:

# Verificar la versión del controlador NVIDIA
nvidia-smi

# Verificar la versión del sistema
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"

Paso 2: Instalar el controlador Virbox​

  1. Descargar Virbox User Tools: https://lm.virbox.com/tools.html
  2. Ejecutar el instalador y seguir el asistente para completar la instalación
  3. Reiniciar la computadora
Nota

Virbox es la herramienta de cifrado y autorización del SDK, que debe instalarse antes de usar.

Paso 3: Instalar SDK​

  1. Extraer el paquete SDK

Use software de extracción de archivos o PowerShell

# Extraer al directorio especificado
Expand-Archive -Path "MipMapEngine-SDK-4.0.zip" -DestinationPath "C:\MipMap\SDK"
  1. Configurar variables de entorno (opcional)
Consejo
  • Si elige no configurar variables de entorno, asegúrese de usar la ruta correcta del archivo SDK al llamar al SDK más tarde
# Agregar SDK a la ruta del sistema
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\MipMap\SDK\bin", "User")
  1. Verificar instalación 
    # Verificar archivos ejecutables
    reconstruct_full_engine.exe --version

Paso 4: Activar licencia​

Nota
  • Antes de activar la licencia, asegúrese de que la verificación del entorno de hardware anterior haya pasado
# Activar licencia
license_engine.exe -bind YOUR-LICENSE-KEY

# Verificar estado de activación
license_engine.exe -enum license_info.json

🚨 Problemas comunes​

Problemas de Windows​

Error: Versión del controlador NVIDIA demasiado baja

Solución:

  1. Visite la página de descarga del controlador NVIDIA
  2. Seleccione su modelo de tarjeta gráfica
  3. Descargue e instale el controlador más reciente

📁 Estructura del directorio​

Después de la instalación, la estructura del directorio SDK es la siguiente:

MipMap-SDK/
├── bin/                             # Ejecutables
│   ├── reconstruct_full_engine.exe  # Motor de reconstrucción completo
│   ├── license_engine.exe           # Gestión de licencias
│   ├── task_json_check.exe          # Herramienta de validación de archivos de configuración
│   ├── hardware_check.exe           # Herramienta de detección de hardware
│   └── libraries                    # Bibliotecas dinámicas de tiempo de ejecución
├── gdal_data/                       # Archivos de datos GDAL
├── example/                         # Proyectos de ejemplo
│   ├── 1_reconstruct_full_basic.json
│   ├── 2_group_cameras.json
│   ├── 3_custom_image_pos.json
│   ├── sample-images/               # Imágenes de muestra
│   └── Step*.bat                    # Scripts de ejecución
└── docs/                            # Documentación sin conexión

✅ Lista de verificación de instalación​

  • Controlador de tarjeta gráfica NVIDIA actualizado a la versión requerida
  • Controlador Virbox instalado y en funcionamiento
  • Archivos SDK extraídos correctamente
  • Variables de entorno configuradas
  • Licencia activada con éxito

🚀 Próximos pasos​

¡Instalación completa! Ahora puede:

Consejo: ¿Encuentra problemas durante la instalación? Consulte Solución de problemas o contacte con el soporte técnico.

¿Tiene problemas? Consulte la guía de solución de problemas o contacte con el soporte técnico.