【OpenCV入門教程之一】 安裝OpenCV：OpenCV 3.0、OpenCV 2.4.八、OpenCV 2.4.9 +VS 開發環境配置（轉）

本系列文章由@淺墨_毛星雲 出品，轉載請註明出處。  

 

文章連接： http://blog.csdn.net/poem_qianmo/article/details/19809337

 

做者：毛星雲（淺墨）    微博：http://weibo.com/u/1723155442

郵箱： happylifemxy@163.com

知乎：http://www.zhihu.com/people/mao-xing-yun

寫做當前博文時配套使用的OpenCV版本： 2.4.八、2.4.九、3.0

 

（ 2014年4月28更新OpenCV 2.4.9的配置。

2014年9月12更新OpenCV 3.0的配置

2014年9月12日本文第6次修訂完畢）

 

OpenCV2.4.9和2.4.8的配置幾乎同樣，惟一的區別在下文中的第五步，連接庫的配置，把對應的248改爲249便可。

OpenCV 3.0配置更是被簡化了。和2.4.八、2.4.9的區別就是下文第五步，連接庫的配置，只用添加

opencv_ts300d.lib、opencv_world300d.lib（debug版本的庫）

或opencv_ts300.lib、opencv_world300.lib（release版本的庫）便可。

 

----------------------------淺墨於2014年9月12日注

 

 

由於讀研期間的研究方向是圖像處理，因此淺墨這段時間閉門研究了不少OpenCV和圖像處理相關的知識與內容。眼看本身積累到必定的程度了，因而決定開始開設這個OpenCV系列專欄，總結本身所學，也分享知識給你們。

好了，這篇文章做爲OpenCV的啓程篇，天然少不了先系統地介紹OpenCV開發環境的配置。

淺墨先後經歷過OpenCV 2.4.6，OpenCV 2.4.7，OpenCV 2.4.8這三個版本的配置，有時候還要涉及到三個版本之間的轉換，因此仍是對OpenCV的配置有必定的理解的，但願本身的一點拙見能幫到你們。

仍是先放出待會兒的測試用圖（若是要另存爲這張圖並配合文章後面給出的代碼進行測試，注意後綴名要爲jpg，而不是jpeg或其餘）：

 

那麼，開始吧。

 

 

1.下載和安裝OpenCV SDK

 

 

VS2010不用說，確定都安裝了吧。來講說當前最新的OpenCV版本2.4.8（2014年2月24日），2.4.9 （2014年4月）的下載和安裝。與其說是安裝，不如叫解壓更加合適，由於咱們下載的exe安裝文件就是一個自解壓程序而已。

 

在官網：http://opencv.org/上找到OpenCV windows版下載下來。

 

下載完後獲得文件OpenCV 2.4.X，雙擊後會提示解壓到某個地方，推薦放到D:\Program Files\下，好比D:\Program Files，（由於OpenCV項目文件打包的時候，根目錄就是opencv，因此咱們不須要額外的新建一個名爲opencv的文件夾，而後再解壓，那是畫蛇添足的事情）而後點擊Extract按鈕。

等一段時間，OpenCV2.4.8近3個多G的文件就解壓到了D:\Program Files下。

 其中，build裏面是使用OpenCV相關的文件，咱們若是隻是使用OpenCV的話呢，就只用管build裏面的內容。下面的sources文件夾你嫌煩，你嫌佔硬盤空間，徹底能夠刪掉。可是須要注意的是，官方示例集，也就是samples文件夾裏面的示例程序，在sources文件夾裏面躺着呢，因此，若是真是要刪的話，仍是想清楚哦。

sources裏面是源代碼。能夠直接查看。如何生成sln解決方案淺墨在這篇博文中有詳細講到：

 【OpenCV入門教程之七】 玩轉OpenCV源代碼：生成OpenCV工程解決方案與OpenCV源碼編譯

 

 

2.配置環境變量

 

  

 

這步的配置方法以下:

【計算機】->【（右鍵）屬性】->【高級系統設置】->【高級（標籤）】->【環境變量】->「雙擊」系統變量中的PATH->在變量值裏面添加相應的路徑。如圖：

<1>

<2>

<3>

<4>

<5>

 

