설치 가이드 (Windows)
이 가이드는 Windows 및 Linux 시스템에서 MipMapEngine을 설치하고 구성하는 데 도움이 됩니다.
📋 시스템 요구 사항
하드웨어 요구 사항
| 구성 요소 | 최소 요구 사항 | 권장 구성 |
|---|---|---|
| CPU | Intel i5 또는 동급 | Intel i7/i9 또는 AMD Ryzen 7/9 |
| 메모리 | 16 GB | 32 GB 이상 |
| 그래픽 카드 | NVIDIA GTX 1050 Ti | NVIDIA RTX 3070 이상 |
| 저장소 | 50 GB 사용 가능 공간 | 2 TB SSD |
지원되는 그래픽 카드
MipMapEngine은 현재 NVIDIA 그래픽 카드만 지원합니다
- GPU 아키텍처 요구 사항: Compute Capability ≥ 5.0
- 메모리 요구 사항: GPU VRAM ≥ 4GB
드라이버 버전 요구 사항
- 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 User Tools 다운로드: 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 파일이 올바르게 추출됨
- 환경 변수 구성됨
- 라이선스가 성공적으로 활성화됨
🚀 다음 단계
설치 완료! 이제 다음을 할 수 있습니다:
팁: 설치 중 문제가 발생했나요? 문제 해결을 확인하거나 기술 지원에 문의하세요.
문제가 있나요? 문제 해결 가이드를 확인하거나 기술 지원에 문의하세요.