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 包含所发生的错误详细信息的对象。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.