windows환경에서 opencv 소스코드 빌드하여 설치하기

1. 소스코드 다운

① opencv repository :  OpenCV 기본 모듈에 대한 소스 코드

https://github.com/opencv/opencv 

② opencv_contrib repository : OpenCV 추가 모듈을 위한 소스 코드

https://github.com/opencv/opencv_contrib

각 리포지토리에서 Release항목의 Source code(zip)을 받아준다.

 

 

2. OpenCV 빌드를 위한 폴더 구조 생성

개인적으로는 Windows10에서 직접 빌드할 프로그램들을 위해, C:\extra를 만들어 사용하고 있다.

 

- C:\extra\opencv 를 생성하고, 다운로드한 소스코드 압축파일을 이곳에 압축해제 한다.

(2020년 4월 6일 OpenCV 4.3.0 버전이 릴리즈 되었다.)  

기본모듈의 소스코드를 C:\extra\opencv\opencv-4.3.0 폴더에

추가모듈의 소스코드를 C:\extra\opencv\opencv_contrib-4.3.0 폴더에 각각 압축해제한다.

- 빌드를 위한 작업폴더를 생성한다.

C:\extra\opencv\build

 

 

3. CMake를 이용하여 솔루션 파일을 생성

소스코드 안에 존재하는 헤더파일 및 소스파일만으로는 사용자의 프로젝트를 빌드할 수 없다.

Visual Studio 2017을 위한 솔루션 파일 및 프로젝트 파일을 생성한다.

- CMake( cmake-gui )실행

① where is the source code : C:\extra\opencv\opencv-4.3.0   

② where to build the binaries : C:\extra\opencv\build

 

Configure 버튼을 눌러서 OpenCV를 위한 프로그래밍 환경 설정 창으로 이동

③ Specify the generator for this project : Visual Studio 15 2017

④ Optional platform for generator : x64

Use default native compilers 선택 후 Finish 버튼 클릭

CMake가 OpenCV 소스코드를 분석하여 기본설정작업을 수해한다.

 

⑤ 필요한 항목 추가 선택 및 불필요한 항목 선택 해제 필요

    - BUILD_opencv_world 선택

    - OPENCV_EXTRA_MODULES_PATH : C:\extra\opencv\opencv_contrib-4.3.0/modules

개인적으로는 이외에도

    - EIGEN_INCLUDE_PATH 설정

    - INSTALL_C_EXAMPLES 선택

    - OPENCV_DNN_CUDA 선택

    - OPENCV_ENABLE_NONFREE 선택

등을 추가하였다.

 

Configure 버튼을 눌러서 설정이 모두 반영되면

최종적으로 Generate 버튼을 눌러서 OpenCV.sln 솔루션 파일과 여러 개의 프로젝트 파일의 생성이 이뤄지도록 한다.

 

 

4. Visual Studio에서 OpenCV 빌드하고 설치

① CMake에서 Open Project 선택 혹은

Visual Studil 2017 실행 후 파일 > 열기 > 프로젝트/솔루션 메뉴에서 

C:\extra\opencv\build 에 있는 OpenCV.sln 솔루션 파일 선택

② 우선, 솔루션 구성은 Debug 모드로, 솔루션 플랫폼은 x64로 설정한 다음

빌드 > 솔루션 빌드 메뉴를 통해 솔루션을 빌드한다.

→ 전체 빌드가 완료되면

C:\extra\opencv\build\bin\Debug 폴더에 opencv_world430d.dll 파일이 생성되고

C:\extra\opencv\build\lib\Debug 폴더에 opencv_world430d.lib 파일이 생성된다.

빌드가 완료되면 관련된 헤더파일 및 라이브러리 파일을 하나의 폴더 위치로 모으기 위해 

설치(install)작업이 필요하다.

③ INSTALL 프로젝트를 우클릭 > 빌드 하는 방식으로 설치 작업을 수행한다.

 

- 솔루션 구성을 Release로 변경하여 다시 빌드 및 설치과정 재수행한다.

 

 

5. OpenCV DLL 라이브러리 파일을 경로에 추가

① 새 사용자 변수 추가 OPENCV_DIR  : C:\extra\opencv\build\install

② Path 환경변수에  %OPENCV_DIR%\x64\vc15\bin 추가

 

cmd 창에서 opencv_version.exe 를 실행하여 버전이 제대로 출력되는지 확인한다.

 

참고) "OpenCV 4로 배우는 컴퓨터 비전과 머신러닝", 황선규, 길벗, 2019