OpenCV学习（1）：Qt5.12配置OpenCV4.6教程

一、OpenCV介绍

OpenCV（Open Source Computer Vision Library）是一个开源的计算机视觉库，广泛应用于图像处理、视频分析、特征检测、机器学习等领域。
特点

• 跨平台支持：支持 Windows、Linux、macOS、Android 和 iOS 等多种操作系统。
  
• 多语言接口：提供 C++、Python、Java 和 MATLAB 等多种语言的接口。
  
• 丰富的功能：包含超过 2500 个优化的算法，涵盖图像处理、视频分析、机器学习等多个领域。
  
• 高效性：核心功能经过高度优化，适合实时应用。
  
• 社区支持：拥有活跃的开发者社区，提供丰富的文档和教程。
  

应用场景

• 计算机视觉：目标检测、人脸识别、姿态估计等。
  
• 视频分析：运动检测、行为识别、光流计算等。
  
• 机器学习：支持KNN、SVM、决策树等算法。
  
• 医学影像处理：图像分割、特征提取、辅助诊断。
  
• 自动驾驶：车道检测、交通标志识别、障碍物检测。
  
• 工业检测：缺陷检测、产品分类、机器视觉。
  

二、OpenCV下载

通过官网地址下载：https://opencv.org/releases/
这里选择 OpenCV-4.6.0 版本的 Windows 版本下载：

至于 Qt5.12 和 CMake-3.20.0 的下载安装，这里不再赘述，可以参考我以前的博客：

• Qt快速入门之二：Qt Creator简介
  
• Windows下使用CMake编译SuiteSparse成VS工程
  

三、OpenCV安装

双击 opencv-4.6.0-vc14_vc15.exe 安装包进行安装，设置的安装路径最好和 Qt 安装在同一个盘符，点击 Extract 按钮进行安装：

安装好后的 OpenCV 目录如下：

四、配置系统环境变量

系统设置->高级->环境变量->选中Path->编辑->新建
新建如下环境变量：

1. E:\Technology\Qt5.12.8\5.12.8\mingw73_64\bin
2. E:\Technology\Qt5.12.8\Tools\mingw730_64\bin
3. E:\Technology\CMake\bin

复制代码

五、编译OpenCV

（1）创建 opencv-build 目录
在 OpenCV 安装目录下创建 opencv-build 目录：

1. D:\opencv\opencv\opencv-build

复制代码

（2）运行 cmake-gui.exe
双击 cmake-gui.exe 运行，分别配置 OpenCV 的源码目录和编译产生二进制的目录路径，如下所示，然后点击 Configure 进行配置：

1. # 源码目录
2. E:/Technology/OpenCV/opencv/sources
3. # 编译产生二进制的目录
4. E:/Technology/OpenCV/opencv/opencv-build

复制代码

选择 MinGW Makefiles，点击 Specify native compilers，再点击 next 按钮：

选择 gcc 和 g++ 工具路径，然后点击 Finish 按钮：

1. # gcc工具路径
2. E:/Technology/Qt5.12.8/Tools/mingw730_64/bin/gcc.exe
3. # g++工具路径
4. E:/Technology/Qt5.12.8/Tools/mingw730_64/bin/g++.exe

复制代码

（3）编译报错1，解决报错
再次点击 Configure 按钮正式编译之后，会报错：

出现的错误信息是：

1. CMake Error: CMake was unable to find a build program corresponding to "MinGW Makefiles".  CMAKE_MAKE_PROGRAM is not set.  You probably need to select a different build tool.
2. CMake Error: CMake was unable to find a build program corresponding to "MinGW Makefiles".  CMAKE_MAKE_PROGRAM is not set.  You probably need to select a different build tool.
3. Configuring incomplete, errors occurred!

复制代码

问题分析
这个错误通常是由于 CMake 无法找到正确的构建工具（如 MinGW 的 make 工具）造成的。CMake 需要一个构建程序（通常是 make 或 mingw32-make ）来编译  OpenCV。在你的环境中，CMake 无法识别 MinGW 工具链，导致无法生成适用于 MinGW 的 Makefile。
如果 CMake 找不到合适的构建工具，后续的编译过程将无法进行，导致 OpenCV 编译失败。因此，解决这个问题需要确保 MinGW 工具链正确配置，并且 CMake 能够正确识别并使用它。
问题解决方案
手动设置 CMake 的构建工具 ：在 CMake 界面上，点击 Advanced ，然后在 CMake_MAKE_PROGRAM 选项中手动输入 mingw32-make 的完整路径，我这里是：

1. # mingw32-make.exe的完整路径
2. E:\Technology\Qt5.12.8\Tools\mingw730_64\bin\mingw32-make.exe

复制代码

这样 CMake 就可以知道使用哪个工具来构建项目，解决了这个报错。

（4）编译报错2，解决报错
再次点击 Configure 按钮编译，没出现上面那个错误了：

但是等待较长一段时间后，编译完成又报错：

重点报错内容是这段：

1. CMake Warning at cmake/OpenCVDownload.cmake:248 (message):
2.   ADE: Download failed: 35;"SSL connect error"

复制代码

提示 ADE 模块下载失败，SSL 连接错误。怀疑是网络问题导致远程下载失败，这边使用魔法解决了，没有魔法的看能不能尝试更改 DNS 解决。
再次点击 Configure 按钮编译，没出现上面那个错误了：

上面图片中的红框可以看到，使用魔法后，ADE 模块开始正常下载了。

