openCV学习之路【1】---VS2015+openCV3.2.0配置教程

       本人研究生的课题是关于立体视觉和图像处理的，所以看了很多OpenCV和图像处理相关的知识与内容。为了加深自己对学习内容的印象和理解，同时也为了能给志同道合的朋友一些借鉴，故把自己所学写在博客里分享出去。

       这是一篇启程之作。介绍了opencv3.0.0和opencv3.2.0与VS2015的环境配置。

OK，开始啦！

1.下载和安装OpenCV SDK

先安装VS2015。

当前最新的OpenCV版本3.2.0的下载和安装。我们下载的exe安装文件就是一个自解压程序。

在官网：http://opencv.org/或者http://opencv.org/opencv-3-2.html上找到OpenCV3.2.0 windows版下载下来。

下载完后双击会提示解压到某个地方，推荐放到D:\Program Files\下或者D:\Program Files (x86)下，（OpenCV项目文件打包的时候，根目录就是opencv，不需要额外的新建一个名为opencv的文件夹，然后再解压）然后点击Extract按钮。

等一段时间，OpenCV3.2.0的文件就解压到了D:\Program Files (x86)下。

 其中，build里面是使用OpenCV相关的文件，我们如果只是使用OpenCV的话呢，就只用管build里面的内容。下面的sources文件夹有官方示例集，也就是samples文件夹里面的示例程序建议保留。

2.配置环境变量

 

这步的配置方法如下:

【计算机】->【（右键）属性】->【高级系统设置】->【高级（标签）】->【环境变量】->“双击”系统变量中的PATH->在变量值里面添加相应的路径。如图：

<1>

<2>

<3>

<4>

<5>

我是64位系统，添加上：

D:\Program Files (x86)\opencv\opencv3.2.0\build\x64\vc14\bin

3.工程包含（include）目录的配置

之前看过的好多博文都说“每次新建工程都要重新配置”，其实不用这样麻烦的。

首先是在Visual Studio里面新建一个控制台应用程序，最好是勾好空项目那个勾。

<1>打开visual studio，新建win32控制台项目,取个名字，比如叫test01，然后选好路径，点确定.

<2>点一次“下一步”。

<3>勾上空项目那个勾。

<4>接着在解决方案资源管理器的【源文件】处右击->添加->新建项，准备在工程中新建一个cpp源文件。

<5>选定C++源文件，取个名字，比如叫“main”，然后点【添加】，那么，一个新的cpp文件就添加到了工程中。

<6>有一招叫属性管理器。在属性管理器中进行一次配置，就相当于进行了通用的配置过程，以后新建的工程就不用再额外的进行重新配置了。

在菜单栏里面点<视图>--<属性管理器>，那么就会在visual studio中多出一个属性管理器工作区来。

<7>在新出现的“属性管理器”工作区中，点击项目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（右键属性，或者双击）即可打开属性页面。

 

<8>打开属性页面后，就是一番配置了。首先是在

【通用属性】 ->【VC++目录】 ->【包含目录】中

添加上

D:\Program Files (x86)\opencv\opencv3.2.0\build\include

D:\Program Files (x86)\opencv\opencv3.2.0\build\include\opencv

D:\Program Files (x86)\opencv\opencv3.2.0\build\include\opencv2

当然，这是之前把OpenCV解压到D:\Program Files\下的情况。实际的路径还要看你自己把OpenCV解压到了哪个目录下，根据你的实际情况来调节。

4.工程库（lib）目录的配置

其实这步和上一步差不多，属性管理器”工作区中，点击项目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反键属性，或者双击）打开属性页面。

接着上步，就是在【通用属性】 ->【VC++目录】 ->【库目录】中，

添加上D:\Program Files (x86)\opencv\opencv3.2.0\build\x64\vc14\lib这个路径。（最好复制粘贴预览里面指定的路径）

这里选择x86还是x64是一个常常令人困惑的问题。当然，对于32位操作系统，铁定就是选x86了。

如果是64位操作系统，很多童鞋会想当然自作聪明地选择x64，其实不然。正确的理解是这样的：

不管你是32位还是64位操作系统，只用管你用win32编译器还是X64编译器。

其实配置选择什么跟64位还是32位系统没有直接的关系，而是在于你在编译你的程序的时候是使用那个编译器。

编译器选的是win32，就用x86

