YouTip

OpenCV (Open Source Computer Vision Library) is an open-source computer vision and machine learning software library that includes hundreds of computer vision algorithms, widely used in image processing, video analysis, object detection, face recognition, and other fields. C++ is the original development language of OpenCV, making it suitable for high-performance applications. Before using OpenCV in a C++ project, you first need to install the OpenCV library. ### Downloading OpenCV Visit the official OpenCV download page: [https://opencv.org/releases/](https://opencv.org/releases/). Choose the version suitable for your operating system (e.g., Windows, Linux, macOS) and download it, such as the pre-compiled Windows package for OpenCV 4.x. !(#) ### Installing OpenCV on Windows * **Extract the downloaded OpenCV file:** Unzip it into a directory, such as C:opencv. * **Set environment variables:** Add the OpenCV bin directory, C:opencvbuildx64vc15bin (choose vc14 or vc15 depending on your Visual Studio version), to the system's PATH environment variable. * **Configure the development environment:** If using Visual Studio, configure the OpenCV header file path and library file path in your project. Right-click "This PC" -> "Properties" -> "Advanced system settings" -> "Environment Variables" -> Edit `Path`, adding the above path. ### Configuring Visual Studio **1. Open Visual Studio and create a C++ project.** **2. Configure include directories** Right-click the project -> "Properties" -> "VC++ Directories" -> "Include Directories", add: C:opencvbuildinclude **3. Configure library directories** Right-click the project -> "Properties" -> "VC++ Directories" -> "Library Directories", add: C:opencvbuildx64vc15lib **4. Configure linker** Right-click the project -> "Properties" -> "Linker" -> "Input" -> "Additional Dependencies", add: opencv_world4xx.lib `4xx` represents the OpenCV version number, e.g., `opencv_world450.lib`. * * * ## Source Code Compilation and Installation ### Preparations Before Installation Before installing OpenCV, ensure your system has the following tools installed: * **CMake:** Used to generate build files. * **C++ compiler:** Such as GCC (Linux/macOS) or MSVC (Windows). * **Git:** Used to clone the OpenCV source code from GitHub. ### Downloading OpenCV Source Code You can download the source code from OpenCV's (https://github.com/opencv/opencv) or directly from OpenCV's (https://opencv.org/releases/) for a pre-compiled version. Use Git to clone the source code: git clone https://github.com/opencv/opencv.git git clone https://github.com/opencv/opencv_contrib.git # Optional, includes additional modules ### Using CMake to Configure OpenCV 1. Create a build directory and enter it: mkdir build cd build 2. Use CMake to generate build files: cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local .. If you need additional modules (such as `opencv_contrib`), add the following parameter: cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local -D OPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules .. 3. Compile and install OpenCV: make -j4 # Use 4 threads for compilation sudo make install ### 4. Configure environment variables (optional) On Linux or macOS, you may need to add OpenCV's library path to the environment variables: export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH On Windows, you can add OpenCV's library path via System Properties -> Advanced System Settings -> Environment Variables. * * * ## Using OpenCV in a C++ Project After installation, you can use OpenCV in your C++ project. Here is a simple example program demonstrating how to load and display an image using OpenCV. ### 1. Create a C++ Project Create a new C++ source file, such as `main.cpp`. Write the following code: ## Example #include #include int main(){ // Read an image cv::Mat image = cv::imread("example.jpg"); // Check if the image was loaded successfully if(image.empty()){ std::cout<<"Unable to load image!"<< std::endl; return-1; } // Display the image cv::imshow("Display Image", image); // Wait for a key press cv::waitKey(0); return 0; } ### 2. Compile and Run Compile the code using the following command: g++ main.cpp -o main `pkg-config --cflags --libs opencv4` ### 3. Run Run the generated executable: ./main If everything goes well, you should see the image displayed in a window. * * * ## Common Issues and Solutions ### 1. Unable to Find OpenCV Libraries If you encounter an error during compilation indicating that OpenCV libraries cannot be found, ensure that OpenCV has been properly installed and that the environment variables are configured correctly. You can use `pkg-config` to check OpenCV's installation path: pkg-config --cflags --libs opencv4 ### 2. Unable to Load Images If images fail to load, verify that the image path is correct and that the image file exists. You can use an absolute path to ensure correctness. ### 3. Window Cannot Be Displayed If the window fails to appear, confirm that your system supports graphical interfaces and that OpenCV's GUI module is properly installed.