TerrainProvider

new LSGlobe.TerrainProvider ()

为椭球表面提供地形或其他几何形状。表面几何形状为根据 TilingScheme 整理成金字塔状的瓷砖。此类型描述了接口,不能直接实例化。
See:

Members

static LSGlobe.TerrainProvider.heightmapTerrainQuality : Number

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

hasVertexNormals : Boolean

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

hasWaterMask : Boolean

获取一个值,该值指示提供者是否包括水面罩。水面膜指出地球上哪些区域是水而不是土地,因此可以进行渲染作为带有动画波的反射表面。此功能不应在 TerrainProvider#ready 返回true之前调用。
获取一个值,该值指示提供者是否已准备好使用。

readonly readyPromise : Promise.<Boolean>

获取一个在提供程序准备好使用时解析为true的承诺。
获取提供程序使用的切片方案。该功能应在 TerrainProvider#ready 返回true之前不会被调用。

Methods

static LSGlobe.TerrainProvider.getEstimatedLevelZeroGeometricErrorForAHeightmap (ellipsoid, tileImageWidth, numberOfTilesAtLevelZero) Number

当几何来自高度图时,确定适当的几何误差估计。
Name Type Description
ellipsoid Ellipsoid 地形所附着的椭圆体。
tileImageWidth Number 与单个图块关联的高度图的宽度(以像素为单位)。
numberOfTilesAtLevelZero Number 瓦片级别为零时水平方向的瓦片数。
Returns:
估计的几何误差。

static LSGlobe.TerrainProvider.getRegularGridIndices (width, height) Uint16Array|Uint32Array

获取代表常规网格的三角形网格的索引列表。呼唤此函数使用相同的网格宽度和高度多次返回相同的索引列表。顶点总数必须小于或等于至65536。
Name Type Description
width Number 水平方向上规则网格中的顶点数。
height Number 垂直方向上规则网格中的顶点数。
Returns:
索引列表。 Uint16Array返回的大小不超过64KB,Uint32Array返回的大小不超过4GB。

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:
如果地形提供商不支持,则为undefined,否则为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,这表明已经有太多请求 待处理,稍后将重试该请求。