CustomHeightmapTerrainProvider

new Cesium.CustomHeightmapTerrainProvider (options)

从回调函数获取高度值的简单 TerrainProvider 。它可以用于程序生成的地形或作为一种加载自定义高度图数据的方式,而无需创建 TerrainProvider 的子类。有一些限制,例如没有水面具、没有顶点法线和没有可用性,所以一个成熟的 TerrainProvider 子类更适合这些更复杂的用例。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 描述
callback CustomHeightmapTerrainProvider.GeometryCallback 请求平铺几何的回调函数。
width 数字 每个高度图图块的列数。
height 数字 每个高度图图块的行数。
tilingScheme 平铺方案 可选 平铺方案指定如何将椭球面分解为平铺。如果未提供此参数,则使用 GeographicTilingScheme
ellipsoid 椭球体 可选 椭圆体。如果指定了 tilingScheme,则忽略此参数,并使用切片方案的椭球代替。如果两个参数均未指定,则使用 WGS84 椭球。
credit 信用 | 细绳 可选 数据源的功劳,显示在画布上。
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

当此地形提供者处于活动状态时,获得要显示的功劳。通常,这用于记录地形的来源。
获取当地形提供者遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个 TileProviderError 实例。

readonly hasVertexNormals : Boolean

获取一个值,该值指示请求的图块是否包括顶点法线。 CustomHeightmapTerrainProvider 不支持顶点法线,因此返回值将始终为 false。

readonly hasWaterMask : Boolean

获取一个值,该值指示提供程序是否包含水面具。水面罩指示地球的哪些区域是水而不是陆地,因此可以将它们渲染为带有动画波浪的反射表面。 CustomHeightmapTerrainProvider 不支持水面具,因此返回值将始终为 false。
获取每个高度图瓦片的行数。
获取一个值,该值指示提供程序是否已准备好使用。

readonly readyPromise : Promise.<Boolean>

当提供者准备好使用时,获取一个解析为 true 的承诺。
获取此提供程序使用的切片方案。
获取每个高度图图块的列数。

Methods

getLevelMaximumGeometricError (level) Number

获取给定级别的图块中允许的最大几何误差。
Name Type Description
level Number 获得最大几何误差的切片级别。
Returns:
最大几何误差。

getTileDataAvailable (x, y, level) Boolean|undefined

确定是否可以加载磁贴的数据。
Name Type Description
x Number 要为其请求几何图形的图块的 X 坐标。
y Number 要为其请求几何图形的图块的 Y 坐标。
level Number 为其请求几何图形的图块的级别。
Returns:
如果不支持则未定义,否则为真或假。

loadTileDataAvailability (x, y, level) undefined|Promise.<void>

确保我们加载磁贴的可用性数据
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:
以行优先顺序排列的数组或对高度数组的承诺。如果未定义,地球将渲染父图块。