CustomHeightmapTerrainProvider - CesiumJS API 文档

new Cesium.CustomHeightmapTerrainProvider(options)

A simple TerrainProvider that gets height values from a callback function. 它可用于程序生成的地形或作为加载自定义的方法 heightmap data without creating a subclass of TerrainProvider. 有一些限制,如没有水面具,没有顶点正常,没有 availability, so a full-fledged TerrainProvider subclass is better suited 这些更复杂的案件.

Name Type Description

options

object

下列属性的对象 :

Name	Type	Default	Description
`callback`	CustomHeightmapTerrainProvider.GeometryCallback		请求平面几何的调用函数 .
`width`	number		每高地图瓦的列数.
`height`	number		每高地映射牌的行数.
`tilingScheme`	TilingScheme		optional 说明椭圆的平板方案 surface is broken into tiles. If this parameter is not provided, a `GeographicTilingScheme` is used.
`ellipsoid`	Ellipsoid	`Ellipsoid.default`	optional The ellipsoid. If the tilingScheme is specified, 此参数被忽略, 并使用平面图的椭圆形。如果没有指定参数,使用默认椭圆.
`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:

TerrainProvider

Members

readonly availability : TileAvailability

从此提供者获取一个可用于确定地形可用的对象, 例如在点和矩形上。如果可用, 此属性可能未定义资料不详.

readonly credit : Credit

当此地形提供者活动时, 获取信用值以显示。通常,这是用来信用的地形的来源.

readonly errorEvent : Event

获得一个在地形提供者遇到同步错误时上升的事件。通过签名对事件,您将被通知错误,并有可能从中恢复。活动听众 are passed an instance of TileProviderError.

readonly hasVertexNormals : boolean

获得一个表示所请求的牌是否包含顶点正常值的值. Vertex normals are not supported by CustomHeightmapTerrainProvider, so the return 价值将永远是虚假的.

readonly hasWaterMask : boolean

获得一个表示提供者是否包含水面罩的值。那个水面罩说明全球哪些地区是水而不是土地,以便加以制造作为带有动画波的反射面. Water mask is not supported by CustomHeightmapTerrainProvider, so the return 价值将永远是虚假的.

readonly height : boolean

获得每高地图砖的行数.

readonly tilingScheme : TilingScheme

获得此提供者使用的平板方案 .

readonly width : boolean

获得每个高地图砖的柱数.

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:

如果不需要加载, 或装入需要的牌时解决的 NT% 0 则未定义

requestTileGeometry(x, y, level, request) → Promise.<TerrainData>|undefined

请求给定的瓦片的几何。结果包括地形数据,并表明所有的儿童瓷砖都有.

Name	Type	Description
`x`	number	用于请求几何的瓷砖的X坐标.
`y`	number	用于请求几何的瓦片的Y坐标.
`level`	number	用于请求几何的瓦片的级别.
`request`	Request	optional 请求对象。仅供内部使用.

Returns:

对要求的几何学的承诺. 如果这种方法返回未定义而不是承诺,这表明已经有很多请求待决,请求将在晚些时候重新审理.

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:

数组或对数组高度的许诺,按行号顺序排列。如果未定义, 地球会使母牌变为 .