Visual Studio 2019에 OpenCV 설치하기_Windows 10_OpenCV 4.3

1. 개요

Visual Studio 2019에서 C++ 언어 기반의 프로젝트에서 OpenCV 라이브러리를 이용하는 경우

OpenCV 라이브러리를 직접 다운로드하고 Path 설정을 해줘야 합니다.

처음 OpenCV를 설치하시는 분들을 위하여 포스팅을 하며,

차근차근 따라한다면 OpenCV를 Visual Studio 2019에서 C or C++ 언어 기반의 프로젝트에서

사용하실 수 있습니다.

 

2020년 7월 4일을 기준으로 포스팅을 작성하며,

Windows 10의 Visual Studio 2019를 기준으로 포스팅을 작성하였습니다.

포스팅 기준의 OpenCV 버전은 4.3입니다.

 

 

 

2. OpenCV 4.3 다운로드

먼저 OpenCV 4.3을 다운로드하기 위해서 아래의 사이트에 접속합니다.

https://opencv.org/

OpenCV

 

 

OpenCV 홈페이지에서 Release 항목으로 들어갑니다.

 

 

OpenCV - 4.3.0 파트의 Windows 항목을 누르면 OpenCV 4.3.0 버전이 자동으로 다운로드됩니다.

 

 

다운로드가 완료되면 opencv-4.3.0-vc14_vc15를 실행시킵니다.

 

*여기서 vc14와 vc15가 의미하는 것은 Visual Studio의 버전을 의미합니다.

https://stackoverflow.com/questions/31188859/what-is-the-difference-between-vc10-vc11-and-vc12-libraries-in-opencv

What is the difference between vc10, vc11 and vc12 libraries in OpenCV?

 

 

 

3. OpenCV 설치

다운로드한 opencv-4.3.0-vc14-vc15 파일을 실행시키면, 압축을 풀 장소를 선택하게 됩니다.

저는 C 드라이브에 설치를 하였고, 이 포스팅의 기준은 C 폴더에 설치된 OpenCV를 기준으로 합니다.

디렉터리를 위와 같이 설정하고 Extract 버튼을 누릅니다.

 

 

설정한 디렉터리에 압축이 풀리게 됩니다.

압축이 전부 풀리게 되면, 자동으로 프로그램이 종료됩니다.

 

 

위와 같이 C:\opencv 폴더가 생성되었다면, 설치가 성공적으로 완료된 것입니다.

 

 

 

4. VisualStudio 2019 프로젝트 생성

Visual Studio 2019를 실행시키고, 새 프로젝트 만들기로 새 프로젝트를 만들어줍니다.

 

 

본 포스팅은 C++을 이용하여 OpenCV 라이브러리 연동을 테스트할 것입니다.

빈 프로젝트를 선택하고 다음 버튼을 눌러줍니다.

 

 

프로젝트 이름을 정해주고, 만들기 버튼을 누릅니다.

이번 포스팅에서 사용될 프로젝트 이름은 OpenCVTest입니다.

 

 

프로젝트가 생성되면 소스 파일 > 추가 > 새 항목에 들어가 main.cpp 파일을 생성해줍니다.

https://heisanbug.tistory.com/12?category=330394

Visual Studio 2019 프로젝트 생성하기_C_C++

 

 

5. OpenCV 라이브러리 연동

솔루션 플랫폼을 x86에서 x64로 변경시킵니다.

OpenCV 4.3.0 window 버전에는 x86은 지원하지 않고 있습니다.

* x86으로 빌드하려면, OpenCV 파일을 직접 빌드하여야 합니다.

 

 

프로젝트의 속성에 들어가기 위해, 디버그 > OpenCVTest 속성... 에 들어갑니다.

 

 

속성 페이지의 구성이 모든 구성이고, 플랫폼이 x64가 맞는지 확인합니다.

 

 

속성의 C/C++ 항목에서 추가 포함 디렉터리에 

C:\opencv\build\include 를 추가하고, 확인과 적용 버튼을 눌러줍니다.

이 과정은 OpenCV의 헤더 파일의 디렉터리를 등록하는 과정입니다.

 

 

속성의 링커 항목에서 추가 라이브러리 디렉터리에

C:\opencv\build\x64\vc15\lib 를 추가하고, 확인과 적용 버튼을 눌러줍니다.

이 과정은 OpenCV의 라이브러리 디렉터리를 등록하는 과정입니다.

 

 

속성의 디버깅 항목에서 환경에

C:\opencv\build\64\vc15\liPATH=C:\opencv\build\x64\vc15\bin;%PATH%PATH=C:\opencv\build\x64\vc15\bin;%PATH% 를 추가하고, 

확인과 적용 버튼을 눌러줍니다.

이 과정은 OpenCV의 DLL 디렉터리를 등록하는 과정입니다.

 

 

구성을 Debug로 변경하고, 속성의 입력 항목에서 추가 종속성에

opencv_world430d.lib 를 추가하고, 

확인과 적용 버튼을 눌러줍니다.

이 과정은 OpenCV의 디버깅용 라이브러리를 등록하는 과정입니다.

 

 

구성을 Release로 변경하고, 속성의 입력 항목에서 추가 종속성에

opencv_world430.lib 를 추가하고, 

확인과 적용 버튼을 눌러줍니다.

이 과정은 OpenCV의 릴리즈용 라이브러리를 등록하는 과정입니다.

 

 

위의 과정을 모두 완료하면, OpenCV 라이브러리를 사용할 준비가 완료되었습니다.

 

 

 

6. OpenCV 테스트 프로그램 Hello World 

이제 테스트 프로그램을 실행시켜봅니다.

여러 가지 Hello World 프로그램이 있지만, 제가 정상 동작에 테스트하는 코드를 공유합니다.

/*********************************************************
				Heisanbug OpenCV Test
				2020.07.04
				Hello World
				Alta software developer
**********************************************************/

//opencv header file include
#include "opencv2/opencv.hpp"
#include "opencv2/highgui/highgui.hpp"
#include "opencv2/core/types_c.h"


//project main function
int main(int argc, char** argv) {

	//create image window
	cv::namedWindow("image", 1);

	//create test Mat, 400 x 400
	cv::Mat testMat = cv::Mat::zeros(200, 850, CV_8UC3);

	//write text
	cv::putText(testMat, "HELLO WORLD!! HEISANBUG", cvPoint(100, 100),
		cv::FONT_HERSHEY_PLAIN , 3, cvScalar(0, 255, 255), 4);

	//show image
	cv::imshow("image", testMat);
	cv::waitKey(0);

	//close all windows
	cv::destroyAllWindows();

	return 0;
}

 

 

본 코드를 입력하고 Ctrl + F5를 눌러 테스트를 진행합니다.

 

 

위와 같은 이미지 윈도우가 나타나면, 정상적으로 OpenCV 사용이 가능하게 환경설정이 완료된 것입니다.

 

 

 

7. 기타

제가 학부생 때 처음 OpenCV를 설치하고 연동하는데 걸린 시간은 하루였습니다...

혹시 어려움을 겪고 계신 분들이 있다면 댓글로 문의주세요!!

최대한 빠르게 도와드리도록 하겠습니다.

 

오류나 문의사항도 댓글 남겨주시면 감사하겠습니다.

 

 

 

X. 참고

https://webnautes.tistory.com/1132

https://yyman.tistory.com/1330

https://opencv.org/