對於32位系統，就添加：

」;…… opencv\build\x86\vc10\bin」（和以前的就有有的環境變量用英文的分號「;」進行分隔）

 

而對於64位系統，能夠兩個都添加上：

」;…… opencv\build\x86\vc10\bin」

和」…… opencv\build\x64\vc10\bin」，

這樣，到時候才能夠在編譯器Win32和X64中來回切換都吃得開，遊刃有餘~

 

例如，淺墨的就是

D:\Program Files\opencv\build\x64\vc10\bin;D:\Program Files\opencv\build\x86\vc10\bin

 

 PS:有童鞋親測說64位系統也只需添加」…… opencv\build\x86\vc10\bin」便可，你們不妨一試。

 

注：變量值實際爲bin文件夾的路徑；D表示OpenCV安裝於D盤；X64表示運行系統環境位64位系統，若安裝於32位系統，應爲X86；vc10表示編譯環境爲Microsoft Visual Studio 2010；變量添加完成後最好註銷系統，纔會生效。

 

 

 

 

 

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

 

 

以前看過的好多博文都說「每次新建工程都要從新配置」，其實不用這樣麻煩的。

首先是在Visual Studio裏面新建一個控制檯應用程序，最好是勾好空項目那個勾。

（考慮到看這篇博文的童鞋不多接觸vs，那麼淺墨在這裏將過程詳細截圖出來——淺墨2014年6月11日注）

<1>打開visual studio，新建win32控制檯項目,取個名字，好比叫test1，而後選好路徑，點肯定.

<2>點一次「下一步」。

<3>勾上空項目那個勾。

<4>接着在解決方案資源管理器的【源文件】處右擊->添加->新建項，準備在工程中新建一個cpp源文件。

<5>選定C++源文件，取個名字，好比叫「main」，而後點【添加】，那麼，一個新的cpp文件就添加到了工程中。

<6>看過淺墨以前DirectX配置的相關博文的朋友們應該都知道，有一招叫屬性管理器。在屬性管理器中進行一次配置，就至關於進行了通用的配置過程，之後新建的工程就不用再額外的進行從新配置了。

在菜單欄裏面點<視圖>--<屬性管理器>，那麼就會在visual studio中多出一個屬性管理器工做區來。

 

<7>在新出現的「屬性管理器」工做區中，點擊項目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（右鍵屬性，或者雙擊）便可打開屬性頁面。

 

 

 

 

<8>打開屬性頁面後，就是一番配置了。首先是在

【通用屬性】 ->【VC++目錄】 ->【包含目錄】中

添加上

D:\Program Files\opencv\build\include

D:\Program Files\opencv\build\include\opencv

D:\Program Files\opencv\build\include\opencv2 這三個目錄。

固然，這是以前把OpenCV解壓到D:\Program Files\下的狀況。實際的路徑還要看你本身把OpenCV解壓到了哪一個目錄下，根據你的實際狀況來調節。

 

 

 

 

 

 

4.工程庫（lib）目錄的配置

 

 

其實這步和上一步差很少，屬性管理器」工做區中，點擊項目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反鍵屬性，或者雙擊）打開屬性頁面。

接着上步，就是在【通用屬性】 ->【VC++目錄】 ->【庫目錄】中，

添加上D:\Program Files\opencv\build\x86\vc10\lib這個路徑。（最好不要複製粘貼淺墨給出的路徑，而是本身去預覽裏面指定出來，這樣會準確得多）

 

（感謝小如風童鞋，以前給出的路徑D:\Program Files\opencv\build\x86\vc10\lib裏少個空格，直接複製淺墨給出的上面路徑的童鞋就會出現「沒法打開錯誤 1 error LNK1104: 沒法打開文件「opencv_calib3d248.lib」相似的錯誤」，現已更正）

——————淺墨於2014年4月3日

 

這裏選擇x86仍是x64是一個經常使人困惑的問題。固然，對於32位操做系統，鐵定就是選x86了。

若是是64位操做系統，不少童鞋會想固然自做聰明地選擇x64，其實否則。正確的理解是這樣的：

 

 

無論你是32位仍是64位操做系統，只用管你用win32編譯器仍是X64編譯器。

