TerrainProvider

new SuperMap3D.TerrainProvider()

为椭球表面提供地形或其他几何形状。
See:

Members

staticSuperMap3D.TerrainProvider.heightmapTerrainQuality : Number

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

availability : TileAvailability

获取可用于从此提供程序确定地形可用性的对象,例如在点和矩形中。这个函数不应该在TerrainProvider#ready 返回true之前被调用。 如果可用性信息不可用,则此属性可能未定义。

credit : Credit

当此地形提供者处于活动状态时,要显示的凭证。通常情况下,这用于记录地形的来源。 这个函数应该在TerrainProvider#ready返回true之前不应调用此函数。

errorEvent : Event

获取地形提供者遇到异步错误时引发的事件。通过监听该事件,将收到错误通知,并可能从中恢复。事件监听器被传递一个TileProviderError实例。

hasVertexNormals : Boolean

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

hasWaterMask : Boolean

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

ready : Boolean

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

readonlyreadyPromise : Promise.<Boolean>

获取一个promise,该promise在提供程序准备好使用时解析为true。

tilingScheme : TilingScheme

获取提供者使用的切片方案。在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:
如果地形提供程序不支持,则未定义,否则为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,则表明已经有太多请求处于未决状态,稍后将重试该请求。