Installation Guide (Windows)

This guide will help you install and configure MipMapEngine on Windows and Linux systems.

📋 System Requirements

Hardware Requirements

Component	Minimum Requirements	Recommended Configuration
CPU	Intel i5 or equivalent	Intel i7/i9 or AMD Ryzen 7/9
Memory	16 GB	32 GB or higher
Graphics Card	NVIDIA GTX 1050 Ti	NVIDIA RTX 3070 or higher
Storage	50 GB available space	2 TB SSD

Supported Graphics Cards

MipMapEngine currently only supports NVIDIA graphics cards

• GPU Architecture Requirements: Compute Capability ≥ 5.0
• Memory Requirements: GPU VRAM ≥ 4GB

Driver Version Requirements

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

🪟 Windows Installation

Step 1: Check System Environment

Use the hardware check script provided by the SDK directly:

# Windows
Step1_Hardware_Check_EN.bat

# Or run manually
hardware_check.exe

If the above command doesn't work. For manual checking, you can use the following commands:

# Check NVIDIA driver version
nvidia-smi

# Check system version
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"

Step 2: Install Virbox Driver

1. Download Virbox User Tools: https://lm.virbox.com/tools.html
2. Run the installer and follow the wizard to complete installation
3. Restart your computer

Note

Virbox is the SDK's encryption and authorization tool, which must be installed before use.

Step 3: Install SDK

1. Extract SDK Package

Use file extraction software or PowerShell

# Extract to specified directory
Expand-Archive -Path "MipMapEngine-SDK-4.0.zip" -DestinationPath "C:\MipMap\SDK"

2. Set Environment Variables (Optional)

Tip

• If you choose not to set environment variables, ensure you use the correct SDK file path when calling the SDK later

# Add SDK to system path
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\MipMap\SDK\bin", "User")

3. Verify Installation

   # Check executable files
   reconstruct_full_engine.exe --version

Step 4: Activate License

Note

• Before activating the license, please ensure that the above hardware environment check has passed

# Activate license
license_engine.exe -bind YOUR-LICENSE-KEY

# Verify activation status
license_engine.exe -enum license_info.json

🚨 Common Issues

Windows Issues

Error: NVIDIA driver version too low

Solution:

1. Visit NVIDIA Driver Download Page
2. Select your graphics card model
3. Download and install the latest driver

📁 Directory Structure

After installation, the SDK directory structure is as follows:

MipMap-SDK/
├── bin/                             # Executables
│   ├── reconstruct_full_engine.exe  # Full reconstruction engine
│   ├── license_engine.exe           # License management
│   ├── task_json_check.exe          # Configuration file validation tool
│   ├── hardware_check.exe           # Hardware detection tool
│   └── libraries                    # Runtime dynamic libraries
├── gdal_data/                       # GDAL data files
├── example/                         # Example projects
│   ├── 1_reconstruct_full_basic.json
│   ├── 2_group_cameras.json
│   ├── 3_custom_image_pos.json
│   ├── sample-images/               # Sample images
│   └── Step*.bat                    # Run scripts
└── docs/                            # Offline documentation

✅ Installation Checklist

• NVIDIA graphics driver updated to required version
• Virbox driver installed and running
• SDK files extracted correctly
• Environment variables configured
• License successfully activated

🚀 Next Steps

Installation complete! Now you can:

• 📚 Read the Quick Start guide to begin your first project
• 🔧 Check Basic Concepts to learn more configuration options
• 💡 Explore API Reference to learn detailed usage

---

Tip: Encountering issues during installation? Check Troubleshooting or contact technical support.

Having problems? Check the troubleshooting guide or contact technical support.