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:
所请求几何体的 Promise。如果此方法 返回的是 undefined 而非 Promise,则表明已有过多请求 处于挂起状态,该请求将在稍后重试。

Type Definitions

Cesium.TerrainProvider.ErrorEvent(err)

发生错误时调用的函数。
This:
Name Type Description
err TileProviderError 一个包含所发生错误详细信息的对象。
需要帮助?获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。