其實配置選擇什麼跟64位仍是32位系統沒有直接的關係，而是在於你在編譯你的程序的時候是使用那個編譯器。

 

編譯器選的是win32，就用x86

編譯器選的是X64，就用X64。不過通常狀況下，都是用的win32的X86編譯器。因此，不管32仍是64位操做系統，配置文件最好都選擇x86版的

 

另外，這裏的vc10表示vs2010，若是是其餘版本的visual studio，稍微要微調一下。

感謝JJBomb 童鞋，這裏咱們補充完整：vc8 = Visual Studio 2005，vc9 = Visual Studio 2008，vc10 = Visual Studio 2010，vc11 = Visual Studio 2012，vc12 = Visual Studio 2013。

 

 

 

 

 

5.連接庫的配置

 

 

依然是「屬性管理器」工做區中，點擊項目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反鍵屬性，或者雙擊）便可打開屬性頁面。【通用屬性】 ->【連接器】->【輸入】->【附加的依賴項】

 

對於【OpenCV2.4.8】，添加以下248版本的lib（這樣的lib順序是：19個帶d的debug版的lib寫在前面，19個不帶d的release版的lib寫在後面）：

 

 

opencv_ml248d.lib
opencv_calib3d248d.lib
opencv_contrib248d.lib
opencv_core248d.lib
opencv_features2d248d.lib
opencv_flann248d.lib
opencv_gpu248d.lib
opencv_highgui248d.lib
opencv_imgproc248d.lib
opencv_legacy248d.lib
opencv_objdetect248d.lib
opencv_ts248d.lib
opencv_video248d.lib
opencv_nonfree248d.lib
opencv_ocl248d.lib
opencv_photo248d.lib
opencv_stitching248d.lib
opencv_superres248d.lib
opencv_videostab248d.lib

opencv_objdetect248.lib
opencv_ts248.lib
opencv_video248.lib
opencv_nonfree248.lib
opencv_ocl248.lib
opencv_photo248.lib
opencv_stitching248.lib
opencv_superres248.lib
opencv_videostab248.lib
opencv_calib3d248.lib
opencv_contrib248.lib
opencv_core248.lib
opencv_features2d248.lib
opencv_flann248.lib
opencv_gpu248.lib
opencv_highgui248.lib
opencv_imgproc248.lib
opencv_legacy248.lib

opencv_ml248.lib

 

 

對於【OpenCV2.4.9】，添加以下249版本的lib（這樣的lib順序是：19個帶d的debug版的lib寫在前面，19個不帶d的release版的lib寫在後面）：

 

 

opencv_ml249d.lib
opencv_calib3d249d.lib
opencv_contrib249d.lib
opencv_core249d.lib
opencv_features2d249d.lib
opencv_flann249d.lib
opencv_gpu249d.lib
opencv_highgui249d.lib
opencv_imgproc249d.lib
opencv_legacy249d.lib
opencv_objdetect249d.lib
opencv_ts249d.lib
opencv_video249d.lib
opencv_nonfree249d.lib
opencv_ocl249d.lib
opencv_photo249d.lib
opencv_stitching249d.lib
opencv_superres249d.lib
opencv_videostab249d.lib

opencv_objdetect249.lib
opencv_ts249.lib
opencv_video249.lib
opencv_nonfree249.lib
opencv_ocl249.lib
opencv_photo249.lib
opencv_stitching249.lib
opencv_superres249.lib
opencv_videostab249.lib
opencv_calib3d249.lib
opencv_contrib249.lib
opencv_core249.lib
opencv_features2d249.lib
opencv_flann249.lib
opencv_gpu249.lib
opencv_highgui249.lib
opencv_imgproc249.lib
opencv_legacy249.lib

opencv_ml249.lib

 

 

 

 

須要注意的是，所粘貼內容即爲以前咱們解壓的OpencV目錄D:\opencv\build\x86\vc10\lib下全部lib庫文件的名字；其中的248表明咱們的OpenCV版本爲2.4.8，如果其餘版本的配置則在這裏要進行相應的更改，好比說2.4.6版的OpenCV，那麼這裏的opencv_calib3d248d.lib就要改爲opencv_calib3d246d.lib了.

