Cesium API - GoogleEarthEnterpriseTerrainData 中文文档

本文介绍下Cesium中 GoogleEarthEnterpriseTerrainData API的详细使用说明。

GoogleEarthEnterpriseTerrainData API 调用方法

new Cesium.GoogleEarthEnterpriseTerrainData(options)

Core/GoogleEarthEnterpriseTerrainData.js 94

来自谷歌地球企业服务器的单个瓦片的地形数据。

Name Type Description

options

Object

对象，具有以下属性：

Name Type Default Description

buffer ArrayBuffer 包含地形数据的缓冲区。

negativeAltitudeExponentBias Number 负地形高度的乘数（multiplier），被编码为非常小的正值。

negativeElevationThreshold Number 负值阈值。

childTileMask

Number

15

optional 一个位掩码，指示此瓦片的四个子代中哪个存在。如果设置了子瓦片的位，那么当需要时也将为该瓦片请求几何图形。如果位被清除，则不请求子瓦片，而是从父块上采样（upsampled）几何图形。位值如下：

Bit Position	Bit Value	Child Tile
0	1	Southwest
1	2	Southeast
2	4	Northeast
3	8	Northwest

createdByUpsampling Boolean false optional 如果此实例是通过上采样另一个实例创建的，则为true；否则，false。

credits Array.<Credit> optional 此瓦片的版权数组。

示例：

var buffer = ...
var childTileMask = ...
var terrainData = new Cesium.GoogleEarthEnterpriseTerrainData({
  buffer : heightBuffer,
  childTileMask : childTileMask
});

参考：

成员变量

credits : Array.<Credit>

Core/GoogleEarthEnterpriseTerrainData.js 139

此瓦片的版权数组。

waterMask : Uint8Array|Image|Canvas

Core/GoogleEarthEnterpriseTerrainData.js 158

这个地形数据中包含的水掩模，如果有的话。水掩模是一个矩形的Uint8Array或图像，其中值255表示水，值0表示土地。 0到255之间的值也可以平滑地混合在土地和水之间。

内置方法

interpolateHeight(rectangle, longitude, latitude) → Number

Core/GoogleEarthEnterpriseTerrainData.js 285

计算指定经度和纬度处的地形高度。

Name	Type	Description
`rectangle`	Rectangle	这个地形数据覆盖的矩形。
`longitude`	Number	以弧度表示的经度。
`latitude`	Number	以弧度表示的纬度。

返回值：

指定位置的地形高度。如果位置在矩形外，此方法将推断高度，这对于位于矩形外的位置可能是非常不正确的。

isChildAvailable(thisX, thisY, childX, childY) → Boolean

Core/GoogleEarthEnterpriseTerrainData.js 426

根据HeightmapTerrainData.childTileMask确定给定的子瓦片是否可用。给定的子瓦片坐标被假定为该瓦片的四个子瓦片中的一个。如果给出了非子瓦片坐标，则返回东南子瓦片的可用性。

Name	Type	Description
`thisX`	Number	这个（父）瓦片的X坐标。
`thisY`	Number	这个（父）瓦片的Y坐标。
`childX`	Number	检查可用性的子瓦片的X坐标。
`childY`	Number	检查可用性的子瓦片的Y坐标。

返回值：

如果子瓦片可用，则为true；否则，false。

upsample(tilingScheme, thisX, thisY, thisLevel, descendantX, descendantY, descendantLevel) → Promise.<HeightmapTerrainData>|undefined

Core/GoogleEarthEnterpriseTerrainData.js 326

将此地形数据上采样以供后代瓦片使用。结果实例将包含此实例中高度样本的一个子集，必要时将进行插值。

Name	Type	Description
`tilingScheme`	TilingScheme	该地形数据的切片方案。
`thisX`	Number	在切片方案中，此瓦片的X坐标。
`thisY`	Number	在切片方案中，此瓦片的Y坐标。
`thisLevel`	Number	在切片方案中，此瓦片的级别。
`descendantX`	Number	我们正在为其上采样的后代瓦片的切片方案中的X坐标。
`descendantY`	Number	我们正在为其上采样的后代瓦片的切片方案中的Y坐标。
`descendantLevel`	Number	我们正在对其进行上采样的后代瓦片的切片方案中的级别。