OpenCV 환경설정 팁 - 다양한 IDE 환경에서

OpenCV는 다양한 개발 환경에서 사용할 수 있지만, 각

 IDE마다 설정 방법이 다소 다르기 때문에 초반에 조금 헷갈릴 수 있어요.

 

Visual Studio, CLion, VS Code, Qt Creator 등 대표적인 IDE별로 환경을 잡는 팁을 정리하겠습니다.

Visual Studio에서 OpenCV 설정하기

Windows 환경에서 가장 많이 쓰이는 IDE가 바로 Visual Studio죠.
OpenCV를 Visual Studio에서 쓰려면 먼저 OpenCV 공식 사이트에서

Windows용 pre-built binary를 설치해줘야 해요.

그 후, 프로젝트 속성에서 다음과 같이 설정해줘야 해요:

• C/C++ > General > Additional Include Directories: opencv\build\include
• Linker > General > Additional Library Directories: opencv\build\x64\vc15\lib
• Linker > Input > Additional Dependencies: opencv_worldXXX.lib

#include <opencv2/opencv.hpp> int main() {     cv::Mat img = cv::imread("test.jpg");     cv::imshow("Image", img);     cv::waitKey(0); }

이렇게 하면 Visual Studio에서도 문제없이 OpenCV 프로젝트를 빌드하고 실행할 수 있어요.

CLion에서 CMake로 OpenCV 연동하기

JetBrains의 CLion은 CMake 기반의 프로젝트를 주로 다루기 때문에

설정만 잘 해주면 매우 안정적으로 쓸 수 있어요.

OpenCV를 쓰려면 CMakeLists.txt에 아래 내용을 추가해줘야 해요

find_package(OpenCV REQUIRED) include_directories(${OpenCV_INCLUDE_DIRS}) target_link_libraries(MyProject ${OpenCV_LIBS})

그리고 OpenCV가 설치된 경로가 CMake에 인식되지 않으면

CMAKE_PREFIX_PATH에 OpenCV 설치 경로를 추가해줘야 해요.

CLion은 자동으로 CMake 구성을 분석하기 때문에 한 번 설정해두면 이후부터는 매우 편하게 사용할 수 있어요.
특히 콘솔이나 테스트 기반 개발에 매우 잘 어울려요.

Visual Studio Code에서 OpenCV 설정하기

VS Code는 가볍고 빠르지만, C++ 설정은 조금 손이 많이 가는 편이에요.
OpenCV를 쓰려면 먼저 tasks.json과 launch.json,

그리고 c_cpp_properties.json 파일을 잘 설정해줘야 해요.
그리고 g++ 컴파일러와 OpenCV 경로를 정확히 잡아야 정상적으로 컴파일되고 실행돼요.

"includePath": [     "${workspaceFolder}/**",     "C:/opencv/build/include" ], "compilerPath": "C:/mingw-w64/bin/g++.exe"

이런 식으로 설정하면 인텔리센스도 잘 작동하고, 디버깅도 가능해져요.
VS Code는 특히 Python과 C++ 혼합 프로젝트에 잘 어울려요.

Qt Creator에서 OpenCV 설정하기

Qt Creator는 GUI 애플리케이션 개발에 특화된 IDE지만, OpenCV와의 궁합도 아주 좋아요.
.pro 파일에 아래 내용을 추가하면 OpenCV를 쉽게 연동할 수 있어요:

INCLUDEPATH += C:/opencv/build/include LIBS += -LC:/opencv/build/x64/vc15/lib \         -lopencv_worldXXX

Qt의 QImage와 OpenCV의 cv::Mat 간 변환을 위한 유틸리티 함수도 함께 만들어두면 훨씬 유용해요.
OpenCV와 Qt를 함께 쓰면 이미지 편집 툴이나 영상 편집기 같은

고급 애플리케이션을 쉽게 만들 수 있어요.

GUI를 강조한 프로젝트라면 Qt Creator는 정말 강력한 선택이됩니다.

 

환경 설정 시 주의할 점과 팁

모든 IDE에서 공통으로 주의해야 할 점은

OpenCV 버전 일치, 32/64bit 혼동 방지, 디버그/릴리즈 모드 설정이에요.

예를 들어 디버그 모드에서는 opencv_worldXXXd.lib,

릴리즈에선 opencv_worldXXX.lib를 써야 해요.

또한 환경변수 PATH에 OpenCV의 DLL 경로를 추가해주면

실행 시 DLL을 찾지 못하는 문제를 방지할 수 있어요.

마지막으로, 여러 버전의 OpenCV를 동시에 설치했다면

CMake나 vcpkg, conda 등을 통해 정리해주는 것도 추천해요.
환경이 깨졌을 때는 clean build를 한 번 해주는 게 도움이 많이 돼요.

이 블로그의 내용을 대화 형식인 음성으로 들으면서 정리하면, 보다 쉽게 이해할 수 있을 거예요.
다운받아 들어보세요~

OpenCV 환경설정 팁 - 다양한 IDE 환경에서.mp3

4.07MB