Windows下Cesium Terrain Builder编译 (VS2015)

一、CesiumTerrainProvider

1、Cesium的各种地形Provider

Cesium支持多种地形provider来接收地形数据，大多数provider使用rest类型的接口来请求地形瓦片。各种地形provider在请求方式和地形数据的组织上会有所不同。以下几种是Cesium支持的地形provider：

Cesium Terrain Server——高分辨率的全球地形数据，支持地形光照和水流效果。地形瓦片提交给客户端的数据的格式用的是quantized-mesh v1.0。详情见Cesium里的CesiumTerrainProvider。Esri ArcGIS Image Server——从Esri影像服务里的高度图中产生地形数据集。详情见Cesium里的ArcGisImageServerTerrainProvider。VR-TheWorld Server——从一个VR-TheWorld服务里的高度图中产生地形数据。它们的托管服务器有全球90米的数据，包括深度测量。详情见Cesium里的VRTheWorldTerrainProvider。Ellipsoid——是Cesium默认的地形provider，是一个光滑的椭球面，没有现实的地形，地形高度为0。

2、cesium 支持地形图数据格式

在Cesium中，支持STK和Small Terrain两种地形格式，这两种地形数据在接收后都会分别封装成QuantizedMeshTerrainData或HeightMapTerrainData，这两种地形文件的格式后缀都是.terrain。

Quantized-mesh ，Cesium团队提供的开发的格式Heightmap，Google Earth Enterprise heightmap 1.0的规则格式是一种简单多分辨率四叉树，瓦片后缀为.terrain格式，一个高程数据集的瓦片url类似于：http://cesiumjs.org/tilesets/terrain/smallterrain/{z}/{x}/{y}.terrain。

3、CesiumTerrainProvider的使用

cesium中使用高程文件方式如下：

var viewer = new Cesium.Viewer('cesiumContainer'); var terrainProvider = new Cesium.CesiumTerrainProvider({ url: 'http://localhost:8081/terrain' }); viewer.terrainProvider = terrainProvider;

而http://localhost:8081/terrain是发布在tomcat，IIS等服务器上的地形瓦片文件。

Cesium Terrain Builder是一个C ++库和相关的命令行工具，能创建与CesiumTerrainProvide 一起使用的地形瓦片文件。而Cesium Terrain Builder依赖于zlib和gdal，所以要先编译zlib和gdal。gdal的编译请参考文章。

二、Zlib1.2.11编译

1、下载

下载网址：http://zlib.net/ 下载版本：1.2.11

2、编译

在win32目录下，有编译命令说明：

nmake -f win32/Makefile.msc (standard build) nmake -f win32/Makefile.msc LOC=-DFOO (nonstandard build) nmake -f win32/Makefile.msc LOC="-DASMV -DASMINF" OBJA="inffas32.obj match686.obj" (use ASM code, x86) nmake -f win32/Makefile.msc AS=ml64 LOC="-DASMV -DASMINF -I." OBJA="inffasx64.obj gvmat64.obj inffas8664.obj" (use ASM code, x64)

打开【VS2015 x64 本机工具命令提示符】，进入解压文件夹，执行

nmake -f win32/Makefile.msc AS=ml64 LOC="-DASMV -DASMINF -I." OBJA="inffasx64.obj gvmat64.obj inffas8664.obj" (use ASM code, x64)

后，在根目录下生成：zlib.lib(静态库) zdll.lib(动态库的导入库) zlib1.dll(动态库) 。

三、CTB编译

1、下载CTB

下载地址：支持quantized-mesh格式

2、配置参数

打开cmake gui，配置source code路径和build路径，勾选Advanced

配置GDAL_INCLUDE_DIR为GDAL编译后的include文件夹。配置GDAL_LIBRARY为GDAL编译后的.lib文件。配置ZLIB_INCLUDE_DIR为zlib动态库所在文件夹。配置ZLIB_LIBRARY_DEBUG，ZLIB_LIBRARY_RELEASE为zlib的.lib文件。

