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->编辑->新建

新建如下环境变量：

E:\Technology\Qt5.12.8\5.12.8\mingw73_64\bin

E:\Technology\Qt5.12.8\Tools\mingw730_64\bin

E:\Technology\CMake\bin

五、编译OpenCV

（1）创建 opencv-build 目录

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

D:\opencv\opencv\opencv-build

（2）运行 cmake-gui.exe

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

# 源码目录

E:/Technology/OpenCV/opencv/sources

# 编译产生二进制的目录

E:/Technology/OpenCV/opencv/opencv-build

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

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

# gcc工具路径

E:/Technology/Qt5.12.8/Tools/mingw730_64/bin/gcc.exe

# g++工具路径

E:/Technology/Qt5.12.8/Tools/mingw730_64/bin/g++.exe

（3）编译报错1，解决报错

再次点击 Configure 按钮正式编译之后，会报错：

出现的错误信息是：

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.

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.

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 的完整路径，我这里是：

# mingw32-make.exe的完整路径

E:\Technology\Qt5.12.8\Tools\mingw730_64\bin\mingw32-make.exe

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

（4）编译报错2，解决报错

再次点击 Configure 按钮编译，没出现上面那个错误了：

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

重点报错内容是这段：

CMake Warning at cmake/OpenCVDownload.cmake:248 (message):

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，输入：

mingw32-make -j 8

执行效果如下：

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

mingw32-make install

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

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

七、创建QT工程测试验证

（1）创建OpenCV_Test工程

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

（2）测试代码

OpenCV_Test.pro

QT += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

CONFIG += c++11

# The following define makes your compiler emit warnings if you use

# any Qt feature that has been marked deprecated (the exact warnings

# depend on your compiler). Please consult the documentation of the

# deprecated API in order to know how to port your code away from it.

DEFINES += QT_DEPRECATED_WARNINGS

# You can also make your code fail to compile if it uses deprecated APIs.

# In order to do so, uncomment the following line.

# You can also select to disable deprecated APIs only up to a certain version of Qt.

#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000 # disables all the APIs deprecated before Qt 6.0.0

SOURCES += \

main.cpp \

Widget.cpp

HEADERS += \

Widget.h

#很重要：主要添加这两行，指定头文件路径和库路径

INCLUDEPATH += E:\Technology\OpenCV\opencv\opencv-build\install\include

LIBS += E:\Technology\OpenCV\opencv\opencv-build\install\x64\mingw\lib\libopencv_*.a

# Default rules for deployment.

qnx: target.path = /tmp/$${TARGET}/bin

else: unix:!android: target.path = /opt/$${TARGET}/bin

!isEmpty(target.path): INSTALLS += target

Widget.h

#ifndef WIDGET_H

#define WIDGET_H

#include

class Widget : public QWidget

{

Q_OBJECT

public:

Widget(QWidget *parent = nullptr);

~Widget();

};

#endif // WIDGET_H

Widget.cpp

#include "Widget.h"

// 添加相关投文件和包

#include

#include

#include

using namespace cv;

Widget::Widget(QWidget *parent)

: QWidget(parent)

{

// 一定要使用绝对路径找到图片的正确为止，其他可以回报错

Mat image=imread("E:\\Learn\\Qt\\OpenCV_Qt\\OpenCV_Test\\demo1.jpg",1);

namedWindow( "Display", WINDOW_AUTOSIZE );

imshow( "Display window", image );

}

Widget::~Widget()

{

}

main.cpp

#include "Widget.h"

#include

int main(int argc, char *argv[])

{

QApplication a(argc, argv);

Widget w;

w.show();

return a.exec();

}

（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...如何解决？