从回调函数获取高度值的简单
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 credit : Credit
当此地形提供者处于活动状态时,获得要显示的功劳。通常,这用于记录地形的来源。
readonly errorEvent : Event
获取当地形提供者遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个
TileProviderError
实例。
获取一个值,该值指示请求的图块是否包括顶点法线。
CustomHeightmapTerrainProvider
不支持顶点法线,因此返回值将始终为 false。
获取一个值,该值指示提供程序是否包含水面具。水面罩指示地球的哪些区域是水而不是陆地,因此可以将它们渲染为带有动画波浪的反射表面。
CustomHeightmapTerrainProvider
不支持水面具,因此返回值将始终为 false。
获取每个高度图瓦片的行数。
获取一个值,该值指示提供程序是否已准备好使用。
当提供者准备好使用时,获取一个解析为 true 的承诺。
readonly tilingScheme : TilingScheme
获取此提供程序使用的切片方案。
获取每个高度图图块的列数。
Methods
获取给定级别的图块中允许的最大几何误差。
Name | Type | Description |
---|---|---|
level
|
Number | 获得最大几何误差的切片级别。 |
Returns:
最大几何误差。
确定是否可以加载磁贴的数据。
Name | Type | Description |
---|---|---|
x
|
Number | 要为其请求几何图形的图块的 X 坐标。 |
y
|
Number | 要为其请求几何图形的图块的 Y 坐标。 |
level
|
Number | 为其请求几何图形的图块的级别。 |
Returns:
如果不支持则未定义,否则为真或假。
确保我们加载磁贴的可用性数据
Name | Type | Description |
---|---|---|
x
|
Number | 要为其请求几何图形的图块的 X 坐标。 |
y
|
Number | 要为其请求几何图形的图块的 Y 坐标。 |
level
|
Number | 为其请求几何图形的图块的级别。 |
Returns:
如果不需要加载任何内容或在加载所有必需的图块时解析的 Promise,则未定义
requestTileGeometry (x, y, level, request ) → Promise.< TerrainData >|undefined
请求给定图块的几何图形。结果包括地形数据并指示所有子图块都可用。
Name | Type | Description |
---|---|---|
x
|
Number | 要为其请求几何图形的图块的 X 坐标。 |
y
|
Number | 要为其请求几何图形的图块的 Y 坐标。 |
level
|
Number | 为其请求几何图形的图块的级别。 |
request
|
Request | 可选 请求对象。仅供内部使用。 |
Returns:
对所请求几何的承诺。如果此方法返回 undefined 而不是 promise,则表明已经有太多请求处于未决状态,稍后将重试该请求。
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:
以行优先顺序排列的数组或对高度数组的承诺。如果未定义,地球将渲染父图块。