TerrainProvider

new Cesium.TerrainProvider ()

为椭圆体的表面提供地形或其他几何图形。根据 TilingScheme 将表面几何结构组织成一个瓷砖金字塔。这种类型描述了一个接口,并不打算直接实例化。
See:

Members

static Cesium.TerrainProvider.heightmapTerrainQuality : Number

指定从高度图创建的地形质量。值 1.0 将确保相邻的高度图顶点之间的间隔不超过 Globe.maximumScreenSpaceError 屏幕像素,并且可能会非常缓慢。值 0.5 会将估计的零级几何误差减半,允许相邻高度图顶点之间的屏幕像素增加两倍,从而更快地渲染。
获取一个对象,该对象可用于确定来自此提供程序的地形的可用性,例如点和矩形。在 TerrainProvider#ready 返回 true 之前不应调用此函数。如果可用性信息不可用,则此属性可能未定义。
当此地形提供者处于活动状态时,获得要显示的功劳。通常,这用于记录地形的来源。在 TerrainProvider#ready 返回 true 之前不应调用此函数。
获取当地形提供者遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知并可能从中恢复。事件侦听器被传递一个 TileProviderError 实例。

readonly hasVertexNormals : Boolean

获取一个值,该值指示请求的图块是否包括顶点法线。在 TerrainProvider#ready 返回 true 之前不应调用此函数。

readonly hasWaterMask : Boolean

获取一个值,该值指示提供者是否包含水面具。水面罩指示地球的哪些区域是水而不是陆地,因此可以将它们渲染为带有动画波浪的反射表面。在 TerrainProvider#ready 返回 true 之前不应调用此函数。

readonly ready : Boolean

获取一个值,该值指示提供程序是否已准备好使用。

readonly readyPromise : Promise.<Boolean>

当提供者准备好使用时,获取一个解析为 true 的承诺。
获取提供者使用的切片方案。在 TerrainProvider#ready 返回 true 之前不应调用此函数。

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

获取给定级别的图块中允许的最大几何误差。在 TerrainProvider#ready 返回 true 之前不应调用此函数。
Name Type Description
level Number 获得最大几何误差的切片级别。
Returns:
最大几何误差。

getTileDataAvailable (x, y, level) Boolean|undefined

确定是否可以加载磁贴的数据。
Name Type Description
x Number 要为其请求几何图形的图块的 X 坐标。
y Number 要为其请求几何图形的图块的 Y 坐标。
level Number 为其请求几何图形的图块的级别。
Returns:
如果地形提供者不支持,则未定义,否则为 true 或 false。

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

确保我们加载磁贴的可用性数据
Name Type Description
x Number 要为其请求几何图形的图块的 X 坐标。
y Number 要为其请求几何图形的图块的 Y 坐标。
level Number 为其请求几何图形的图块的级别。
Returns:
如果不需要加载任何内容或在加载所有必需的图块时解析的 Promise,则未定义

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

请求给定图块的几何图形。在 TerrainProvider#ready 返回 true 之前不应调用此函数。结果必须包含地形数据,并且可以选择包含水掩膜和哪些子图块可用的指示。
Name Type Description
x Number 要为其请求几何图形的图块的 X 坐标。
y Number 要为其请求几何图形的图块的 Y 坐标。
level Number 为其请求几何图形的图块的级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对所请求几何的承诺。如果此方法返回 undefined 而不是 promise,则表明已经有太多请求处于未决状态,稍后将重试该请求。

Type Definitions

Cesium.TerrainProvider.ErrorEvent (err)

发生错误时调用的函数。
This:
Name Type Description
err TileProviderError 一个对象,包含有关发生的错误的详细信息。