前言:本文以OpenCV41.2 爲例子,opencv有一些函數包是以第三方的形式存在,統一在opencv_contrib-4.1.2裏面,如何將整個contrib和OpenCV本身的功能統一在一起進行編譯呢?本文是自己操作的結果,與網上的較多教程類似,編譯完成之後,怎麼使用,請參見前面的OpenCV在VS中的使用:
VS2017配置OpenCV4.1.1超詳細教程(項目配置與永久配置)(一)
一、源代碼下載以及必備軟件安裝
1.1 源代碼下載
Opencv源代碼下載:
https://opencv.org/releases/ 官網下載
https://github.com/opencv/opencv/releases GitHub下載
Opencv_contrib源代碼下載:
1.2 必備軟件安裝
安裝Cmake:
Cmake下載地址爲: https://cmake.org/download/
安裝Visual Studio 2019
安裝完成之後配置環境變量這裏不再贅述。
二、Cmake相關配置
我的源代碼解壓地址爲:
OpenCV解壓地址:D:\OpenCV_Contrib_Source\opencv4.1.2\opencv-4.1.2
裏面的類容如下:
OpenCV_contrib解壓地址:D:\OpenCV_Contrib_Source\opencv_contrib-4.1.2
裏面的類容如下:
那我要將OpenCV項目編譯到哪個地方呢?比如我編譯到下面的文件夾:
D:\Program Files\Opencv4.1.2
2.1 第一步configure
打開cmake-gui,設置如下,然後點擊configure:
第一步configure完成之後會得到如下界面:
2.2 第二步configure
再次點擊configure,上面的紅色界面會變成白色,這裏我不是特別清楚爲什麼要進行兩次,應該是第二次進行驗證的意思,若有大佬知曉,望告知,如下:
其中我們可以看一下下面產生的配置信息,到底是一些什麼內容:
...省略了前面的
General configuration for OpenCV 4.1.2 =====================================
Version control: unknown
Platform:
Timestamp: 2019-12-04T08:53:39Z
Host: Windows 10.0.18363 AMD64
CMake: 3.16.0-rc3
CMake generator: Visual Studio 16 2019
CMake build tool: D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/MSBuild/Current/Bin/MSBuild.exe
MSVC: 1923
CPU/HW features:
Baseline: SSE SSE2 SSE3
requested: SSE3
Dispatched code generation: SSE4_1 SSE4_2 FP16 AVX AVX2 AVX512_SKX
requested: SSE4_1 SSE4_2 AVX FP16 AVX2 AVX512_SKX
SSE4_1 (16 files): + SSSE3 SSE4_1
SSE4_2 (2 files): + SSSE3 SSE4_1 POPCNT SSE4_2
FP16 (1 files): + SSSE3 SSE4_1 POPCNT SSE4_2 FP16 AVX
AVX (5 files): + SSSE3 SSE4_1 POPCNT SSE4_2 AVX
AVX2 (29 files): + SSSE3 SSE4_1 POPCNT SSE4_2 FP16 FMA3 AVX AVX2
AVX512_SKX (6 files): + SSSE3 SSE4_1 POPCNT SSE4_2 FP16 FMA3 AVX AVX2 AVX_512F AVX512_COMMON AVX512_SKX
C/C++:
Built as dynamic libs?: YES
C++ Compiler: D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.23.28105/bin/Hostx64/x64/cl.exe (ver 19.23.28107.0)
C++ flags (Release): /DWIN32 /D_WINDOWS /W4 /GR /D _CRT_SECURE_NO_DEPRECATE /D _CRT_NONSTDC_NO_DEPRECATE /D _SCL_SECURE_NO_WARNINGS /Gy /bigobj /Oi /fp:precise /EHa /wd4127 /wd4251 /wd4324 /wd4275 /wd4512 /wd4589 /MP8 /MD /O2 /Ob2 /DNDEBUG
C++ flags (Debug): /DWIN32 /D_WINDOWS /W4 /GR /D _CRT_SECURE_NO_DEPRECATE /D _CRT_NONSTDC_NO_DEPRECATE /D _SCL_SECURE_NO_WARNINGS /Gy /bigobj /Oi /fp:precise /EHa /wd4127 /wd4251 /wd4324 /wd4275 /wd4512 /wd4589 /MP8 /MDd /Zi /Ob0 /Od /RTC1
C Compiler: D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.23.28105/bin/Hostx64/x64/cl.exe
C flags (Release): /DWIN32 /D_WINDOWS /W3 /D _CRT_SECURE_NO_DEPRECATE /D _CRT_NONSTDC_NO_DEPRECATE /D _SCL_SECURE_NO_WARNINGS /Gy /bigobj /Oi /fp:precise /MP8 /MD /O2 /Ob2 /DNDEBUG
C flags (Debug): /DWIN32 /D_WINDOWS /W3 /D _CRT_SECURE_NO_DEPRECATE /D _CRT_NONSTDC_NO_DEPRECATE /D _SCL_SECURE_NO_WARNINGS /Gy /bigobj /Oi /fp:precise /MP8 /MDd /Zi /Ob0 /Od /RTC1
Linker flags (Release): /machine:x64 /INCREMENTAL:NO
Linker flags (Debug): /machine:x64 /debug /INCREMENTAL
ccache: NO
Precompiled headers: YES
Extra dependencies:
3rdparty dependencies:
OpenCV modules:
To be built: calib3d core dnn features2d flann gapi highgui imgcodecs imgproc ml objdetect photo python3 stitching ts video videoio
Disabled: world
Disabled by dependency: -
Unavailable: java js python2
Applications: tests perf_tests apps
Documentation: NO
Non-free algorithms: NO
Windows RT support: NO
GUI:
Win32 UI: YES
VTK support: NO
Media I/O:
ZLib: build (ver 1.2.11)
JPEG: build-libjpeg-turbo (ver 2.0.2-62)
WEBP: build (ver encoder: 0x020e)
PNG: build (ver 1.6.37)
TIFF: build (ver 42 - 4.0.10)
JPEG 2000: build (ver 1.900.1)
OpenEXR: build (ver 2.3.0)
HDR: YES
SUNRASTER: YES
PXM: YES
PFM: YES
Video I/O:
DC1394: NO
FFMPEG: NO
avcodec: NO
avformat: NO
avutil: NO
swscale: NO
avresample: NO
GStreamer: NO
DirectShow: YES
Media Foundation: YES
DXVA: YES
Parallel framework: Concurrency
Trace: YES (with Intel ITT)
Other third-party libraries:
Intel IPP: 2019.0.0 Gold [2019.0.0]
at: D:/Program Files/Opencv4.1.2/3rdparty/ippicv/ippicv_win/icv
Intel IPP IW: sources (2019.0.0)
at: D:/Program Files/Opencv4.1.2/3rdparty/ippicv/ippicv_win/iw
Lapack: NO
Eigen: NO
Custom HAL: NO
Protobuf: build (3.5.1)
OpenCL: YES (NVD3D11)
Include path: D:/OpenCV_Contrib_Source/opencv4.1.2/opencv-4.1.2/3rdparty/include/opencl/1.2
Link libraries: Dynamic load
Python 3:
Interpreter: D:/ProgramData/Anaconda3/python.exe (ver 3.7.3)
Libraries: D:/ProgramData/Anaconda3/libs/python37.lib (ver 3.7.3)
numpy: D:/ProgramData/Anaconda3/lib/site-packages/numpy/core/include (ver 1.16.4)
install path: D:/ProgramData/Anaconda3/Lib/site-packages/cv2/python-3.7
Python (for build): D:/ProgramData/Anaconda3/python.exe
Java:
ant: NO
JNI: NO
Java wrappers: NO
Java tests: NO
Install to: D:/Program Files/Opencv4.1.2/install
-----------------------------------------------------------------
Configuring done
這實際上就是關於本地電腦、CPU以及各個不同版本的信息,比如C++版本,python版本,java版本等等,最終的OpenCV會被安裝到:
D:/Program Files/Opencv4.1.2/install
2.3 第三步Generate(兩小步)
(1)勾選 BUILD_opencv_world和OPENCV_ENABLE_NONFREE這兩個變量,
從openCV 3 版本開始,最方便的一個地方就是將很多的庫都集成到了一個 opencv_xxxworld.lib 中,要不然會生成很多的庫文件,這樣我們在編寫程序的時候,鏈接步驟需要鏈接到好幾個lib庫,不方便,現在全部集成到一個 world.lib 中,我們只需要鏈接到這一個即可。 當我們點擊 Configure 以後需要找到 BUILD_opencv_world 這一個選項,並且勾選它,否則,不勾選直接編譯點擊 Generate 的話還是會生成很多獨立的依賴庫,在調用添加時不是很方便。
第一個變量的含義是生成一個大的.lib文件,在配置鏈接器時只有一個“opencv_world410d.lib”文件。第二個變量的含義是爲了在編譯成功後可以使用具有專利保護的算法,如果該變量不被選中,就不能使用例如SIFT算法在內的具有專利保護的算法,之後找到“OPENCV_EXTRA_MODULES_PATH”變量,該變量的含義是告訴編譯器擴展包的源碼在哪裏,選擇我們剛纔下載的opencv_contrib安裝包裏的modules文件夾。如果這個變量爲空,在編譯過程中也不會報錯,只是安裝了OpenCV的基礎版。
(2)配置OPENCV_EXTRA_MODULES_PATH
其實就是將OpenCV_contrib裏面的各個模塊的源代碼也加入進來一起進行編譯。
這兩部進行了之後,在點擊Generate,當在Cmake下面看到
Configuring done
Generating done
信息的時候,也就意味着Cmake這一步操作成功了。
三、VS2019編譯(release版本的編譯)
先看一下release版本的編譯:
進入到目標文件夾:D:\Program Files\Opencv4.1.2
用vs2019打開解決方案OpenCV.sln
我們發現裏面有很多的項目以及項目文件 xxx.vcxproj 文件
這裏接下來就有很多種操作方法了,主要是三種,其實都是一個意思就是
先生成ALL_BUILD,再生成INSTALL
如下:
(1)方法一:
直接生成整個解決方案:生成/生成解決方案
再選擇性生成INSTALL:找到解決方案資源管理器中的CmakeTargets,點開找到INSTALL,“右擊/僅用於項目/僅生成INSTALL”
(2)方法二:
先直接生成ALL_BUILD,找到解決方案資源管理器中的CmakeTargets,點開找到ALL_BUILD:“右擊/生成”
再選擇性生成INSTALL:找到解決方案資源管理器中的CmakeTargets,點開找到INSTALL,“右擊/僅用於項目/僅生成INSTALL”
(3)方法三:
一次性完成ALL_BUILD和INSTALL的生成
執行命令“生成/批生成”,打開如下對話框,選中ALL_BUILD和INSTALL兩項,如下:
這可能時間比較久,主要是生成ALL_BUILD的時間很長,等到編譯結束,顯示完成即可。
則表示成功,這個時候我們打開前面提到的install文件夾,即
D:\Program Files\Opencv4.1.2\install
得到如下的一些文件
我們發現這和我們自己直接下載window已經編譯好的文件是一樣的,內容對比如下:
但是不同的是Windows已經編譯好的只包含OpenCV標準部分,第三方contrib並沒有包含進來,但是我們自己變異的包含了進來,所以我們找到文件
opencv_world411.lib
對比發現,二者的大小不一樣,一個只有 2442kb,一個有 3962 kb。
總結:這裏的三種方法其實都是“項目編譯+項目安裝”,可以詳細參考我的博客:
爲什麼要用make?爲什麼要用cmake?Linux源碼編譯的一般流程?
四、VS2019編譯(release版本的編譯)
編譯的方法是一樣的,只需要把release編程debug即可,但是debug版本的編譯可能會出現如下錯誤:
編譯過程中會找不到python37_d.lib或python36_d.lib或python27_d.lib。
需要打開opencv工程中的binding/opencv_python3/外部依賴項/pyconfig.h,修改python37_d.lib爲python37.lib,已經註釋掉 #Py_DEBUG
五、使用
參見前面的文章
VS2017配置OpenCV4.1.1超詳細教程(項目配置與永久配置)(一)
VS2017的動態鏈接庫(Dynamic Link Library)配置
備註:在window上面編譯OpenCV實在是一件比較麻煩囉嗦的事情,十有八九難以成功,可能原模原樣按照這個步驟也會遇見各種問題,這是很正常的。
六、注意事項
我們按照上面的步驟一步一步來,結果發現依然不能正確編譯,編譯到一定程度顯示這個缺失,那個缺失,實際上是由於在configure階段需要下載很多的文件,這也是爲什麼第一次configure需要比較長時間的原因,但是國內的網站你懂得,下載十有八九很難成功,導致一些文件缺失,自然沒有辦法編譯了。