opencv环境配置
感谢大家学习这门教程。本系列文章首发于公众号【周旋机器视觉】。
这个这门课程的第一篇文章,主要是opencv环境配置。
本教程的环境为
- Visual Studio 2019
- CMake 3.22.3
- opencv 4.6.0
- windows 10
1、opencv的源码下载与安装
直接访问opencv官网:https://opencv.org/
点击release进入进入发布页面,选择4.6.0版本:
- Docs:opencv-4.6.0官方文档
- Sources:opencv源码
- GitHub:官方github网址
- Windows:Windows平台下的安装包
- Release Notes:4.6.0版本发布说明
这几个按钮都非常明确,本教程我们需要用到的就是Docs、Windows这两项。
1.1 opencv官方文档
本课程主要看的就只有文档首页导航页的前两项,在我们课程开始会先带大家学习这两部分的官方文档部分。
1.2opencv环境搭建
在开始直接编译源码之前,我们先基于opencv的安装包来给VS配置opencv环境。点击上方页面中的windows,会直接进入下载页面下载一个exe
这exe其实就是一个解压缩执行程序,下载完成后直接执行,选择一个路径,则会将构建好的opencv以及源码解压缩到该目录:
其中sources就是opencv的源码,build就是官方给的构建好的opencv库。
我们可以自己手动构建opencv的源码,然后编译源码工程来生成opencv动态库和静态库,生成的产物就是build;也可以直接在我们项目中使用官方构建好的opencv库。在链接opencv库这个步骤上两个是没有差异的,无非就是一个官方给的dll,一个是自己手动编译的dll。
但我们自己手动构建opencv源码,可以方便的查看阅读opencv的源码工程,可以在不同文件、不同函数实现之间任意切换,编译生的debug版本的dll,还可以调试。
1)配置系统环境变量
进入高级系统设置->环境变量->用户变量(或系统变量)->添加opencv的库路径。
2)VS链接opencv库(手动配置法)
直接创建一个演示用的VS控制台应用程序。
要想链接opencv库,需要对项目的属性进行配置。进行配置的本质其实就是VS把一些可选项给你通过GUI的方式展示了出来,并赋予了默认值,你来修改一些选项来完成你自己项目工程的编译、链接、生成等过程的配置。所有的工作都由VS来帮你完成了。
而这些工作我们同样可以通过cmake来完成,后面我们会介绍如何使用cmake来管理你的项目并链接opencv库。
我们打开项目的属性进行如下配置:
配置库的include包含目录,路径见截图。这一步是将opencv的include路径配置进你项目的包含路径内,opencv的include文件夹内都是.hpp头文件。
完成这一步,你其实就可以在你的项目中使用
#include "opencv2/opencv.hpp"
来包含opencv的头文件,并编写opencv的代码了:
#include <iostream>
#include "opencv2/opencv.hpp"
int main()
{
cv::Mat srcImage = cv::imread("Laner.png");
if (srcImage.empty())
{
std::cout << "image read Error!\n";
return -1;
}
cv::imshow("src", srcImage);
cv::waitKey();
return 0;
}
这代表这你当前可以编译通过了,但是现在你并不能完成链接操作,执行该项目会报错,这些错误就是链接错误,无法链接到opencv库:
所以我们还需要链接opencv的静态库:
上图配置了lib静态库的路径。然后还需配置lib静态库名称,来告诉vs链接该路径下的哪个lib库,让我们先看一下该路径下都有什么:
可以看到一共只有两个lib库,其余的为cmake文件,后面我们使用cmake来管理项目并链接opencv库的时候会讲到。
两个lib库,以d结尾的为debug版本,没有d的opencv_world460.lib为release版本的静态库,因为我们前面截图的配置选项一直都是release x64,因此我们选择opencv_world460.lib库:
当你配置debug x64属性的时候,链接opencv_world460d.lib即可。
如果你按照我前面的步骤:
- 下载opencv库
- 配置库的系统路径
- 添加opencv库的include头文件包含路径
- 添加opencv静态链接库完成链接
那你运行你的程序应该是可以成功的。
不过在我电脑上却没有运行成功,如下图,因为我并没有配置库的系统路径。
这就可以凸显一个东西:opencv的动态链接库。
opencv为动态链接库,虽然我们通过头文件包含目录以及lib静态库完成了编译、链接的操作,但当我们程序运行时,程序还是通过动态库来调用opencv的,那我们配置系统环境变量,其实就是把opencv的bin目录,也就是opencv的动态库路径打入了环境变量:
当我们的程序运行时,它会在可执行文件目录同级目录内查找需要的动态库,如果没有找到,则去系统环境变量里的路径内查找动态库,如果还没有找到,就会报如上找不到opencv_world460.dll动态库的弹窗错误。
所以解决办法也很简单,有两种:
- 配置opencv的动态库系统环境变量
- 或者是将动态库拷贝到可执行文件的目录
我们采用方法2,将dll拷贝到exe路径。再次运行我们的测试程序:
运行成功。