Windows下 Cesium Terrain Builder(简称CTB) 编译安装指南

Windows下 Cesium Terrain Builder 编译安装指南

基本流程
软件
资源（全部公开免费）
编译与配置GDAL
编译与配置zlib
编译与配置CTB
检测安装是否成功
常见错误与解决方案

基本流程

编译与配置GDAL
编译与配置Zlib
编译与配置Cesium Terrain Builder

软件

CMake 3.16.3
visual studio 2015

资源（全部公开免费）

Cesium Terrain Builder 源码下载地址
GDAL-2.4.4 源码下载地址
zlib1.2.11 源码下载地址

编译与配置GDAL

GDAL的编译与配置是十分常见的操作，这里参考：
https://blog.csdn.net/qq_32153213/article/details/81363588
感谢该博主细致的描述

编译与配置zlib

虽然在windows下zlib提供了编译好的库，但内容与CTB所要求有出入，这里建议自行编译，参考该篇文章提供的方法2
https://www.cnblogs.com/MrOuqs/p/5751485.html

新建文件夹，命名为zlibPackage（用于存放编译后所得文件）
打开zlib源代码文件夹，复制zconf.h和zlib.h头文件至zlibPackage文件夹中
进入如下路径

zlib-1.2.11\contrib\vstudio\vc14

使用vs2015打开项目工程文件 zlibvc.sln
选择输出平台选择Debug x64，点击生成->生成解决方案，开始编译。
常见的错误解决方法见上述文章

编译完成后在如下路径内得到 zlibwapi.dll和 zlibwapi.lib 将其复制到zlibPackage文件夹中

zlib-1.2.11\contrib\vstudio\vc14\x64\ZlibDllDebug

编译与配置CTB

主要参考如下链接：
https://www.jianshu.com/p/d8640841f2e1

新建文件夹，命名为CTB（用于存放cmake生成的VS2015项目）
新建文件夹，命名为CesiumTerrainBuilder（用于存放最终的CesiumTerrainBuilder应用）
打开cmake软件，选择source code为Cesium Terrain Builder源代码文件夹，选择where to build the binaries为CTB文件夹，勾选Advanced，点击Configure
配置配置GDAL_INCLUDE_DIR为GDAL编译后的include文件夹，GDAL_LIBRARY为GDAL编译后的 .lib 文件
配置ZLIB_INCLUDE_DIR是zlib动态库所在文件夹（即上文中的zlibPackage）
配置ZLIB_LIBRARY_DEBUG ，ZLIB_LIBRARY_RELEASE是zlib的 .lib 文件（即 zlibPackage 下的zlibwapi.lib 文件），配置完成后如下，点击Generate生成项目
进入CTB文件夹，打开Cesium Terrain Builder.sln 解决方案，点击生成。最终将下列目录内的所有文件拷贝至CesiumTerrainBuilder文件夹。完成编译

CTB\src\Debug
CTB\tools\Debug

检测安装是否成功

在CesiumTerrainBuilder文件夹内打开power shell命令行工具输入如下命令

ctb-info.exe --version

若显示CesiumTerrainBuilder版本号，说明安装成功。

常见错误与解决方案

编译zlib时输出错误信息

error LNK2026: 模块对于 SAFESEH 映像是不安全的

解决方法参考如下链接
https://blog.csdn.net/zengraoli/article/details/11919307

编译CTB工具时弹出错误

无法打开源文件 unistd.h

解决方法参考如下链接
https://blog.csdn.net/Dashi_Lu/article/details/90054696

安装完成后运行命令行工具，输出如下错误信息并闪退

ERROR 4:Unable to open EPSG support file gcs.csv

解决办法为找到GDAL源代码文件夹，将如下路径添加至系统环境变量

gdal\gdal-2.4.4\data