CustomHeightmapTerrainProvider

new Cesium.CustomHeightmapTerrainProvider(options)
engine/Source/Core/CustomHeightmapTerrainProvider.js 56

一个简单的 TerrainProvider，用于从回调函数获取高度值。 它可以用于程序生成的地形，也可以作为加载自定义的一种方式 高度贴图数据，而无需创建 TerrainProvider 的子类。 存在一些限制，例如无水遮罩、无顶点法线和无 可用性，因此成熟的 TerrainProvider 子类更合适 对于这些更复杂的用例。
Name Type Description
options object 对象，具有以下属性:
Name Type Default Description
callback CustomHeightmapTerrainProvider.GeometryCallback 用于请求瓦片几何体的回调函数。
width number 每个高度贴图瓦片的列数。
height number 每个高度贴图瓦片的行数。
tilingScheme TilingScheme optional 指定椭球体如何 表面被打碎成图块。如果未提供此参数，则 GeographicTilingScheme 被使用。
ellipsoid Ellipsoid Ellipsoid.default optional 椭球体。 如果指定了 tilingScheme，则 此参数将被忽略，而使用切片方案的椭球体。如果两者都不是 参数，则使用默认椭球。
credit Credit | string optional 数据源的积分，显示在画布上。
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
engine/Source/Core/CustomHeightmapTerrainProvider.js 172

获取一个对象，该对象可用于确定此提供程序提供的地形的可用性，例如 在点和矩形中。如果可用性 信息不可用。

readonly credit : Credit
engine/Source/Core/CustomHeightmapTerrainProvider.js 116

获取此地形提供程序处于活动状态时要显示的信用额度。通常，这用于贷记 地形的源。

readonly errorEvent : Event
engine/Source/Core/CustomHeightmapTerrainProvider.js 103

获取 terrain 提供程序遇到异步错误时引发的事件。通过订阅 时，您将收到错误通知，并可能从中恢复。事件侦听器 将传递 TileProviderError 的实例。

readonly hasVertexNormals : boolean
engine/Source/Core/CustomHeightmapTerrainProvider.js 158

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

readonly hasWaterMask : boolean
engine/Source/Core/CustomHeightmapTerrainProvider.js 144

获取一个值，该值指示提供程序是否包含水面罩。水面罩 表示地球上的哪些区域是水面而不是陆地，因此可以渲染它们 作为具有动画波形的反射表面。 CustomHeightmapTerrainProvider 不支持水遮罩，因此返回 值将始终为 false。

readonly height : boolean
engine/Source/Core/CustomHeightmapTerrainProvider.js 196

获取每个高度贴图平铺的行数。

readonly tilingScheme : TilingScheme
engine/Source/Core/CustomHeightmapTerrainProvider.js 128

获取此提供程序使用的平铺方案。

readonly width : boolean
engine/Source/Core/CustomHeightmapTerrainProvider.js 184

获取每个高度贴图平铺的列数。

Methods

getLevelMaximumGeometricError(level) → number
engine/Source/Core/CustomHeightmapTerrainProvider.js 251

获取给定级别的贴图中允许的最大几何误差。
Name Type Description
level number 要获得最大几何误差的瓦片水平。
Returns:
最大几何误差。

getTileDataAvailable(x, y, level) → boolean|undefined
engine/Source/Core/CustomHeightmapTerrainProvider.js 264

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

loadTileDataAvailability(x, y, level) → undefined|Promise.<void>
engine/Source/Core/CustomHeightmapTerrainProvider.js 280

确保我们为tile加载了可用性数据
Name Type Description
x number 要为其请求几何图形的贴图的X坐标。
y number 要为其请求几何图形的贴图的Y坐标。
level number 要为其请求几何图形的贴图的级别。
Returns:
如果不需要加载任何内容，则为 Undefined，或者在加载所有必需的图块时解析的 Promise

requestTileGeometry(x, y, level, request) → Promise.<TerrainData>|undefined
engine/Source/Core/CustomHeightmapTerrainProvider.js 216

请求给定图块的几何图形。结果包括 terrain 数据，并指示所有子磁贴都可用。
Name Type Description
x number 要为其请求几何图形的贴图的X坐标。
y number 要为其请求几何图形的贴图的Y坐标。
level number 要为其请求几何图形的贴图的级别。
request Request optional 请求对象。仅供内部使用。
Returns:
请求的 geometry 的 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
engine/Source/Core/CustomHeightmapTerrainProvider.js 11

Name Type Description
x number 要为其请求几何图形的贴图的X坐标。
y number 要为其请求几何图形的贴图的Y坐标。
level number 要为其请求几何图形的贴图的级别。
Returns:
按行优先顺序对高度数组的数组或 Promise。如果未定义，则地球将呈现父瓦片。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
packages/engine
packages/widgets