CMake3.7.2 PCL1.8.0-AllInOne-msvc-xin64 VS2013 利用CMake生成包含PCL库的VS2013工程

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/shine_cherise/article/details/79130436

前言


由于博主经常用CMake生成VS工程,近期在用CMake生成包含PCL库的VS工程时遇到了许多奇怪的错误。故记录下来,一是用于日后警醒自己,二是分享给有需要的朋友们。

对于习惯用VS生成工程的读者,如果对在VS2013上配置PCL1.8.0感兴趣的话,可以参看博主的另一篇博文: PCL-1.8.0-AllInOne VS2013 Win8 X64 安装配置及部分问题解决方法。本篇文章主要关注于用CMake来生成工程。


环境


Win8 x64

Visual Studio 2013

CMake-3.7.2-win32


一.准备工作


首先需下载PCL-1.8.0-AllInOne安装包文件相应的pdb文件

  • PCL库安装一般有两种方式:一种是先下载PCL的各种第三方依赖库以及PCL的源代码,然后自行进行编译安装;另一种是领用AllInOne版本进行安装。本博文关注的是后一种安装方式。
  • 目前PCL官网提供的Windows AllInOne下载版本只有1.5.1和1.6.0,PCL工程页可以查找到PCL-1.8.1的源码和AllInOne安装包以及PCL-1.8.0的源码,但PCL-1.8.0的AllInOne以及其pcd文件链接失效或被墙了(读者后续可以持续关注,如果PCL工程页链接重新生效推荐下载那里的安装包)。

本博文使用的安装包是 一个参考博客给出的百度网盘中下载的,亲测有效。下载其中的 PCL-1.8.0-win64的安装包以及相应的pdb文件,属性表可以不下载,建议自己建立(因为博主用链接里提供的属性表测试时没有成功,后面有介绍自己的属性表的建立方式)。

下载链接http://pan.baidu.com/s/1c1sqoQO 

此外,该百度云链接提供了PCL-1.8.0-win32的安装包以及相应的pdb文件。由于博主使用的是x64的,win32版本没有测试过,但原理应该是相通的。



二.安装


1.PCL库安装

双击安装包,安装的时候注意选上“Add PCL to the system PATH for all users”,这样安装程序会自动在系统环境变量中添加“PCL_ROOT”、“OPENNI2_INCLUDE64”、“OPENNI2_LIB64”、“OPENNI2_REDIST64”四个项。

注意:若安装结束后提示“路径过长无法添加环境变量”,这并不影响;如果安装结束后没有自动在系统环境变量中增加以上四项,则手动加上即可。)




图示皆以我的安装路径为例。




2.OpenNI安装

安装过程中会弹出OpenNI的安装程序,将OpenNI的安装路径设置为“PCL_ROOT”下3rdParty\OpenNI2文件夹,例:

C:\Program Files\PCL 1.8.0\3rdParty\OpenNI2

(这里可以选择安装在其他目录,不过会影响到项目配置)


3.pdb安装

安装程序执行完成后将pdb文件包解压(即PCL-1.8.0-AllInOne-msvc2013-win64-pdb.rar),pdb文件拷贝到“PCL_ROOT”下的bin文件夹中,例:

C:\Program Files\PCL 1.8.0\bin


三.环境变量


上面说过了安装程序会自动添加“PCL_ROOT”项到系统环境变量中,此外还要手动添加PCL、Qhull、FLANN、VTK、OpenNI2的bin目录以及%OPENNI2_REDIST64%到PATH中

例:




注意:如果安装程序没有自动添加“PCL_ROOT”则需要手动填上,因为CMake生成VS工程的时候,PCLConfig.cmake文件是通过“PCL_ROOT”来找PCL库的(如下图)。



四、CMake生成VS2013工程


1.建立CMakeLists.txt文件


建立如下所示的最简化版的CMakeLists.txt来生成包含PCL库的工程。
cmake_minimum_required(VERSION 2.8 FATAL_ERROR)

project(Demo)

include_directories(${PCL_INCLUDE_DIRS})
link_directoried(${PCL_LIBRARY_DIRS})
add_definitions(${PCL_DEFINITIONS})

add_executable(PCLTest main.cpp)
target_link(PCLTest ${PCL_LIBRARIES})

2.利用CMake进行Configure


工程生成平台选择为“Visual Studio 12 2013 Win64”



3.Qt5的下载与配置


