본문으로 건너뛰기

오류 코드 참조

개요​

MipMapEngine SDK는 개발자가 문제를 신속하게 찾고 해결할 수 있도록 표준화된 오류 코드 시스템을 사용합니다. 오류 코드는 재구성 인터페이스 오류, 라이선스 오류, 파일 I/O 오류, GPU 오류를 포함한 여러 범주로 나뉩니다.

재구성 인터페이스 오류 코드 (ReconstructFull/ReconstructAT/Reconstruct3D)​

핵심 로직 클래스​

오류 코드설명
0재구성 성공
1000재구성 실패, 원인은 로그를 분석하세요
1001사용자가 취소함
1002좌표계 오류
1003AT 결과가 비어있음
1004점군 결과가 비어있음
1005메시 결과가 비어있음
1006나디어 이미지 부족, 2D 제품을 생성할 수 없음

라이선스 클래스​

오류 코드설명
2000라이선스 오류
2001라이선스 열거 실패
2002일치하는 라이선스를 찾을 수 없음
2003라이선스가 만료됨
2004이 버전에 라이선스를 적용할 수 없음
2005라이선스 기능 모듈 불일치
2006라이선스에서 지원하는 최대 이미지 수 초과

파일 I/O 클래스​

오류 코드설명
3000파일 읽기/쓰기 오류
3001JSON 필드 파싱 오류

컴퓨팅 장치 드라이버 클래스​

오류 코드설명
4000GPU 장치 오류, GPU가 NVIDIA인지 드라이버 버전이 요구사항을 충족하는지 확인하세요

라이선스 엔진 오류 코드​

오류 코드설명
0성공
0x00000040네트워크 오류
0x0000004A네트워크 요청 시간 초과
0x05000004서버를 찾을 수 없음
0x13000051라이선스는 온라인 활성화가 필요함
0x02000003연결 실패, Virbox 소프트웨어가 설치되지 않았거나 네트워크에 연결되지 않음
0x51005001인증 코드 상태 쿼리 중 예외 발생
0x51005002인증 코드 교환 요청 중 예외 발생
0x51005003인증 코드가 존재하지 않음
0x51005004인증 코드 라이선스 차감 실패
0x51005013바인딩할 수 없음 (라이선스 만료)
0x51005014바인딩할 수 없음 (인증 코드의 동시 장치 한도 도달)
0x51005015바인딩할 수 없음 (인증 코드의 누적 장치 한도 도달)
0x51005018인증 코드 터미널 언바인딩 실패, 소프트웨어 공급업체에 문의하세요
0x51005019서버가 바인딩 기록을 찾을 수 없음, 소프트웨어 공급업체에 문의하세요
0x51005021라이선스가 잠겨 있어 인증 코드 라이선스를 바인딩할 수 없음, 소프트웨어 공급업체에 문의하세요
0x51005025인증 코드가 바인딩을 허용하지 않음
0x51005033일시적으로 라이선스를 활성화할 수 없음, 사용자 도구를 최신 버전으로 업그레이드해야 함
0x51005034소프트웨어 공급업체가 이 장치의 사용 권한을 취소함, 현재 인증 코드는 다시 바인딩할 수 없음, 소프트웨어 공급업체에 문의하세요
0x5100612F인증 코드가 존재하지 않음, 인증 코드가 올바른지 확인하세요
0x51006130유효하지 않은 하드웨어 정보 데이터
0x51006134인증 코드 라이선스 차감 실패, 소프트웨어 공급업체에 문의하세요
0x5100502C언바인딩할 수 없음 (바인딩되지 않음)

오류 진단 흐름​

일반적인 해결책​

라이선스 오류 (2000-2006)​

  1. 라이선스 상태 확인:

    license_engine -enum

  2. 라이선스 만료 검증:

    license_engine -query

  3. 라이선스 업데이트:

    • 새 인증 코드에 대해 소프트웨어 공급업체에 문의
    • 라이선스 활성화 도구를 사용하여 업데이트

GPU 오류 (4000)​

  1. GPU 드라이버 확인:

    nvidia-smi

  2. 드라이버 업데이트:

    • 최신 NVIDIA 드라이버 다운로드
    • 드라이버 버전 >= 470.xx 확인

  3. CUDA 검증:

    nvcc --version

파일 I/O 오류 (3000-3001)​

  1. 권한 확인:

    ls -la /path/to/file
    chmod 755 /path/to/file

  2. JSON 형식 검증:

    task_json_check.exe -task_json config.json

  3. 디스크 공간 확인:

    df -h

오류 예방 모범 사례​

  1. 사전 점검:

    • 재구성 전 라이선스 검증
    • GPU 가용성 및 메모리 확인
    • 입력 데이터 품질 검증

  2. 모니터링:

    • GPU 메모리 사용량 모니터링
    • 재구성 진행 상황 추적
    • 로그 파일 정기적 확인

  3. 리소스 관리:

    • 충분한 디스크 공간 확보 (입력 데이터 크기의 3배 이상)
    • GPU 메모리 여유 공간 유지 (4GB 이상 권장)
    • 불필요한 애플리케이션 종료

  4. 데이터 검증:

    • 적절한 이미지 중첩 사용 (60-80%)
    • GPS/EXIF 데이터 정확성 검증
    • 좌표계 일관성 확인