OpenCV 설치 및 빌드하기 (window버젼)

영상 처리! 컴퓨터 비전!

 

수학, 신호처리, 광학, 로봇 공학, 머신러닝, 컴퓨터 그래픽스등

다양한 학문의 기술과 밀접한 관계가 있습니다.

 

OpenCV는 오픈 소스로 컴퓨터 비전 및 머신 러닝 라이브러리입니다.

OpenCV 를 통해 쉽게 컴퓨터 비전에 대해 확인할 수 있는데요.

 

OpenCV 소스 코드를 빌드해서 설치하는 것에 대해 알아보도록 하겠습니다.

Window 운영 체계에서 OpenCV를 설치할 때 설치 실행 파일을 사용하면

OpenCV 추가 모듈을 사용할 수 없는 단점이 있습니다.

 

초기에 자신의 시스템 환경에 맞도록 설치하여서

최적의 OpenCV 라이브러리를 사용할 수 있도록 환경을 구축하는 것을 

추천드립니다.

 

OpenCV 소스 코드 내려받기

OpenCV는 두 개의 repository를 이용하여 소스 코드를 관리합니다.

 

opencv와 opencv_contrib입니다.

OpenCV의 기본 모듈에 대한 소스코드는 opencv에 저장하고

추가 모듈에 대한 소스는  opencv_contrib에 저장됩니다.

 

소스를 내려받아 build 하려면 둘 다 다운로드하여야 합니다.

 

https://github.com/opencv/

GitHub - opencv/opencv: Open Source Computer Vision Library

 

 

보이는  opencv와 opencv_contrib을 눌러 페이지에 진입하실 수 있습니다.

해당 페이지에서 Release를 눌러 들어가면 가장 최신 버전의 Release 버전을 확인하고 

소스 코드를 내려받을 수 있습니다.

 

 

opencv_contrib의

C:/opencv 폴더를 만듭니다.

C:/opencv/build 디렉터리를 생성합니다.

다운로드한 파일의 압축을 풀어 아래 그림과 같이 파일탐색기 구조로 폴더를 생성합니다.

C:/opencv 디렉터리 아래에 build, opencv-4.7.0, opencv_contrib-4.7.0 디렉터리 3개가 만들어진 것을 확인합니다.

 

각 디렉터리의 내용도 확인하실 수 있습니다.

 

CMake로 솔루션 파일 생성하기

Visual Studio에서 OpenCV를 빌드하기 위해 Visual Studio를 위한 솔루션 파일과 프로젝트 파일을 

만드는 방법에 대해서는 다음 글을 참조하시길 추천드립니다.

 

2023.04.11 - [IT] - OpenCV 빌드를 위한 CMake 설정

OpenCV 빌드를 위한 CMake 설정

 

CMake에서 OpenCV.sln 솔루션 파일을 만들었다면

Visual Studio에서 OpenCV 라이브러리를 빌드하는 작업을 하실 수 있습니다.

OpenCV 빌드하기

Visual Studio에서 OpenCV 열기

CMake에서

CMake 화면에서 open project 버튼을 클릭하면

Visual Studio가 자동으로 실행되고 OpenCV 를 불러옵니다.

Visual Studio에서

Visual Studio를 실행한 후 파일 > 열기 > 프로젝트/솔루션(P) 메뉴를 클릭한 후

C:/opencv/build 디렉터리에 있는 OpenCV.sln 파일을 선택하면 불려집니다.

 

Visual studio 화면의 솔루션 탐색기 창에 여러 프로젝트가 포함된 것을 확인하실 수 있습니다.

 

visual studio 솔루션 탐색기

 

 

Visual Studio에서 OpenCV 빌드하기

Visual Studio에서 빌드 > 솔루션 빌드 메뉴를 선택하면 빌드 작업을 수행합니다.

출력창에서 빌드의 진행 내역에 대해 조회가 가능합니다.

OpenCV 빌드

 

컴퓨터 성능에 따라 이 빌드 작업은 장시간이 걸리수도 있습니다.

