Windows下Cesium Terrain Builder编译 (VS2015)

一、CesiumTerrainProvider

1、Cesium的各种地形Provider

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

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

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

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

1. Quantized-mesh ，Cesium团队提供的开发的格式
2. 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、编译

1. 方式一，管理员方式打开【VS2015 x64 本机工具命令提示符】，进入build路径，执行

msbuild ALL_BUILD.vcxproj /p:Configuration="Release"

#下面命令会把编译后成果物复制到C:/Program Files/Cesium Terrain Builder下，需要管理员权限
msbuild INSTALL.vcxproj /p:Configuration="Release"

2. 方式二，使用VS2015打开Cesium Terrain Builder.sln，完成编译。

四、CTB测试

1. 执行ctb-info，若返回ctb版本号，则说明安装成功。

ctb-info.exe --version

2. 生成quantized-mesh-1.0格式瓦片文件

ctb-tile -o D:/tile -f Mesh D:/test/dtm.tif -c 4 

3. 生成layer.json文件

ctb-tile -o D:/tile -f Mesh -l D:/test/dtm.tif -c 1 #生成很快，使用1cpu即可 

4. 生成的地形瓦片文件，类似如下：
   

五、发布地形数据

1、非压缩数据

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

2、压缩数据

1. 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下即可。

2. 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;
   }