配置完成后点击Configure，选择编译平台为MSVC2015，然后点击Generate， 即可在build路径下生成MSVC2015的sln工程文件。

3、编译

方式一，管理员方式打开【VS2015 x64 本机工具命令提示符】，进入build路径，执行 msbuild ALL_BUILD.vcxproj /p:Configuration="Release" #下面命令会把编译后成果物复制到C:/Program Files/Cesium Terrain Builder下，需要管理员权限 msbuild INSTALL.vcxproj /p:Configuration="Release" 方式二，使用VS2015打开Cesium Terrain Builder.sln，完成编译。

四、CTB测试

执行ctb-info，若返回ctb版本号，则说明安装成功。 ctb-info.exe --version 生成quantized-mesh-1.0格式瓦片文件 ctb-tile -o D:/tile -f Mesh D:/test/dtm.tif -c 4 生成layer.json文件 ctb-tile -o D:/tile -f Mesh -l D:/test/dtm.tif -c 1 #生成很快，使用1cpu即可 生成的地形瓦片文件，类似如下：

五、发布地形数据

1、非压缩数据

对于非压缩的数据，把layer.json及相应切片数据放在ngix，apache，tomcat等web目录下即可。 对于cesium terrain builder默认是压缩的，如果想实现非压缩瓦片数据需要修改源代码。可参考此文

2、压缩数据

tomcat的发布方式 WEB-INF/web.xml内，增加跨域filter和设置Content-Encoding的filter，类似如下： <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>GeoServer</display-name> <filter> <filter-name>CorsFilter</filter-name> <filter-class>org.apache.catalina.filters.CorsFilter</filter-class> <init-param> <param-name>cors.allowed.origins</param-name> <param-value>*</param-value> </init-param> <init-param> <param-name>cors.allowed.methods</param-name> <param-value>GET,POST,HEAD,OPTIONS,PUT</param-value> </init-param> <init-param> <param-name>cors.allowed.headers</param-name> <param-value>Content-Type,X-Requested-With,accept,Origin,Access-Control-Request-Method,Access-Control-Request-Headers</param-value> </init-param> <init-param> <param-name>cors.exposed.headers</param-name> <param-value>Access-Control-Allow-Origin,Access-Control-Allow-Credentials</param-value> </init-param> <init-param> <param-name>cors.support.credentials</param-name> <param-value>true</param-value> </init-param> <init-param> <param-name>cors.preflight.maxage</param-name> <param-value>10</param-value> </init-param> </filter> <filter> <filter-name>GZipFilter</filter-name> <display-name>GZipFilter</display-name> <description></description> <filter-class>cesium.GZipFilter</filter-class> </filter> <filter-mapping> <filter-name>CorsFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <filter-mapping> <filter-name>GZipFilter</filter-name> <url-pattern>*.terrain</url-pattern> </filter-mapping> <mime-mapping> <extension>terrain</extension> <mime-type>application/vnd.quantized-mesh</mime-type> </mime-mapping> </web-app>

cesium.GZipFilter代码如下：

package cesium; import java.io.IOException; import javax.servlet.Filter; import javax.servlet.FilterChain; import javax.servlet.FilterConfig; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import javax.servlet.http.HttpServletResponse; /** * Servlet Filter implementation class GZipFilter */ public class GZipFilter implements Filter { /** * Default constructor. */ public GZipFilter() { } /** * @see Filter#destroy() */ public void destroy() { } /** * @see Filter#doFilter(ServletRequest, ServletResponse, FilterChain) */ public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletResponse httpResponse = (HttpServletResponse)response; httpResponse.setHeader("Content-Encoding", "gzip"); chain.doFilter(request, httpResponse); } /** * @see Filter#init(FilterConfig) */ public void init(FilterConfig fConfig) throws ServletException { } }

编译后放在WEB-INF\classes下即可。

ngix的发布方式 ngix.conf增加add header的设置。 location ~ \.terrain$ { root D:/terrain; add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Headers X-Requested-With; add_header Access-Control-Allow-Methods GET,POST,OPTIONS; add_header Content-Encoding gzip; }