一个简单的
TerrainProvider，通过回调函数获取高度值。
它可以用于程序生成的地形或作为加载自定义高度图数据的方式，而无需创建 TerrainProvider 的子类。
还有一些限制，例如没有水面遮罩、没有顶点法线和可用性，因此一个完整的 TerrainProvider 子类更适合这些更复杂的用例。
| Name | Type | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
具有以下属性的对象：
|
Example:
const viewer = new Cesium.Viewer("cesiumContainer", {
terrainProvider: new Cesium.CustomHeightmapTerrainProvider({
width: 32,
height: 32,
callback: function (x, y, level) {
return new Float32Array(32 * 32); // all zeros
},
}),
});See:
Members
readonly availability : TileAvailability
获取一个对象，可以用来确定此提供者的地形可用性，例如
在特定点和矩形中。此属性如果不可用，将可能是未定义的。
readonly credit : Credit
获取当此地形提供者处于活动状态时显示的信用信息。通常用于感谢
地形的来源。
readonly errorEvent : Event
获取在地形提供者遇到异步错误时触发的事件。通过订阅
该事件，您将收到错误通知，并可以进行可能的恢复。事件监听器
将接收到一个
TileProviderError 的实例。
获取一个值，指示请求的瓦片是否包括顶点法线。
CustomHeightmapTerrainProvider 不支持顶点法线，因此返回
值将始终为 false。
获取一个值，指示该提供者是否包括水面遮罩。水面遮罩
指示地球上哪些区域是水而不是陆地，这样它们可以被渲染
成具有动态波浪的反射表面。
CustomHeightmapTerrainProvider 不支持水面遮罩，因此返回
值将始终为 false。
获取每个高度图瓦片的行数。
readonly tilingScheme : TilingScheme
获取此提供者使用的瓦片方案。
获取每个高度图瓦片的列数。
Methods
获取给定级别瓦片允许的最大几何误差。
| Name | Type | Description |
|---|---|---|
level |
number | 要获取最大几何误差的瓦片级别。 |
Returns:
最大几何误差。
确定瓦片的数据是否可供加载。
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何体的瓦片的 X 坐标。 |
y |
number | 请求几何体的瓦片的 Y 坐标。 |
level |
number | 请求几何体的瓦片的级别。 |
Returns:
如果不支持则为未定义， 否则为 true 或 false。
确保我们加载瓦片的可用性数据。
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何体的瓦片的 X 坐标。 |
y |
number | 请求几何体的瓦片的 Y 坐标。 |
level |
number | 请求几何体的瓦片的级别。 |
Returns:
如果没有需要加载的内容则为未定义，或者返回一个承诺，当所有需要的瓦片加载完成时解析。
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
Cesium.CustomHeightmapTerrainProvider.GeometryCallback(x, y, level) → Int8Array|Uint8Array|Int16Array|Uint16Array|Int32Array|Uint32Array|Float32Array|Float64Array|Array.<number>|Promise.<(Int8Array|Uint8Array|Int16Array|Uint16Array|Int32Array|Uint32Array|Float32Array|Float64Array|Array.<number>)>|undefined
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何体的瓦片的 X 坐标。 |
y |
number | 请求几何体的瓦片的 Y 坐标。 |
level |
number | 请求几何体的瓦片的级别。 |
Returns:
一个数组或一个承诺，表示以行主序的高度数组。如果为 undefined，则地球将渲染父瓦片。