Windows에 OpenCV 빌드하기

 

 

안녕하세요.

 

 유니티에서 OpenCV를 사용해 보기 위해서 먼저 OpenCV 라이브러리를 설치가 필요했습니다. 유니티에서 유니티 플러그인 형태로 만들어서 사용할 수 있다고 해서 한번 따라 해보려고 했습니다. 굳이 유니티가 아니더라도 C#, Qt 등 윈도우 프로그램 툴에서 사용해 보려면 별도로 설치가 필요합니다.

 

 윈도우 같은 경우는 설치파일이 있어서 간단하게 설치할 수 있습니다. OpenCV 사이트에 가서 버전을 확인 후 Windows 메뉴 링크로 다운로드하면 소스 빌드 없이 쉽게 설치할 수 있습니다.

 

https://opencv.org/releases/

Releases

 

 그러나 불필요한 모듈을 제거하거나 추가로 설치하려면 소스파일을 다운로드하여 다시 컴파일하여 설치해야 합니다. 여기서는 간단하게 현재 최신버전을 소스를 다운로드하여 빌드해서 윈도우에서 설치해 보겠습니다.

---

1. CMkae 설치하기

 - OpenCV Source 빌드 위한 프로그램을 다운로드해서 설치합니다.

  https://cmake.org/download/

 

2. OpenCV Source 다운로드하기

 1) 소스를 저장항 폴더 하나와 빌드할 폴더(build)를 먼저 생성하고 그 경로 아래의 소스파일을 다운로드한 후 압축을 풀어줍니다.

 

 

 2) Open Source Computer Vision Library

 - 최신 release 버전 다운로드합니다. 현재기준 4.8.0 (Source code.zip)

https://github.com/opencv/opencv/releases

 

 

 

 3) OpenCV's extra modules

 - 추가적인 모듈로 안정하지 않았지만, 새로운 기능의 모듈이 포함되어 있습니다. 이것도 다운로드합니다. 그런데 release 경로에는 나타나지 않아서 tag 경로로 들어가서 다운로드합니다.

https://github.com/opencv/opencv_contrib/releases/tag/4.8.0

 

3. CMake 작업

 - CMake 프로그램을 실행합니다.

 - 소스 경로와 빌드 결과가 저장되는 경로를 설정합니다.

 

  

- 하단에 “Configure” 버튼을 누르면 한번 어떤 종류의 툴과 플랫폼으로 설정파일을 생성할지 선택하는 창이 나타납니다. 여기서는 Visual Studio 2019와 x64로 선택합니다.

 

 

  

- 그러면 OpenCV Source 내에서 설정할 수 있는 여러 가지 옵션들을 분석한 후에 분홍색으로 나타납니다.

 

 

- 옵션 설정은 필요에 따라 선택하시면 됩니다. 옵션이 많다 보니, Search 창에 필요한 내용을 검색해서 선택하면 됩니다.

 

(1) tests

 

(2) extra

 

(3) nonfree

 

(4) Build_JAVA, BUILD_PACKAGE 체크해제

(JAVA에서 사용 시 체크유지하시면 됩니다.)

 

(5) WITH_1394,  WITH_GSTREAMER, WITH_LAPACK, WITH_VTK 체크 해제

 (필요에 따라 선택하시면 됩니다.)

 

(6) BUILD_opencv_world 옵션 체크 선택

 

(7) python은 이미 설치되어 있다면 경로들이 자동으로 나타납니다. (확인차원)

 

 - 최종적으로 했다면 “Configure” 버튼을 눌러서 설정을 다시 저장할 수 있습니다.

 - “Generate” 버튼을 눌러서 OpenCV 빌드 프로젝트를 생성합니다. 그러면 “Open Project” 버튼이 활성화됩니다. 버튼을 눌러 VS2019를 실행시켜도 되고 Build폴더를 OpenCV.sln 파일을 실행해도 됩니다.

 

  

4. VS 2019 Build

- Debug, x64로 솔루션 구성 설정을 먼저 합니다.

 

 - 솔루션 OpenCV에서 오른쪽 버튼을 눌러 솔루션 빌드를 실행하면

  

 - 문제없다면 아래와 같은 결과가 나타날 것입니다. 그러나 환경에 따라 에러가 발생할 수 있는데, 에러메시지를 구글링 하면 도움을 받을 수 있습니다. 그리고 필요에 따라서 솔루션 구성을 Release로 바꿔서 다시 빌드를 진행하면 됩니다.

 

- C:\opencv_src_vs\build\x64\vc16 폴더가 생성되지 않았다면 CMakeTargets -> INSTALL에서 빌드를 한번 진행합니다.

 

 

5. 환경설정

- 기본 라이브러리는 생성이 끝났고 실제 사용하기 위해서는 환경설정을 조금 해주면 편하게 사용할 수 있습니다.

- 최종적으로 두 개의 폴더가 생성되고 안에 여러 모듈의 dll파일과 lib파일이 들어 있습니다. dll 파일은 프로그램이 실행 시 호출되고, lib파일은 개발 시 사용하기 위해서 필요합니다.

 

- “시스템 속성” 혹은 “시스템 환경변수 편집”-> 고습 탭 -> 환경변수 -> 새로 만들기 선택합니다.

 

- 변수 이름을 “OPENCV_DIR”로 하고 생성했던 build 폴더를 선택합니다.

 

 

 

 

 

6. 간단한 설치 확인

- 명령 프롬프트 창에서 “opencv_version.exe”를 실행해서 설치한 버전이 나타난다면 기본적인 설치가 되었다고 볼 수 있습니다.

 

향후 VS 2019에서 링커 등 설정을 통해서 프로그램 개발에 필요한 환경을 설정하면 됩니다.

 

감사합니다.

 

 

<참고사이트>

1. Open CV for Unity on Window Tutorial 01

https://blog.naver.com/dnflrkwhr888/222040694090

2. OpenCV 설치 및 빌드하기(windows 버전)

https://give-cheese.com/124