编译器选的是X64，就用X64。不过一般情况下，都是用的win32的X86编译器。所以，无论32还是64位操作系统，配置文件最好都选择x86版的

另外，这里的vc14表示vs2015，如果是其他版本的visual studio，稍微要微调一下。

这里我们补充完整：vc8 = Visual Studio 2005，vc9 = Visual Studio 2008，vc10 = Visual Studio 2010，vc11 = Visual Studio 2012，vc12 = Visual Studio 2013。VC14=Visual Studio 2015

 

5.链接库的配置

依然是“属性管理器”工作区中，点击项目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反键属性，或者双击）即可打开属性页面。【通用属性】 ->【链接器】->【输入】->【附加的依赖项】

对于【OpenCV3.2.0】，添加如下3.2.0版本的lib（这样的lib顺序是：带d的debug版的lib写在前面，不带d的release版的lib写在后面）：

 opencv_world320d.lib

opencv_world320.lib

 

需要注意的是，所粘贴内容即为之前我们解压的OpencV目录D:\Program Files (x86)\opencv\opencv3.2.0\build\x64\vc14\lib下所有lib库文件的名字；其中的320代表我们的OpenCV版本为3.2.0，若是其他版本的配置则在这里要进行相应的更改。

Debug文件库名有d结尾，Release没有，如  opencv_world320d.lib（debug版本的lib）和 opencv_world320.lib（release版本的lib）

不过我一般是在这里把带d和不带d的统统写在这里，因为这里是以后创建所有工程时都会继承的公共属性。

其实，对已经发行和未来即将发布的新版OpenCV，只需看opencv\build\x86\vc10\lib下的库是哪几个，添加成依赖项就可以了。

另外注意：按照如上的这种方式来配置，也许会出现debug下可以运行但是release下不能运行的情况（因为字符串读取问题引起的诸如图片载入不了，报指针越界，内存错误等等），这算是OpenCV自2.4.1以来的一个bug。

解决方案：想在release模式下运行出程序结果，在工程的release模式下，将不带d的lib添加到【项目】->【属性】（注意这样打开的是当前工程的属性页，我们只需在这里将release版（即不带d）的相关lib添加进去）->【配置属性】->【链接器】->【输入】->【附加的依赖项】下即可。

类似错误如图：

 

6.在Windows文件夹下加入OpenCV动态链接库

如果配置环境变量那步配置准确，且配置之后经过重启，就没有进行这步配置的必要了。即做完上面第五步的配置，重启一次，就可以直接跳到第七步，进行测试，看能不能正确出图。

当然，如果需不重启而马上来看配置的结果，就可以试试这里的方式。

这一步是各种介绍OpenCV的配置的相关博文中都没写出来的。根据这些博文配置出来的环境，在运行基于OpenCV的程序的时候，往往会得到这样类似的结果：

 

这种问题最简单粗暴的方法，是把相关的dll都拷贝到Windows操作系统的目录下。如果你的Windows安装在C盘，那么路径就是c:\Windows\System32。按照之前我的OpenCV的存放环境，这些dll存放在

D:\Program Files (x86)\opencv\opencv3.2.0\build\x64\vc14\bin目录下。

到这个目录下，【Alt+A】全选，【Alt+C】拷贝，然后转到c:\Windows\System32下面，【Alt+V】复制，简单粗暴地就完成了。

PS:对于Windows 8，则要放在要在SysWOW64文件夹中。

 

 

恩，环境配置大功告成，我们来测试一下成果吧~

7.最终的测试

 

就用载入并显示一张图片到窗口的程序，用于我们的配置测试吧。

新建一个空项目的控制台应用程序，新建一个cpp文件，然后粘贴如下代码：

[cpp] view plain copy

1. #include<iostream>  
2. #include <opencv2/core/core.hpp>  
3. #include <opencv2/highgui/highgui.hpp>  
4.   
5.   
6. using namespace cv;  
7.   
8.   
9. int main()  
10. {  
11.     // 读入一张图片（游戏原画）  
12.     Mat img=imread("gao.jpg");  
13.     // 创建一个名为 "游戏原画"窗口  
14.     namedWindow("游戏原画");  
15.     // 在窗口中显示游戏原画  
16.     imshow("游戏原画",img);  
17.     // 等待6000 ms后窗口自动关闭  
18.     waitKey(6000);  
19. } 

