TerrainProvider

Members

staticSuperMap3D.TerrainProvider.heightmapTerrainQuality : Number

指定从高度图创建的地形的质量。值1.0将确保相邻的高度图顶点之间的间隔不超过{@link Globe。屏幕像素，可能会非常缓慢。 0.5的值将把估计的零级几何误差减少一半，允许相邻高度图顶点之间的屏幕像素增加一倍，从而更快地渲染。

availability : TileAvailability

获取一个对象，该对象可用于从此Provider确定地形的可用性，例如在点和矩形中。这个函数不应该在TerrainProvider#ready返回true之前被调用。如果可用，此属性可能未定义没有相关信息。

credit : Credit

获取此地形provider处于活动状态时要显示的凭证。通常情况下，这是用来信用的地形来源。这个函数不应该在TerrainProvider#ready返回true之前被调用。

errorEvent : Event

获取地形Provider遇到异步错误时引发的事件。通过订阅事件，您将收到错误通知，并有可能从中恢复。事件监听器被传递一个TileProviderError的实例。

hasVertexNormals : Boolean

获取一个值，该值指示请求的瓦片是否包含顶点法线。这个函数不应该在TerrainProvider#ready返回true之前被调用。

hasWaterMask : Boolean

获取一个值，该值指示Provider是否包含水域掩码。水域掩码表明地球上哪些区域是水而不是陆地，因此它们可以呈现为带有动画波浪的反射表面。这个函数不应该是在TerrainProvider#ready返回true之前调用。

ready : Boolean

获取一个值，该值指示Provider是否已准备好使用。

readonlyreadyPromise : Promise.<Boolean>

获取一个Promise，该Promise在Provider准备好使用时解析为true。

tilingScheme : TilingScheme

获取Provider使用的切图方案。这个函数不应该在TerrainProvider#ready返回true之前被调用。

Methods

staticSuperMap3D.TerrainProvider.getEstimatedLevelZeroGeometricErrorForAHeightmap(ellipsoid, tileImageWidth, numberOfTilesAtLevelZero) → Number

当几何体来自高度图时，确定适当的几何误差估计值。

Name	Type	Description
ellipsoid	Ellipsoid	地形所依附的椭球体。
tileImageWidth	Number	与单个瓦片相关联的高度图的宽度（像素）。
numberOfTilesAtLevelZero	Number	水平方向上0级别瓦片的瓦片数。

Returns:

估计的几何误差。

staticSuperMap3D.TerrainProvider.getRegularGridIndices(width, height) → Uint16Array

获取表示规则网格的三角形网格的索引列表。调用此函数多次使用相同的网格宽度和高度返回相同的索引列表。 顶点总数必须小于或等于65536。

Name	Type	Description
width	Number	规则网格中水平方向的顶点数量。
height	Number	规则网格中垂直方向的顶点数量。

Returns:

指数列表。

getLevelMaximumGeometricError(level) → Number

获取给定级别的瓦片中允许的最大几何误差。这个函数不应该在TerrainProvider#ready返回true之前被调用。

Name	Type	Description
level	Number	要获得最大几何误差的瓦片水平。

Returns:

最大几何误差。

getTileDataAvailable(x, y, level) → Boolean

确定是否可以加载瓦片的数据。

Name	Type	Description
x	Number	请求几何体的瓦片的 X 坐标。
y	Number	请求几何体的瓦片的 y 坐标。
level	Number	请求瓦片的级别。

Returns:

如果地形Provider不支持则未定义，否则为 true 或 false。

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

请求给定瓦片的几何体。这个函数之前不应该被调用TerrainProvider#ready返回true。结果必须包括地形数据和可选地包括一个水域掩码和指示哪些子瓦片可用。

Name	Type	Description
x	Number	请求几何体的瓦片的 X 坐标。
y	Number	请求几何体的瓦片的 Y 坐标。
level	Number	请求几何体的瓦片级别。
request	Request	optional 请求对象。仅供内部使用。

Returns:

对所请求几何体的Promise。如果此方法返回undefined而不是promise，则表明已经有太多请求挂起，稍后将重试该请求。