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 数据源的 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

readonly availability : TileAvailability
engine/Source/Core/CustomHeightmapTerrainProvider.js 172

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

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

获取此地形提供程序处于活动状态时要显示的 credit。通常这用于标注 地形的来源。

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

获取当地形提供程序遇到异步错误时触发的事件。通过订阅 该事件，您将收到错误通知，并有可能从中恢复。事件监听器 会接收到一个 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:
如果不支持则为 undefined，否则为 true 或 false。

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

确保我们加载瓦片的可用性数据
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

请求给定瓦片的几何数据。结果包含地形 数据，并指示所有子瓦片均可用。
Name Type Description
x number 要请求几何数据的瓦片的 X 坐标。
y number 要请求几何数据的瓦片的 Y 坐标。
level number 要请求几何数据的瓦片的层级。
request Request optional 请求对象。仅用于内部使用。
Returns:
所请求几何数据的 promise。如果此方法 返回的是 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
engine/Source/Core/CustomHeightmapTerrainProvider.js 11

Name Type Description
x number 要请求几何数据的瓦片的 X 坐标。
y number 要请求几何数据的瓦片的 Y 坐标。
level number 要请求几何数据的瓦片的层级。
Returns:
按行优先顺序排列的高度数组，或解析为该数组的 promise。如果为 undefined，地球将渲染父瓦片。
需要帮助？获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。.
CtrlK
packages/engine
packages/widgets