为椭球体表面提供地形或其他几何数据。表面几何按
TilingScheme 组织成金字塔状的瓦片结构。此类型描述了一个
接口,不打算直接实例化。
Members
指定从高度图创建的地形质量。值为 1.0 将
确保相邻高度图顶点之间的间距不超过
Globe.maximumScreenSpaceError 屏幕像素,但可能会非常慢。
值为 0.5 将使估计的零级几何误差减半,允许相邻
高度图顶点之间有双倍的屏幕像素,从而渲染更快。
readonly availability : TileAvailability|undefined
获取一个可用于确定此提供者地形可用性的对象,例如在
点和矩形中。如果可用性信息不可用,
此属性可能为 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:
请求几何的 Promise。如果此方法
返回 undefined 而非 Promise,则表示已有太多待处理请求,
该请求将在稍后重试。
Type Definitions
发生错误时调用的函数。
This:
| Name | Type | Description |
|---|---|---|
err |
TileProviderError | 包含所发生的错误详细信息的对象。 |
