为椭球体表面提供地形或其他几何体。表面几何体
根据
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 | 一个包含所发生错误详细信息的对象。 |
