CGAL 4.11 版 win10-vs2015-64bit 编译与开发关键点指南

一. 编译CGAL

这个版本的编译在官方文档中有很多指导，但是依然有个别细节需要注意。

大概情况如下：

编译demo时，用太新的qt（比如qt5.8）会导致interface未定义错误。最后版本罗列如下：qt5.6msvc201564、boost 1.60 、libQGLViewer2.6.3、tbb64 201702...、 Eigen3 、

0. 官网下载CGAL-4.11-Setup.exe,这是一个解压源码的exe，里面并没有lib和dll，安装后需要进行下面的编译步骤。安装在比如G:\dev\CGAL-4.11-beta1。安装时不选html，官网文档很好用。

1. 使用CMake GUI，假设大家都很熟悉cmake的使用。

2. 有一个必备的第3方Lib列表需要安装，阅读官方文档会收获更多的信息：

8.1 Standard Template Library (STL)这个VS编译器中是有的，不用做什么事儿。

8.2 Boost 这个到官网下载Binary版：boost_1_60_0-msvc-14.0-64.exe（270多MB），安装在在比如H:\boost_1_60_0；

8.3 GMP and MPFR，这两个在CGAL的源码setup.exe中有下载选项，下载后在代码目录里含有。比如H:\dev\CGAL-4.11\auxiliary\gmp\lib

8.4 zlib，下载zip文件，解压，cmake之，然后生成项目，然后将INSTAL生成一下（既要Debug也要Release）。注意cmake中配置的install路径。配置CGAL的cmake时要找到它。D:\Program Files\zlib\lib

8.5 OpenGL ：win10系统中一般默认含有这个，基本不用管。

8.6 Qt5，我用的是qt-opensource-windows-x86-msvc2015_64-5.6.0.exe不要用高版本的qt，因为互相依赖关系和qt新版本的interface有变化）。

8.7 libQGLViewer,
这是可选的，但最好也下载之，demo中要用，非常好的工具； 最好在官网下载libQGLViewer-2.6.3.zip或在此处下载，编译一下；用QT Creator打开H:\dev\libQGLViewer-2.6.3\QGLViewer\QGLViewer.pro,然后在Creator的菜单"构建"->执行qmake，然后->构建所有项目，这会导致debug和release同时被构建，要知道他们的路径，比如：H:\dev\libQGLViewer-2.6.3\QGLViewer
。

8.8 Eigen3， 最好也配置，很多项目要用它；这个不用编译，直接引用头文件的一个数学库。

8.9 VTK自己手工编译的，安装在D:\Program Files\VTK\。配置CMake中的VTK_DIR为 D:\Program Files\VTK\lib\cmake\vtk-8.0

配置CMake GUI时需要注意：
1. Boost_INCLUDE_DIR是 H:/boost1.6.0；而不是H:/boost_1_65_1/boost。因为代码中都是#include <Boost/***.h>。CMakegui中选中CGAL_Boost_USE_STATICLIBS，并

2. Qt5_DIR 参考配置为D:/Qt/Qt5.6.0/5.6/msvc2015_64/lib/cmake/Qt5

3. 在CMake GUI中选中 WITH_Eigen3、WITH_QGLViewer、WITH_ZLIB;然后configure一下，再配置：

（1）QGLVIEWER_INCLUDE_DIR为H:/dev/libQGLViewer-2.6.3

（2）EIGEN3_INCLUDE_DIR为 D:/eigen-eigen-b9cd8366d4e8；不是D:/eigen-eigen-b9cd8366d4e8/eigen，道理同boost

（3）配置zlib

4. 在CMake GUI中选中 WITH_Demos,不要选择WITH_examples,那个以后挨个来学习就好了，而且会大大增加编译时间和复杂度。

然后再Configure一下，看看有没有Error等。

如果愿意配置TBB的话，可以在此下载并解压即可；

然后，Genrate，并用VS2015打开CGAL.sln,并在vs2015的生成菜单中选择“生成解决方案”。编译大概二十分钟。

然后，找到 INSTALL，右击，生成就会安装到 C:\Program Files\CGAL中各种inlcude lib bin文件夹。

这样就可以在项目中正常使用CGAL的lib了；

二. 在自己的项目中应用CGAL库

自己创建一个win32命令行项目： CGAL HelloWorld：

注意 ：

1. 有些项目需要在项目属性中配置boost和eigen，比如 VC++目录：包含目录：G:\dev\boost_1_60_0 和 D:\eigen-eigen-b9cd8366d4e8

2. 在用到Eigen3命名空间的项目，要在CPP原文件中加入宏CGAL_EIGEN3_ENABLED， 方式如下：

#define CGAL_EIGEN3_ENABLED

#include <CGAL/Surface_mesh_deformation.h>

3. 有些项目需要在项目属性中配置gmp的include和lib

三. 编译cgal demo的注意点

1. CIMG_INCLUDE_DIR 我也配置了，用解压后的文件夹配置，比如：H:\dev\CImg-2.0.5_pre092517

2. 在CMake中配置boost的lib文件，选中用带libboost***.lib的文件，比如 ： H:\boost_1_60_0\lib64-msvc-14.0/libboost_filesystem-vc140-mt-1_60.lib