TerrainProvider

new Cesium.TerrainProvider()

提供椭球体表面的地形或其他几何形状。表面几何形状 根据 TilingScheme 组织成一个金字塔状的瓦片。这种类型描述了 一个接口,并不打算直接实例化。
See:

Members

static Cesium.TerrainProvider.heightmapTerrainQuality : number

指定从高度图创建的地形质量。值为1.0将确保相邻高度图顶点 的间距不超过 Globe.maximumScreenSpaceError 个屏幕像素,但可能会非常慢。 值为0.5将把估计的零级几何误差减半,从而允许相邻高度图顶点之间 有两倍的屏幕像素,因此渲染更快。
获取一个对象,可以用来确定该提供者的地形可用性,例如 在点和矩形中。如果没有可用性 信息,可能会返回undefined。
获取在此地形提供者激活时显示的信用信息。通常用于标明 地形的来源。
获取一个事件,当地形提供者遇到异步错误时会引发该事件。通过订阅 此事件,您将被通知错误并可能能够从中恢复。事件监听器 会接收一个 TileProviderError 的实例。

readonly hasVertexNormals : boolean

获取一个值,指示请求的瓦片是否包含顶点法线。

readonly hasWaterMask : boolean

获取一个值,指示提供者是否包含水面掩码。水面掩码 表明地球上哪些区域是水而不是陆地,以便可以将其渲染 为带有动画波浪的反射表面。
获取提供者使用的瓦片方案。

Methods

static Cesium.TerrainProvider.getEstimatedLevelZeroGeometricErrorForAHeightmap(ellipsoid, tileImageWidth, numberOfTilesAtLevelZero)number

当几何形状来自于高度图时,确定适当的几何误差估计值。
Name Type Description
ellipsoid Ellipsoid 地形所附属的椭球体。
tileImageWidth number 与单个瓦片关联的高度图的宽度(以像素为单位)。
numberOfTilesAtLevelZero number 在零级瓦片的水平方向上的瓦片数量。
Returns:
估计的几何误差。

static Cesium.TerrainProvider.getRegularGridIndices(width, height)Uint16Array|Uint32Array

获取表示规则网格的三角形网格的索引列表。多次调用 此函数时,如果网格的宽度和高度相同,将返回 相同的索引列表。顶点的总数必须小于或等于 65536。
Name Type Description
width number 规则网格在水平方向上的顶点数量。
height number 规则网格在垂直方向上的顶点数量。
Returns:
索引列表。对于64KB或更小的情况返回Uint16Array,对于4GB或更小的情况返回Uint32Array。

getLevelMaximumGeometricError(level)number

获取给定级别瓦片中允许的最大几何误差。
Name Type Description
level number 要获取最大几何误差的瓦片级别。
Returns:
最大几何误差。

getTileDataAvailable(x, y, level)boolean|undefined

确定某个瓦片的数据是否可以加载。
Name Type Description
x number 要请求几何形状的瓦片的X坐标。
y number 要请求几何形状的瓦片的Y坐标。
level number 要请求几何形状的瓦片级别。
Returns:
如果地形提供者不支持,返回undefined;否则返回true或false。

loadTileDataAvailability(x, y, level)undefined|Promise.<void>

确保我们加载瓦片的可用性数据。
Name Type Description
x number 要请求几何形状的瓦片的X坐标。
y number 要请求几何形状的瓦片的Y坐标。
level number 要请求几何形状的瓦片级别。
Returns:
如果不需要加载任何内容,则返回undefined;否则返回一个Promise,在所有所需瓦片加载完成时解析。

requestTileGeometry(x, y, level, request)Promise.<TerrainData>|undefined

请求给定瓦片的几何形状。结果必须包括地形数据,并且 还可以选择性地包括水面掩码和指示哪些子瓦片可用的信息。
Name Type Description
x number 要请求几何形状的瓦片的X坐标。
y number 要请求几何形状的瓦片的Y坐标。
level number 要请求几何形状的瓦片级别。
request Request optional 请求对象。仅用于内部使用。
Returns:
请求的几何形状的承诺。如果此方法 返回undefined而不是承诺,则表示已经有太多请求在等待, 该请求将在稍后重试。

Type Definitions

Cesium.TerrainProvider.ErrorEvent(err)

当发生错误时调用的函数。
This:
Name Type Description
err TileProviderError 一个包含发生错误的详细信息的对象。
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.