빌드가 완료되면 출력창에 다음과 같은 메시지를 확인하실 수 있습니다.

 

========== 빌드: 성공 112, 실패 1, 최신 0, 생략 10 ==========

 

실패가 1건이 있고 오류 목록에서 다음과 같은 메시지를 확인할 수 있습니다.

 

정상적으로 빌드되었다면 

C:\opencv\build\bin\Debug 디렉터리 :  opencv_world470d.dll 파일이 생성

C:\opencv\build\lib\Debug 디렉터리 :  opencv_world470d.lib파일이 생성됩니다.

 

만약 에러로 인해 opencv_world470d.dll 파일이 생성되지 않았다면 CMake 단계를 다시 진행하셔야 합니다.

 

openCV 라이브러리와 각종 헤더 파일들을 특정 폴더에 모아 관리하는 작업이 INSTALL이라 합니다.

Visual Studio의 솔루션 탐색기에서 CMakeTargets > INSTALL 프로젝트 이름 선택

오른쪽 마우스를 누르면 나오는 빌드 메뉴를 선택해 빌드합니다.

 

 

INSTALL 프로젝트 빌드 작업이 완료되고 출력창에 다음과 같이 출력됩니다.

 

========== 빌드: 성공 2, 실패 1, 최신 110, 생략 0 ==========

 

PYTHON관련 실패건이 남아 있습니다.

이상으로 Visual Studio에서 Debug 모드의 OpenCV 라이브러리를 빌드하고 설치하는 작업이 완료되었습니다.

 

 

Release 모드에서도 동일한 작업을 수행합니다.

Release로 바꾸고, 메뉴에서 빌드 > 솔루션 빌드를 실행한 이후

INSTALL 프로젝트에서 빌드를 수행합니다.

Release 모드의 빌드

OpenCV 라이브러리 빌드가 완료되면 C:/opencv/build/install 디렉터리의 구조입니다.

C:/opencv/build/install/include 폴더아래는 모든 헤더 파일들이

C:/opencv/build/install/x64/vc16 아래에는 *. dll과 *.lib 파일이 있습니다.

vc16은 Microsoft Visual Studio 2019 버전용입니다.

*.lib 파일은 OpenCV 응용 프로그램을 개발할 때 사용하고

*.dll 파일은 OpenCV 응용 프로그램을 실행할 때 사용합니다.

 

 

 

OpenCV DLL 파일은 공통으로 사용하기 때문에 시스템 환경 변수 Path에 추가하는 것을 추천드립니다.

 

환경변수에  OpenCV  추가하기

키보드의 windows 로그 + S를 선택하면 검색창이 뜹니다.

검색창에서 "시스템 환경 변수 편집"을 입력하면 시스템 속성 창이 뜹니다.

 

시스템 속성 > 고급 탭 > 환경변수 > 새로 만들기 선택

변수 이름에 OPENCV_DIR 입력

변수 값에 C:\opencv\build\install 입력 후

확인을 선택하면 사용자 변수에 추가되는 것을 확인하실 수 있습니다.

 

 

path 환경변수에  C:\opencv\build\install\x64\vc16\bin위치를 추가합니다.

위에서 추가한 변수이름 OPEN_DIR을 사용하여 등록했습니다.

 

키보드의 windows 로그 + R 눌러 실행창을 띄웁니다.

opencv_version.exe를 입력하고 엔터를 치면 결과 문자열이 출력됩니다.

opencv_version.exe 프로그램은 openCV DLL 폴더 위치에 있는 실행파일이기 때문에

해당 파일이 실행되면 설정 적용이 잘 되었다고 판단하실 수 있습니다.

만약 " opencv_version.exe을 찾을 수 없습니다."라는 에러 메시지가 나오면

시스템 환경 변수 path 입력 값을 재확인하셔야 합니다.

 

이상으로 OpenCV 소스 코드를 다운로드하여서

Visual Studio에서 OpenCV를 빌드하고 설치하는 것까지 확인하였습니다.

도움이 되셨기를 바랍니다.