Configure的过程中会进行报错:缺少Qt5。
原因分析:这是因为PCL1.8.0用到了Qt5库中的一些支持,由于博主原本的Qt版本是4.8.6不满足,所以报错。
解决方案:进行Qt5.x的下载并进行配置。
博主下载的是:Qt5.5.1-opensource-windows-x86-msvc2013_64.exe
配置:下载好后对该可执行文件进行一键安装即可,并将 Qt5.5.1库的bin路径添加到系统环境变量的Path变量中。
例:
C:\Qt\Qt5.5.1\5.5\msvc2013_64\bin
下载Qt5并进行配置后,“缺少Qt5”的报错信息消失。


4.GLEW库的下载与配置


但在Configure过程中仍然会进行报错:“simulation is required but glew was not found”.



原因分析:因为PCL1.8.0库用到了GLEW(The OpenGL Extension Wrangler Library)库的一些支持,所以必须要有GLEW库才能进行正常Configure。
解决方案:下载GLEW库并尽心相关配置。
博主下载的是:GLEW官网有原码形式和二进制形式两种类型的包提供下载,原码形式需要自己下载并编译,博主直接下的GLEW-2.1.0的二进制形式。
配置 :把GLEW下载下来后,可以把它放到%PCL_ROOT%\3rdParty的文件路径下,然后在系统环境变量中增加以下三个变量(这三个变量的确立是通过查看PCLConfig.cmake以及观察CMake Configure报错信息琢磨测试得出)。
  • GLEW_ROOT(对照着%PCL_Root%\cmake\PCLConfig.cmake文件中查找GLEW库时的变量名) -> 指向GLEW库的安装路径
  • GLEW_INCLUDE_DIR(对应着CMake中第一个篮框中的第二个变量名) -> 指向GLEW库的Include文件夹路径
  • GLEW_GLEW_LIBRARY(对应着CMake中第一个篮框中的第一个变量名) -> 指向GLEW库的glew32.lib文件所在的文件夹路径

以博主路径为例:
GLEW_ROOT           C:\Program Files\PCL 1.8.0\3rdParty\glew2.1.0
GLEW_INCLUDE_DIR    C:\Program Files\PCL 1.8.0\3rdParty\glew2.1.0\include
GLEW_GLEW_LIBRARY   C:\Program Files\PCL 1.8.0\3rdParty\glew2.1.0\lib\Release\x64
可以通过如下方式检验系统环境变量是否添加并更新成功:
“Win+R”启动“运行” -> 输入“cmd”启动Console -> 分别输入“echo %GLEW_ROOT%”,“echo %GLEW_INCLUDE_DIR%”和“echo %GLEW_GLEW_LIBRARY%” -> 检查是否返回路径并为正确路径。

进行GLEW库的下载与配置后,重新利用CMake进行Configure后显示正常,如下图所示。




其中,GLEW库的相关路径已经找到,Qt5、FLANN、OPENNI、OPENNI2、QHULL等库的相关路径都已找到。DAVIDSDK、DSSDK、ENSENSO、RSSDK四个库的相关路径还没有找到,PCL_POINT_CLOUD_EDITOR_INCLUDE_DIR也没有找到,但是并不影响, 配置成功
接着在 点击“Generate”即可生成VS2013工程文件

注意
1. 这里有一个非常磨人的坑。即使我们添加了“GLEW_ROOT”、“GLEW_INCLUDE_DIR”、“GLEW_GLEW_LIBRARY”三个系统环境变量并给予了正确的路径值,并且利用控制台命令(如上述)检测了这些变量的存在与更新,但是在CMake Configure的时候还是显示没有找到相关路径。(博主装了两边PCL1.8.0,第一次安装的时候出现了CMake找不到GLEW_GLEW_LIBRARY的情况,重启了一遍电脑之后找到了;第二次安装的时候出现了CMake同时找不到GLEW_INCLUDE_DIR和GLEW_GLEW_LIBRARY的情况,重启了一遍电脑之后依然找不到GLEW_INCLUDE_DIR,又重启了一遍电脑终于找到了)
(当然,如果不觉得繁琐,可以每次CMake一个新的工程的时候,都手动在CMake中输入GLEW_INCLUDE_DIR和GLEW_GLEW_LIBRARY的路径值,这个方法一定可行。但对于博主这类强迫症可行不通......)
2.之前用CMake生成包含Matlab的VS工程文件的时候,也出现过类似的情况:系统环境变量设置好了( 一般不重启电脑环境变量也已经更新好,难道这仅仅是一个副本?),CMake愣是找不到,只有重启一次或多次电脑后才能够找到。


五.项目环境目录配置。


打开由CMake生成的VS2013工程文件。切换到“解决方案资源管理器”视图 -> 对目标项目右键,选择“属性” -> 左侧“配置属性” -> 选择“调试” -> 选择“环境”,设置为:

