提供椭球体表面的地形或其他几何形状。表面几何形状
根据
TilingScheme 组织成一个金字塔状的瓦片。这种类型描述了
一个接口,并不打算直接实例化。
Members
指定从高度图创建的地形质量。值为1.0将确保相邻高度图顶点
的间距不超过
Globe.maximumScreenSpaceError 个屏幕像素,但可能会非常慢。
值为0.5将把估计的零级几何误差减半,从而允许相邻高度图顶点之间
有两倍的屏幕像素,因此渲染更快。
readonly availability : TileAvailability
获取一个对象,可以用来确定该提供者的地形可用性,例如
在点和矩形中。如果没有可用性
信息,可能会返回undefined。
readonly credit : Credit
获取在此地形提供者激活时显示的信用信息。通常用于标明
地形的来源。
readonly errorEvent : Event.<TerrainProvider.ErrorEvent>
获取一个事件,当地形提供者遇到异步错误时会引发该事件。通过订阅
此事件,您将被通知错误并可能能够从中恢复。事件监听器
会接收一个
TileProviderError 的实例。
获取一个值,指示请求的瓦片是否包含顶点法线。
获取一个值,指示提供者是否包含水面掩码。水面掩码
表明地球上哪些区域是水而不是陆地,以便可以将其渲染
为带有动画波浪的反射表面。
readonly tilingScheme : TilingScheme
获取提供者使用的瓦片方案。
Methods
static Cesium.TerrainProvider.getEstimatedLevelZeroGeometricErrorForAHeightmap(ellipsoid, tileImageWidth, numberOfTilesAtLevelZero) → number
当几何形状来自于高度图时,确定适当的几何误差估计值。
| Name | Type | Description |
|---|---|---|
ellipsoid |
Ellipsoid | 地形所附属的椭球体。 |
tileImageWidth |
number | 与单个瓦片关联的高度图的宽度(以像素为单位)。 |
numberOfTilesAtLevelZero |
number | 在零级瓦片的水平方向上的瓦片数量。 |
Returns:
估计的几何误差。
获取表示规则网格的三角形网格的索引列表。多次调用
此函数时,如果网格的宽度和高度相同,将返回
相同的索引列表。顶点的总数必须小于或等于
65536。
| Name | Type | Description |
|---|---|---|
width |
number | 规则网格在水平方向上的顶点数量。 |
height |
number | 规则网格在垂直方向上的顶点数量。 |
Returns:
索引列表。对于64KB或更小的情况返回Uint16Array,对于4GB或更小的情况返回Uint32Array。
获取给定级别瓦片中允许的最大几何误差。
| Name | Type | Description |
|---|---|---|
level |
number | 要获取最大几何误差的瓦片级别。 |
Returns:
最大几何误差。
确定某个瓦片的数据是否可以加载。
| Name | Type | Description |
|---|---|---|
x |
number | 要请求几何形状的瓦片的X坐标。 |
y |
number | 要请求几何形状的瓦片的Y坐标。 |
level |
number | 要请求几何形状的瓦片级别。 |
Returns:
如果地形提供者不支持,返回undefined;否则返回true或false。
确保我们加载瓦片的可用性数据。
| 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:
请求的几何形状的承诺。如果此方法
返回undefined而不是承诺,则表示已经有太多请求在等待,
该请求将在稍后重试。
Type Definitions
当发生错误时调用的函数。
This:
| Name | Type | Description |
|---|---|---|
err |
TileProviderError | 一个包含发生错误的详细信息的对象。 |
