OpenCV 설치는 크게 세 단계로 나누어 진행됩니다.
- 필요한 소프트웨어를 모두 다운로드하고 설치하기
- Visual Studio에서 OpenCV를 사용할 수 있도록 준비하기
- Visual Studio와 OpenCV 연동하기
지금부터 각 단계를 하나씩 자세히 살펴보겠습니다.
1단계 - 필요한 소프트웨어 다운로드 및 설치
Microsoft Visual Studio 환경에서 OpenCV를 사용할 것이므로, 먼저 Visual Studio와 OpenCV를 다운로드해야 합니다.
- Visual Studio
- OpenCV
- CMake
각 소프트웨어의 설치 방법을 순서대로 알아보겠습니다.
Visual Studio 설치하기
가장 먼저 공식 웹사이트(https://visualstudio.microsoft.com/downloads/)에 접속하여 시스템에 맞는 Visual Studio를 다운로드합니다.
다운로드 버튼을 클릭해 Visual Studio를 내려받고 설치를 완료합니다. 설치가 끝나면 다음으로 OpenCV를 다운로드합니다.
OpenCV 설치하기
OpenCV 공식 웹사이트(https://opencv.org/)에 접속하여 최신 버전을 다운로드합니다.
다운로드 버튼을 눌러 OpenCV 파일을 받습니다.
다운로드가 완료되면 실행 파일을 열고 C 드라이브에 압축을 해제합니다. 아래 그림을 참고하면 이해하는 데 도움이 됩니다.
압축 해제가 끝나면 'build'와 'sources'라는 두 개의 폴더가 생성된 것을 확인할 수 있습니다. 'sources' 폴더에는 모든 모듈, 헤더 디렉터리, 예제 코드 등이 들어 있으며, 'build' 폴더에는 컴파일된 바이너리 파일들이 포함되어 있습니다.
CMake 설치하기
CMake는 오픈소스 빌드 도구로, 소프트웨어 시스템의 컴파일 과정을 관리하는 데 사용됩니다. CMake를 활용하면 플랫폼에 종속되지 않는 설정 파일을 생성할 수 있어 다양한 운영체제에서 손쉽게 빌드 작업을 수행할 수 있습니다.
CMake 공식 웹사이트(https://cmake.org/download/)에 접속하여 프로그램을 다운로드합니다.
다운로드 버튼을 클릭해 CMake를 내려받습니다.
다운로드가 완료되면 C 드라이브에 압축을 해제합니다. 아래 그림은 CMake의 압축 해제 과정을 보여줍니다.
2단계 - Visual Studio에서 OpenCV 사용 준비하기
이 과정을 효율적으로 완료하려면 다음 단계들을 차례대로 수행해야 합니다.
C++ 데스크톱 개발 워크로드 설치하기
먼저 Visual Studio Installer를 실행한 뒤, 현재 사용 중인 Visual Studio IDE 버전에 'C++을 사용한 데스크톱 개발' 워크로드를 추가합니다.
환경 변수 설정하기
다음 단계는 환경 변수를 설정하는 것입니다. 환경 변수를 올바르게 설정하지 않으면 OpenCV가 정상적으로 실행되지 않으므로 주의해야 합니다. 환경 변수는 아래 순서대로 설정합니다.
- '내 PC(This PC)'를 마우스 오른쪽 버튼으로 클릭한 후 '속성'을 선택하고, '고급 시스템 설정'을 누릅니다. 그러면 새 창이 열립니다.
- 새 창에서 '환경 변수'를 클릭합니다. 또 다른 창이 열리면 '시스템 변수' 목록에서 스크롤바를 내려 'Path' 항목을 찾아 선택합니다.
- '편집(Edit)' 버튼을 클릭하면 새 창이 열립니다.
- '변수 값' 입력란에 OpenCV의 'build' 폴더 안에 있는 'bin' 폴더 내부의 디버그(debug) 및 릴리즈(release) 폴더 경로를 입력한 뒤, 확인 버튼을 눌러 모든 변경 사항을 저장합니다.
3단계 - Microsoft Visual Studio와 OpenCV 연동하기
Visual Studio 2019에서 프로젝트 만들기
이 단계에서는 새 프로젝트를 생성하고 'C++ 콘솔 앱(Console App)' 템플릿을 선택합니다.
프로젝트가 생성되면 '소스 파일(Source Files)'로 이동합니다. 메뉴가 열리면 새 항목 추가를 위해 마우스 오른쪽 버튼을 클릭하고, 새 창이 열리기를 기다립니다.
여기서 새 CPP 파일을 생성한 뒤 '추가(Add)' 버튼을 클릭합니다.
코딩 인터페이스가 나타나면 이곳에서 바로 C++ 코드를 작성할 수 있습니다.
OpenCV 연동하기
프로젝트에 OpenCV를 연동하려면 다음 단계를 따릅니다.
- 프로젝트를 마우스 오른쪽 버튼으로 클릭한 뒤 메뉴에서 '속성(Properties)'을 선택합니다. 새 창이 열립니다.
- 상단 구성(Configuration)을 '모든 구성(All Configurations)'으로 변경하고, 운영체제에 맞는 플랫폼(32비트는 win32, 64비트는 x64)을 선택합니다.
- 'C/C++' 항목의 드롭다운 화살표를 클릭하여 '일반(General)'으로 이동합니다. 오른쪽 화면에서 '추가 포함 디렉터리(Additional Include Directories)'를 찾아 OpenCV의 include 폴더 경로를 입력하고 Enter 키를 누릅니다.
- OpenCV를 C 드라이브에 설치했다면 include 폴더의 경로는
C:\opencv\build\include입니다. 다른 위치에 설치했다면 OpenCV build 폴더 안에서 include 폴더를 찾으면 됩니다. - '적용(Apply)' 버튼을 클릭합니다.
- 이제 OpenCV 라이브러리를 추가합니다. 먼저 구성(Configuration)을 'Debug'로 선택한 뒤, '링커(Linker)' 항목의 드롭다운 화살표를 클릭합니다.
- '일반(General)'을 클릭하고, 오른쪽의 '추가 라이브러리 디렉터리(Additional Library Directories)' 입력란에 Debug 폴더 경로를 입력한 후 Enter 키를 누릅니다.
Debug 폴더는 OpenCV의 'build' 폴더 안에 있는 'lib' 폴더 내부에 위치합니다. OpenCV를 C 드라이브에 압축 해제했다면 경로는 C:\opencv\build\x64\vc15\lib입니다.
- '적용(Apply)' 버튼을 클릭한 뒤 '입력(Input)' 메뉴로 이동하여 오른쪽 화면에서 '추가 종속성(Additional Dependencies)'을 찾고 드롭다운 아이콘을 클릭합니다.
- '<편집>' 옵션을 선택하면 새 창이 열립니다.
- 확인(Ok) 버튼을 누른 후 적용(Apply) 버튼을 클릭합니다.
- 이것으로 Visual Studio IDE에서의 모든 구성 작업이 완료되었습니다.