Debug文件庫名有d結尾，Release沒有，如 opencv_ts248d.lib（debug版本的lib）和opencv_ts248.lib（release版本的lib）

不過我通常是在這裏把帶d和不帶d的通通寫在這裏，由於這裏是之後建立全部工程時都會繼承的公共屬性。

 

對於【OpenCV 3.0】，添加3.0版本的lib，新版的lib很是簡單。想用debug版本的庫，添加

opencv_ts300d.lib

opencv_world300d.lib 這兩個庫便可。

而想用release版本的庫，添加

opencv_ts300.lib

opencv_world300.lib便可。

 

 

其實，對已經發行和將來即將發佈的新版OpenCV，只需看opencv\build\x86\vc10\lib下的庫是哪幾個，添加成依賴項就能夠了。

 

 

 

 

另外注意：按照如上的這種方式來配置，也許會出現debug下能夠運行可是release下不能運行的狀況（由於字符串讀取問題引發的諸如圖片載入不了，報指針越界，內存錯誤等等），這算是OpenCV自2.4.1以來的一個bug。

解決方案：想在release模式下運行出程序結果，在工程的release模式下，將不帶d的lib（所有是19個）添加到【項目】->【屬性】（注意這樣打開的是當前工程的屬性頁，咱們只需在這裏將release版（即不帶d）的相關lib添加進去）->【配置屬性】->【連接器】->【輸入】->【附加的依賴項】下便可。

 

——————淺墨 2014年3月17日注&2014年6月11日更新

相似錯誤如圖：

 

 

 

 

 

6.在Windows文件夾下加入OpenCV動態連接庫

 

 

PS：通過 hellofuturecyj 同窗提醒，若是配置環境變量那步配置準確，且配置以後通過重啓，就沒有進行這步配置的必要了。即作完上面第五步的配置，重啓一次，就能夠直接跳到第七步，進行測試，看出不出圖。

固然，若是需不重啓而立刻來看配置的結果，就能夠試試這裏的方式。

——————淺墨 2014年6月16日注

 

這一步是各類介紹OpenCV的配置的相關博文中都沒寫出來的。根據這些博文配置出來的環境，在運行基於OpenCV的程序的時候，每每會獲得這樣相似的結果：

 

 

這種問題最簡單粗暴的方法，是把相關的dll都拷貝到Windows操做系統的目錄下。若是你的Windows安裝在C盤，那麼路徑就是c:\Windows\System32。按照以前個人OpenCV的存放環境，這些dll存放在

D:\Program Files\opencv\build\x86\vc10\bin目錄下。

 

到這個目錄下，【Alt+A】全選，【Alt+C】拷貝，而後轉到c:\Windows\System32下面，【Alt+V】複製，簡單粗暴地就完成了。

PS:對於Windows 8，則要放在要在SysWOW64文件夾中。

 

 

恩，環境配置大功告成，咱們來測試一下成果吧~

 

 

 

 

7.最終的測試

 

 

就用載入並顯示一張圖片到窗口的程序，用於咱們的配置測試吧。

新建一個空項目的控制檯應用程序，新建一個cpp文件，而後粘貼以下代碼：

 

#include<iostream>
#include <opencv2/core/core.hpp>
#include <opencv2/highgui/highgui.hpp>


using namespace cv;


int main()
{
    // 讀入一張圖片（遊戲原畫）
    Mat img=imread("pic.jpg");
    // 建立一個名爲 "遊戲原畫"窗口
    namedWindow("遊戲原畫");
    // 在窗口中顯示遊戲原畫
    imshow("遊戲原畫",img);
    // 等待6000 ms後窗口自動關閉
    waitKey(6000);
}

 

放置一張名爲pic.jpg的圖片到工程目錄中，而後點擊「運行「按鈕，若是配置成功，就不會報錯，獲得預想的運行結果：

 

爲了你們的考慮，仍是把工程文件發一下吧，雖然此次只有簡單的幾句代碼：

 

【OpenCV+VS2010開發環境配置 測試用例 by淺墨】下載

 

 

 

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.第二步環境變量的配置是否準確。

 

 

——————————淺墨2014年4月28日更新

 

 

 

 

好了，OpenCV的配置大概就是這些。

下篇文章見 ：）