之前按照常规方式(http://www.opencv.org.cn/index.php/VC_2008_Express%E4%B8%8B%E5%AE%89%E8%A3%85OpenCV2.0/2.1)用Cmake和VS2008编译了OpenCV_SVN,都是生成动态链接库的,最近写的程序Release版需要静态连接库,于是边查Google边探索怎样生成和使用OpenCV的静态库。

一、参考《编译opencv2.1静态库》(),生成静态库。

1、在Cmake中去掉BUILD_EXAMPLES,BUILD_NEW_PYTHON_SUPPORT,BUILD_SHARED_LIBS,BUILD_TESTS,勾选OPENCV_BUILD_3RDPARTY_LIBS,  WITH_JASPER,  WITH_JPEG,  WITH_PNG,  WITH_TIFF 选项 (这里没有勾选WITH_OPENNI,如果需要使用应该要用 OpenNI 的源码另外生成相应的静态库)。

2、编译完成后,将静态库.lib文件覆盖复制到原来按常规方式生成的lib文件夹中,例如 VS2008_build/3rdparty/lib 和 VS2008_build/lib 。注意所编译的静态库中不包含 3rdparty 中的 videoInput64.lib 和 videoInput.lib ,这两个文件在 SVN 源码中直接提供,不需要编译生成。

二、使用时的常见问题

1、编译工程的Release版之前,先在项目属性—Configuration Properties—C/C++—Code Generation 的 Runtime Library 设置为 Multi-threaded (/MT)

2、在 项目属性—Configuration Properties—Linker—Input 的 Additional Dependencies 中,除了加入基本的 opencv_***220.lib 外,还要加入第三方lib,即libjasper.lib , libjpeg.lib , libpng.lib , libtiff.lib , zlib.lib , opencv_lapack.lib 等,这些都与 opencv 的 core , highgui 等模块有关。

3、如果出现“error LNK2001: unresolved external symbol __imp__CreateToolbarEx@52” 的错误,则 Additional Dependencies 中需添加 comctl32.lib 。(参考《fatal error LNK1120: 1 unresolved externals》http://www.opencv.org.cn/forum/viewtopic.php?f=1&t=1309&start=0&st=0&sk=t&sd=a

4、如果出现“(cvcap_vfw.obj) : error LNK2001: unresolved external symbol _AVIFileRelease@4” 等错误,并不是opencv链接库的问题,而是opencv在调用win32下的vfw库,需要在 Additional Dependencies 中需加上 vfw32.lib 这个系统库文件,才能顺利编译。(参考《Opencv中highgui静态链接库使用时error LNK2001的错误》http://hi.baidu.com/56908268/blog/item/0f619bef2ce6efe1ce1b3efb.html

5、如果出现“fatal error LNK1104: cannot open file “atlthunk.lib””的错误,是因为VS2005以上版本的ATL和MFC库中已不再带有这个文件,因此一般情况下可去掉对atlthunk.lib 的引用。参考《directshow 问题 找不到 atlthunk.lib》()18、19和26楼的方法,在项目的头文件 stdafx.h 中添加如下代码:

// TODO: reference additional headers your program requires here    
//在这添加*************************************************************     
#include #pragma comment(linker, "/NODEFAULTLIB:atlthunk.lib") 
#if (_ATL_VER < 0x0700)    
namespace ATL     
{     
    inline void * __stdcall __AllocStdCallThunk()     
    {     
        return ::HeapAlloc(::GetProcessHeap(), 0, sizeof(_stdcallthunk));     
    }     
    inline void __stdcall __FreeStdCallThunk(void *p)     
    {     
        ::HeapFree(::GetProcessHeap(), 0, p);     
    }     
};     
#endif //(_ATL_VER < 0x0700)     
//***************************************************************添加结束

如果确实需要用到 atlthunk.lib ,可以到这里()下载WDK7.0的ATL7.1,从中抽取出 atlthunk.lib,放到 $(VCInstallDir)atlmfc/lib 里。

使用OpenCV官方提供文件配置、静态编译并运行OpenCV-2.3.x/2.4.x实例

当我们需要测试程序,或者想将程序发给其他同事或者同学,以让同事或者同学运行以测试程序性能或者逻辑是否恰当时,是不是还要他人也要像你当初开发程序时一样一步一步的配置OpenCV运行环境!?如果不做这些,还会提示像图1所示的系统错误(无法启动程序,因为计算机中丢失“opencv_highgui241d.dll。尝试重新安装该程序以解决此问题”),这是不是太麻烦了,其实我们可以将程序以静态链接的方式编译,如此便少去了配置运行时环境的步骤了。

图1  动态编译的程序在未配置OpenCV的机器上运行提示系统错误

    静态编译,也就是说编译后的程序可以直接拷贝到其他机器上并能直接运行。而不需附带链接库和配置环境变量。

    由于OpenCV自2.3.0版本开始就提供了OpenCV-2.3.x -win-superpack.exe或OpenCV-2.4.x.exe文件,该文件解压后我们会发里面有个名为“build”的文件夹,其中有各个平台的链接库,而且还提供了Windows平台下的静态链接库,本文主要讲述一个例子以说明如何配置使用该静态链接库。

    像前面(OpenCV2.3.x/2.4.x在Visual Studio2005/2008和Visual Studio2010配置方法详解)放置OpenCV库文件配置VC++目录选项,并且配置环境变量(这一步可以不配置,但要在VC++目录中将OpenCV的“bin”目录添加到“VC++ 可执行文件”目录选项中),注意这里使用的库目录是“staticlib”而不是“lib”,这里不多赘述。

配置完Visual Studio 2008中的VC++目录后便可以编写代码了。

(1)编辑代码

“新建项目”,选择“Visual C++-空项目”,输入项目名“StaticOpenCV”,“添加新项-代码-C++ 文件”,输入文件名“StaticOpenCV.cpp”,编辑代码,这里本人使用的测试代码如下所示:

1. #include <opencv/highgui.h>
2. 
3. int main( int argc, char** argv ) {  
4.          IplImage*img = cvLoadImage( argv[1] );  
5.          cvNamedWindow("OpenCV", CV_WINDOW_AUTOSIZE );  
6.          cvShowImage("OpenCV", img );  
7.          cvWaitKey(0);  
8.          cvReleaseImage(&img );  
9.          cvDestroyWindow("OpenCV" );  
10. 
11. return( 0 );  
12. }

(2)添加附加依赖项有两种方法,见《OpenCV 2.3.x/2.4.x在Visual Studio 2005/2008和Visual Studio 2010配置方法详解》一文。

    OpenCV-2.4.1库文件列表(使用的时候适当选择,这里我要用的是libjasperd.lib、libjpegd.lib、libpngd.lib"、libtiffd.lib、zlibd.lib(注意这几个必须要用的,因为这些是OpenCV所使用的第三方库)和opencv_highgui241d.lib、opencv_core241d.lib库文件。

1. libjasper.lib  
2. libjasperd.lib  
3. libjpeg.lib  
4. libjpegd.lib  
5. libpng.lib  
6. libpngd.lib  
7. libtiff.lib  
8. libtiffd.lib  
9. opencv_calib3d241.lib  
10. opencv_calib3d241d.lib  
11. opencv_contrib241.lib  
12. opencv_contrib241d.lib  
13. opencv_core241.lib  
14. opencv_core241d.lib  
15. opencv_features2d241.lib  
16. opencv_features2d241d.lib  
17. opencv_ffmpeg241.dll  
18. opencv_flann241.lib  
19. opencv_flann241d.lib  
20. opencv_gpu241.lib  
21. opencv_gpu241d.lib  
22. opencv_haartraining_engine.lib  
23. opencv_haartraining_engined.lib  
24. opencv_highgui241.lib  
25. opencv_highgui241d.lib  
26. opencv_imgproc241.lib  
27. opencv_imgproc241d.lib  
28. opencv_legacy241.lib  
29. opencv_legacy241d.lib  
30. opencv_ml241.lib  
31. opencv_ml241d.lib  
32. opencv_nonfree241.lib  
33. opencv_nonfree241d.lib  
34. opencv_objdetect241.lib  
35. opencv_objdetect241d.lib  
36. opencv_photo241.lib  
37. opencv_photo241d.lib  
38. opencv_stitching241.lib  
39. opencv_stitching241d.lib  
40. opencv_ts241.lib  
41. opencv_ts241d.lib  
42. opencv_video241.lib  
43. opencv_video241d.lib  
44. opencv_videostab241.lib  
45. opencv_videostab241d.lib  
46. zlib.lib  
47. zlibd.lib

    为方便我们知道到我们到底需要使用哪些库文件,这里我们使用《OpenCV2.3.x/2.4.x在Visual Studio2005/2008和Visual Studio2010配置方法详解》一文中所讲述的第二种方法添加程序依赖库。我们在头文件与主函数之间添加如下代码:

1. #pragma comment( lib,"libjasperd.lib" )
2. #pragma comment( lib,"libjpegd.lib" )
3. #pragma comment( lib,"libpngd.lib" )
4. #pragma comment( lib,"libtiffd.lib" )
5. #pragma comment( lib, "zlibd.lib")
6. 
7. #pragma comment( lib,"opencv_highgui241d.lib" )
8. #pragma comment( lib,"opencv_core241d.lib" )

    编译程序,会发发现程序不能正常编译(错误如图2所示),这主要与MSVCRT.lib(MSVCR90.dll)有关。

图2  编译产生很多错误

    经过查询相关资料可知,需要对项目属性进行如下配置:右击项目名称,选择“属性-配置属性-C/C++-代码生成”,这里我们发现“运行库”选项默认值选项为“多线程调试 DLL (/MDd)”,同时这里有四个选项(/MT,/MTd, /MD, /MDd),前两个一组,为静态链接运行时库,运行时不需要运行时库的支持,代码直接插入到程序中去;后两个一组,为动态链接运行时库,运行时需要MSVCR90.dll或MSVCP90.dll支持。

    所以,这里我们将“运行库”选项设置为“多线程(/MT)”或“多线程调试(/MTd)”(注意你的编译模式(Debug还是Release)),如图3所示,设置完成全单击确定。

图3  将“运行库”选项设置为“多线程调试(/MTd)”

    然后我们再次编译程序,发现还有两个错误,如图4所示。

当我们需要测试程序,或者想将程序发给其他同事或者同学,以让同事或者同学运行以测试程序性能或者逻辑是否恰当时,是不是还要他人也要像你当初开发程序时一样一步一步的配置OpenCV运行环境!?如果不做这些,还会提示像图1所示的系统错误(无法启动程序,因为计算机中丢失“opencv_highgui241d.dll。尝试重新安装该程序以解决此问题”),这是不是太麻烦了,其实我们可以将程序以静态链接的方式编译,如此便少去了配置运行时环境的步骤了。

图1  动态编译的程序在未配置OpenCV的机器上运行提示系统错误

    静态编译,也就是说编译后的程序可以直接拷贝到其他机器上并能直接运行。而不需附带链接库和配置环境变量。

    由于OpenCV自2.3.0版本开始就提供了OpenCV-2.3.x -win-superpack.exe或OpenCV-2.4.x.exe文件,该文件解压后我们会发里面有个名为“build”的文件夹,其中有各个平台的链接库,而且还提供了Windows平台下的静态链接库,本文主要讲述一个例子以说明如何配置使用该静态链接库。

    像前面(OpenCV2.3.x/2.4.x在Visual Studio2005/2008和Visual Studio2010配置方法详解)放置OpenCV库文件配置VC++目录选项,并且配置环境变量(这一步可以不配置,但要在VC++目录中将OpenCV的“bin”目录添加到“VC++ 可执行文件”目录选项中),注意这里使用的库目录是“staticlib”而不是“lib”,这里不多赘述。

配置完Visual Studio 2008中的VC++目录后便可以编写代码了。

(1)编辑代码

“新建项目”,选择“Visual C++-空项目”,输入项目名“StaticOpenCV”,“添加新项-代码-C++ 文件”,输入文件名“StaticOpenCV.cpp”,编辑代码,这里本人使用的测试代码如下所示:

1. #include <opencv/highgui.h>
2. 
3. int main( int argc, char** argv ) {  
4.          IplImage*img = cvLoadImage( argv[1] );  
5.          cvNamedWindow("OpenCV", CV_WINDOW_AUTOSIZE );  
6.          cvShowImage("OpenCV", img );  
7.          cvWaitKey(0);  
8.          cvReleaseImage(&img );  
9.          cvDestroyWindow("OpenCV" );  
10. 
11. return( 0 );  
12. }

(2)添加附加依赖项有两种方法,见《OpenCV 2.3.x/2.4.x在Visual Studio 2005/2008和Visual Studio 2010配置方法详解》一文。

    OpenCV-2.4.1库文件列表(使用的时候适当选择,这里我要用的是libjasperd.lib、libjpegd.lib、libpngd.lib"、libtiffd.lib、zlibd.lib(注意这几个必须要用的,因为这些是OpenCV所使用的第三方库)和opencv_highgui241d.lib、opencv_core241d.lib库文件。

1. libjasper.lib  
2. libjasperd.lib  
3. libjpeg.lib  
4. libjpegd.lib  
5. libpng.lib  
6. libpngd.lib  
7. libtiff.lib  
8. libtiffd.lib  
9. opencv_calib3d241.lib  
10. opencv_calib3d241d.lib  
11. opencv_contrib241.lib  
12. opencv_contrib241d.lib  
13. opencv_core241.lib  
14. opencv_core241d.lib  
15. opencv_features2d241.lib  
16. opencv_features2d241d.lib  
17. opencv_ffmpeg241.dll  
18. opencv_flann241.lib  
19. opencv_flann241d.lib  
20. opencv_gpu241.lib  
21. opencv_gpu241d.lib  
22. opencv_haartraining_engine.lib  
23. opencv_haartraining_engined.lib  
24. opencv_highgui241.lib  
25. opencv_highgui241d.lib  
26. opencv_imgproc241.lib  
27. opencv_imgproc241d.lib  
28. opencv_legacy241.lib  
29. opencv_legacy241d.lib  
30. opencv_ml241.lib  
31. opencv_ml241d.lib  
32. opencv_nonfree241.lib  
33. opencv_nonfree241d.lib  
34. opencv_objdetect241.lib  
35. opencv_objdetect241d.lib  
36. opencv_photo241.lib  
37. opencv_photo241d.lib  
38. opencv_stitching241.lib  
39. opencv_stitching241d.lib  
40. opencv_ts241.lib  
41. opencv_ts241d.lib  
42. opencv_video241.lib  
43. opencv_video241d.lib  
44. opencv_videostab241.lib  
45. opencv_videostab241d.lib  
46. zlib.lib  
47. zlibd.lib

    为方便我们知道到我们到底需要使用哪些库文件,这里我们使用《OpenCV2.3.x/2.4.x在Visual Studio2005/2008和Visual Studio2010配置方法详解》一文中所讲述的第二种方法添加程序依赖库。我们在头文件与主函数之间添加如下代码:

1. #pragma comment( lib,"libjasperd.lib" )
2. #pragma comment( lib,"libjpegd.lib" )
3. #pragma comment( lib,"libpngd.lib" )
4. #pragma comment( lib,"libtiffd.lib" )
5. #pragma comment( lib, "zlibd.lib")
6. 
7. #pragma comment( lib,"opencv_highgui241d.lib" )
8. #pragma comment( lib,"opencv_core241d.lib" )

    编译程序,会发发现程序不能正常编译(错误如图2所示),这主要与MSVCRT.lib(MSVCR90.dll)有关。

图2  编译产生很多错误

    经过查询相关资料可知,需要对项目属性进行如下配置:右击项目名称,选择“属性-配置属性-C/C++-代码生成”,这里我们发现“运行库”选项默认值选项为“多线程调试 DLL (/MDd)”,同时这里有四个选项(/MT,/MTd, /MD, /MDd),前两个一组,为静态链接运行时库,运行时不需要运行时库的支持,代码直接插入到程序中去;后两个一组,为动态链接运行时库,运行时需要MSVCR90.dll或MSVCP90.dll支持。

    所以,这里我们将“运行库”选项设置为“多线程(/MT)”或“多线程调试(/MTd)”(注意你的编译模式(Debug还是Release)),如图3所示,设置完成全单击确定。

图3  将“运行库”选项设置为“多线程调试(/MTd)”

    然后我们再次编译程序,发现还有两个错误,如图4所示。

这是因为我们的程序是win32程序的问题,我们还需要添加vfw32.lib和comctl32.lib这两个依赖库文件,最终代码如下所示:

1. #include <opencv/highgui.h>
2. 
3. // 这几个依赖库文件必须要添加,
4. // 因为这些是OpenCV所使用的第三方库
5. #pragma comment( lib, "libjasperd.lib" )
6. #pragma comment( lib, "libjpegd.lib" )
7. #pragma comment( lib, "libpngd.lib" )
8. #pragma comment( lib, "libtiffd.lib" )
9. #pragma comment( lib, "zlibd.lib" )
10. 
11. // 这里根据你的程序添加依赖库文件
12. #pragma comment( lib, "opencv_highgui241d.lib" )
13. #pragma comment( lib, "opencv_core241d.lib" )
14. 
15. // 添加这两个是因为win32程序
16. #pragma comment( lib, "vfw32.lib" )
17. #pragma comment( lib, "comctl32.lib" )
18. 
19. int main( int argc, char** argv ) {  
20.     IplImage* img = cvLoadImage( argv[1] );  
21.     cvNamedWindow( "OpenCV", CV_WINDOW_AUTOSIZE );  
22.     cvShowImage( "OpenCV", img );  
23.     cvWaitKey(0);  
24.     cvReleaseImage( &img );  
25.     cvDestroyWindow( "OpenCV" );  
26. 
27. return ( 0 );  
28. }

    再次编译,成功了!!!此时,我们可以将编译后的执行程序复制到其他机器(没有配置OpenCV函数库及环境变量)以测试是否OK。


备注:

1.根据需要可能还需要忽略libcmt库;

2.静态编译后的可执行程序比动态编译后的可执行程序大得多;

3.不能静态编译C++版本的OpenCV程序,可能和VS有关;