（5）编译报错3，解决报错
等待编译完成后，界面如下所示：

有几行红的，需要再配置下。下拉将 WITH_OPENGL 和 WITH_QT 选中，另外不勾选 BUILD_PROTOBUF；同时然后点击 add Entry 按钮，配置 OPENCV_VS_VERSIONINFO_SKIP=1（界面按钮具体操作：add Entry -> Name:OPENCV_VS_VERSIONINFO_SKIP -> Type:Bool->Value 打钩)，如下：

（6）编译报错4，解决报错
照上面那样配置后， 再次点击 Configure 按钮，如果仍旧会出现一些红色配置项，确认 OPENCV_VS_VERSION_SKIP 是勾选的和 BUILD_PROTOBUF 是不勾选的，如果没有， 通过（界面按钮具体操作：add Entry -> Name:OPENCV_VS_VERSIONINFO_SKIP -> Type:Bool->Value 打钩）再次配置下。
这里等待一段时间后，仍旧会出现一些红色配置项：

照上面那样确认选项和配置了。再次点击 Configure 按钮，红色消失，再直接点击 Generate 按钮即可成功编译生成：

到这一步，就说明编译完成了。
六、Powershell命令安装OpenCV

关闭 Cmake GUI 界面， 然后进入 OpenCV 安装目录，鼠标选中  opencv-build 目录，按住 shift 键，同时点击鼠标右键，点击在此处打开 Powershell 窗口(s)的右键菜单选项，进入 Windows Powershell，输入：

1. mingw32-make -j 8

复制代码

执行效果如下：

按回车键执行该命令，100% 完成之后，输入：

1. mingw32-make install

复制代码

完成之后退出，另外再将如下路径按照前述方式加入环境变量即可：

1. E:\Technology\OpenCV\opencv\opencv-build\install\x64\mingw\bin

复制代码

七、创建QT工程测试验证

（1）创建OpenCV_Test工程
基于 QWidegt 方式创建，不勾选 ui 选项，创建完的工程目录如下：

（2）测试代码
OpenCV_Test.pro

1. QT       += core gui
3. greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
5. CONFIG += c++11
7. # The following define makes your compiler emit warnings if you use
8. # any Qt feature that has been marked deprecated (the exact warnings
9. # depend on your compiler). Please consult the documentation of the
10. # deprecated API in order to know how to port your code away from it.
11. DEFINES += QT_DEPRECATED_WARNINGS
13. # You can also make your code fail to compile if it uses deprecated APIs.
14. # In order to do so, uncomment the following line.
15. # You can also select to disable deprecated APIs only up to a certain version of Qt.
16. #DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0
18. SOURCES += \
19.     main.cpp \
20.     Widget.cpp
22. HEADERS += \
23.     Widget.h
25. #很重要：主要添加这两行，指定头文件路径和库路径
26. INCLUDEPATH += E:\Technology\OpenCV\opencv\opencv-build\install\include
27. LIBS += E:\Technology\OpenCV\opencv\opencv-build\install\x64\mingw\lib\libopencv_*.a
29. # Default rules for deployment.
30. qnx: target.path = /tmp/$${TARGET}/bin
31. else: unix:!android: target.path = /opt/$${TARGET}/bin
32. !isEmpty(target.path): INSTALLS += target

复制代码

Widget.h

1. #ifndef WIDGET_H
2. #define WIDGET_H
4. #include <QWidget>
6. class Widget : public QWidget
7. {
8.     Q_OBJECT
10. public:
11.     Widget(QWidget *parent = nullptr);
12.     ~Widget();
13. };
14. #endif // WIDGET_H

复制代码

Widget.cpp

1. #include "Widget.h"
3. // 添加相关投文件和包
4. #include <opencv2/core/core.hpp>
5. #include <opencv2/highgui/highgui.hpp>
6. #include <opencv2/imgproc/imgproc.hpp>
7. using namespace cv;
9. Widget::Widget(QWidget *parent)
10.     : QWidget(parent)
11. {
12.     // 一定要使用绝对路径找到图片的正确为止，其他可以回报错
13.     Mat image=imread("E:\\Learn\\Qt\\OpenCV_Qt\\OpenCV_Test\\demo1.jpg",1);
14.     namedWindow( "Display", WINDOW_AUTOSIZE );
15.     imshow( "Display window", image );
16. }
18. Widget::~Widget()
19. {
20. }

复制代码

main.cpp

1. #include "Widget.h"
3. #include <QApplication>
5. int main(int argc, char *argv[])
6. {
7.     QApplication a(argc, argv);
8.     Widget w;
9.     w.show();
10.     return a.exec();
11. }

复制代码

（3）运行报错，解决报错
一开始直接运行报错：程序异常结束，并 crashed。
原因：

• 项目那里默认勾选了影子创建（Shadow build）
  

解决方案：

• 去除影子创建，然后程序还是会异常结束，我这边是把 Qt Creator 关闭，将原先的 build 目录删除，再重新打开 Qt Creator，编译运行才正常。（另外，最好使用 Release 方式运行）
  

（4）运行结果
运行有 3 个可执行文件，如下图所示：

参考：
CMake Error: CMake was unable to find a build program corresponding to “MinGW Makefiles“.解决方案（亲测有效）-CSDN博客
使用CMAKE工具MinGW编译OPENCV报错：CMake Error: CMake was unable to find a build program...如何解决？


来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！