放置一张名为gao.jpg的图片到工程目录中，然后点击“运行“按钮，如果配置成功，就不会报错，得到预想的运行结果：

 

7.可能遇到的问题和解决方案

 

呼，生活不可能是一帆风顺的，我们的配置过程也是。浅墨在几次的配置过程中，出现了如下的几种典型问题，我相信你可能会出现，就在这里集中列举一下吧，希望能为大家解惑：

1. 找不到core.h

出现这个问题是因为include的时候粗心大意了。

如果你的版本是2.4.6。在这个版本下，opencv根文件夹下面就有个include，但我们配置的时候如果包含的是他就坑爹了。

正确的应该填build里面的那个include。

 

2.无法解析的外部命令

这个问题其实上面有过解释了，不管你是32位还是64位操作系统，只用管你用win32编译器还是X64 编译器。

其实配置选择什么跟64位还是32位系统没有直接的关系，而是在于你在编译你的程序的时候是使用那个编译器。

编译器是win32，就用x86

编译器是X64，就用X64。不过一般情况下，都是用的win32的X86编译器。所以，

无论32还是 64位操作系统，配置文件最好都选择x86版的。

 

3.关于形如--error LNK2005:xxx 已经在 msvcrtd.lib ( MSVCR90D.dll ) 中定义

出现这个问题，把静态库不包含就行了。

 

4. 应用程序无法正常启动0xc000007b

Lib包含的问题。也许你同时包含了X86和X64的，或者包含出错错了。或者是对于windows 8 64位，dll要放在和System32文件夹同级的SysWOW64文件夹中。

5.明明图片路径是对的，却载入不进去图片，提示指针越界，有未经处理的异常

类似错误如图：

这算是opencv的一个bug，工程属性里面关于带d和不带d的lib文件的附加依赖项的问题，就算配置好了每次想debug和release下都运行还得手动在工程属性里面加。当得到这样的错误时，可以把调试方式改一改，debug和release互换：

或者打开当前工程（注意是当前工程的属性页，不是通用属性页）的属性页，debug或者release哪个报错，就把对应的带d或不带d的lib添加到【“当前”工程属性】->【链接器】->【输入】->【附加的依赖项】下即可。

关于问题五的另一种错法：图片后缀问题

昨天晚上一个学弟和大家一样在参考这篇文章配置OpenCV环境，弄了一下午一直报这个错误。最后浅墨给他看了下，发现是图片后缀的问题，在这里更新一下，以免有童鞋是因为这个问题而一直得不出结果。确保你载入的图片是和代码中imread的路径、名称、后缀是一模一样的。例如，学弟遇到的问题就是，在xp系统下面，没有显示后缀名，下了浅墨在文章末尾给出的配置参考示例程序，估计是xp系统默认会把jpg当做jpeg对待，然后他在代码中imread的是“1.jpg”，硬是报错。我给他看的时候，在文件夹选项中调出文件后缀名，发现在win7下面给大家准备的名为“1.jpg”的文件，在xp下面变成了“1.jpeg”。然后浅墨将学弟代码中的“1.jpg”改成“1.jpeg”，立马出结果。或许这就是一部分朋友们调不出结果的另一种原因吧。

-----------------------浅墨于2014年9月20日补充

6.无法打开文件“opencv_ml249d.lib”系列的错误

关于LINK : fatal error LNK1104: 无法打开文件“opencv_ml249d.lib”，在评论区和大家给浅墨发的邮件中是普遍的一个错误。

PS: jzh258fits 同学提出的一个新的解决方法是：项目->属性管理器->Debug|Win32->Microsoft.Cpp.Win32.userDirectories中的属性页面->连接器->常规里面的附加库目录中加入相应的lib文件目录。

这个错误主要是因为包含的库目录中，和包含的附加依赖项不能相互对应照成的。

也许是“opencv_ml249d.lib“多加了一个空格，成了”opencv_ml249d. lib“，就会报错。

遇到这个问题，检查三个方面：

1.检查第四步”4.工程库（lib）目录的配置“库目录中的路径是否准确。

2.检查第五步”5.链接库的配置“中“附加依赖项”的格式有没有问题，有没有多空格，版本号248,249什么的有没有问题，有没有多一个空格，少一个点什么的。

3.第二步环境变量的配置是否准确。

参考自--浅墨