PATH=$(PCL_ROOT)\bin;$(PCL_ROOT)\3rdParty\FLANN\bin;$(PCL_ROOT)\3rdParty\VTK\bin ;

$(PCL_ROOT)\Qhull\bin;$(PCL_ROOT)\3rdParty\OpenNI2\Tools;$(PATH) 

此处为了方便显示所以换行,实际中可以单行直接输入。




注意

  • 此步的“项目环境目录配置”是针对单个项目而言的,如果该工程中有多个项目,必须对每一个项目进行“项目环境目录配置”操作,否则未进行“项目环境目录配置”的项目运行时会出现如下所示的奇怪错误:“无可用信息,未为pcl_visualization_debug.dll加载任何符号”。(这类错误在使用pcl::visualization::PCLVisualizer类时非常常见,例如可以正常显示点云数据,但是不能正常显示点云的法矢数据并出现如下图所示的错误)。



  • CMake生成的VS2013工程中的项目不需要进行“新建项目属性表并设置”或“设置项目的包含目录、库目录和附加依赖项”的操作,因为CMake通过CMakeLists.txt文件自动给项目进行了包含目录、库目录和附加依赖项的设置。但是“项目环境目录配置”操作是必不可少的
  • 经过“项目环境目录配置”后生成的工程能够在VS2013里运行,但是直接点击运行文件夹里生成的exe文件时运行中会报错。(当程序中有用到pcl::Visualizer的时候)(直接运行release版本的exe文件比直接在VS2013里运行release版本工程速度快很多,用了才知道!)


注:

上述三点已经得到解决。

原因分析:

经逐一排查,本质原因是虽然已经在系统环境变量path中设置了PCL、FLANN、VTK、Qhull、OpenNI2的bin路径(为程序运行时提供相应的dll文件),但是程序运行时没有感应到(原因尚未知)。所以只能在VS中单独对项目进行“项目属性 -> 调试 -> 环境”设置,一旦脱离VS平台直接运行生成的exe程序就又失效了。(经逐一排查,对这一现象起决定性作用的关键路径是$(PCL_ROOT)\bin;


解决方法:

  • <尝试1:成功> 
将“ $ (PCL_ROOT)\bin ”中的所有文件拷贝到“C:\Windows\System32”文件夹中。(亲测有效,利用这方法,上述第二点的单独对项目进行 进行 “项目属性 -> 调试 -> 环境” 设置可以省略,而且也不会出现上述第三点中的exe运行报错

(为了保险起见,建议把

$(PCL_ROOT)\bin;$(PCL_ROOT)\3rdParty\FLANN\bin;$(PCL_ROOT)\3rdParty\VTK\bin ;$(PCL_ROOT)\3rdParty\Qhull\bin;$(PCL_ROOT)\3rdParty\OpenNI2\Tools;”中的所有文件都拷贝到“C:\Windows\System32”中去)

该方法参考的博文:PCL1.7.2 VS2013 配置 (下图为核心信息截图截图)

  • <尝试2:失效> 
把“ $ (PCL_ROOT)\3rdParty\VTK\bin ”中的dll文件拷贝到 $(PCL_ROOT)\bin;”文件夹下,因为PCL 1.8.0以下版本的PCL库可能在运行的时候“看不见”VTK的动态库。(博主试过这方法但是没有效果,而且发现问题关键在于$(PCL_ROOT)\bin;”而非其他路径。并且PCL 1.8.0以上的版本已经把VTK改成了静态链接方式。未深究,待考察。)
该观点参考的博文:PCL 1.7.2 All-in-one Installer MSVC2012 x64 (下图为博文中的核心信息截图)

[关于该问题解决后的反思]

  1. 不要仅仅拥“错误提示”去搜索答案(因为有些错误提示是一大串编号,原因可能很多),还要尝试用稍微本质一些的“关键词”去搜索答案。比如此处的问题出在“程序运行时dll文件的寻找”上。
  2. 参考了好多中文博文,终于拼拼凑凑地把PCL All-in-one 1.8.0版本还算功能较完整地整合好了。“最佳的参考答案永远是官网教程”,这是装PCL 1.8.0 All-In-One以及CGAL库得到的血与泪的教训啊!有时间后对照PCL官网教程把自己的PCL再“完满完满”!

完成上述操作之后,CMake生成的VS2013工程就能正常运行了!


程序运行成功示意图(点云法矢显示):






猜你喜欢

转载自blog.csdn.net/shine_cherise/article/details/79130436