Guia de Instalação (Windows)
Este guia ajudará você a instalar e configurar o MipMapEngine em sistemas Windows e Linux.
📋 Requisitos do Sistema
Requisitos de Hardware
| Componente | Requisitos Mínimos | Configuração Recomendada |
|---|---|---|
| CPU | Intel i5 ou equivalente | Intel i7/i9 ou AMD Ryzen 7/9 |
| Memória | 16 GB | 32 GB ou mais |
| Placa Gráfica | NVIDIA GTX 1050 Ti | NVIDIA RTX 3070 ou superior |
| Armazenamento | 50 GB de espaço disponível | 2 TB SSD |
Placas Gráficas Suportadas
MipMapEngine atualmente suporta apenas placas gráficas NVIDIA
- Requisitos de Arquitetura GPU: Capacidade de Computação ≥ 5.0
- Requisitos de Memória: GPU VRAM ≥ 4GB
Requisitos de Versão do Driver
- Windows: Driver NVIDIA ≥ 528.33
- Linux: Driver NVIDIA ≥ 525.60.33
🪟 Instalação Windows
Passo 1: Verificar Ambiente do Sistema
Use diretamente o script de verificação de hardware fornecido pelo SDK:
# Windows
Step1_Hardware_Check_EN.bat
# Ou executar manualmente
hardware_check.exe
Se o comando acima não funcionar. Para verificação manual, você pode usar os seguintes comandos:
# Verificar versão do driver NVIDIA
nvidia-smi
# Verificar versão do sistema
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"
Passo 2: Instalar Driver Virbox
- Baixar Virbox User Tools: https://lm.virbox.com/tools.html
- Executar o instalador e seguir o assistente para concluir a instalação
- Reiniciar o computador
Nota
Virbox é a ferramenta de criptografia e autorização do SDK, que deve ser instalada antes do uso.
Passo 3: Instalar SDK
- Extrair Pacote SDK
Use software de extração de arquivos ou PowerShell
# Extrair para diretório especificado
Expand-Archive -Path "MipMapEngine-SDK-4.0.zip" -DestinationPath "C:\MipMap\SDK"
- Definir Variáveis de Ambiente (Opcional)
Dica
- Se você optar por não definir variáveis de ambiente, certifique-se de usar o caminho correto do arquivo SDK ao chamar o SDK posteriormente
# Adicionar SDK ao caminho do sistema
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\MipMap\SDK\bin", "User")
- Verificar Instalação
# Verificar arquivos executáveis
reconstruct_full_engine.exe --version
Passo 4: Ativar Licença
Nota
- Antes de ativar a licença, certifique-se de que a verificação do ambiente de hardware acima tenha sido aprovada
# Ativar licença
license_engine.exe -bind YOUR-LICENSE-KEY
# Verificar status de ativação
license_engine.exe -enum license_info.json
🚨 Problemas Comuns
Problemas do Windows
Erro: Versão do driver NVIDIA muito baixa
Solução:
- Visite a página de download do driver NVIDIA
- Selecione o modelo da sua placa gráfica
- Baixe e instale o driver mais recente
📁 Estrutura do Diretório
Após a instalação, a estrutura do diretório SDK é a seguinte:
MipMap-SDK/
├── bin/ # Executáveis
│ ├── reconstruct_full_engine.exe # Motor de reconstrução completo
│ ├── license_engine.exe # Gerenciamento de licença
│ ├── task_json_check.exe # Ferramenta de validação de arquivo de configuração
│ ├── hardware_check.exe # Ferramenta de detecção de hardware
│ └── libraries # Bibliotecas dinâmicas de tempo de execução
├── gdal_data/ # Arquivos de dados GDAL
├── example/ # Projetos de exemplo
│ ├── 1_reconstruct_full_basic.json
│ ├── 2_group_cameras.json
│ ├── 3_custom_image_pos.json
│ ├── sample-images/ # Imagens de amostra
│ └── Step*.bat # Scripts de execução
└── docs/ # Documentação offline
✅ Lista de Verificação da Instalação
- Driver de placa gráfica NVIDIA atualizado para a versão necessária
- Driver Virbox instalado e em execução
- Arquivos SDK extraídos corretamente
- Variáveis de ambiente configuradas
- Licença ativada com sucesso
🚀 Próximos Passos
Instalação concluída! Agora você pode:
- 📚 Ler o guia de Início Rápido para começar seu primeiro projeto
- 🔧 Verificar Conceitos Básicos para aprender mais opções de configuração
- 💡 Explorar Referência da API para aprender o uso detalhado
Dica: Encontrando problemas durante a instalação? Verifique Solução de Problemas ou contate o suporte técnico.
Tendo problemas? Verifique o guia de solução de problemas ou contate o suporte técnico.