CesiumTerrainProvider

new Cesium.CesiumTerrainProvider (options)

TerrainProvider 地形格式访问地形数据的 TerrainProvider。地形格式可以是以下之一:
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
url 资源 | 字符串 | 承诺。< 资源 > | 承诺。<String> Cesium 地形服务器的 URL。
requestVertexNormals 布尔值 false 可选 标志,指示客户端是否应从服务器请求额外的照明信息,如果可用,以每个顶点法线的形式。
requestWaterMask 布尔值 false 可选 标志,指示客户端是否应从服务器请求每个瓷砖水面具(如果可用)。
requestMetadata 布尔值 true 可选 标志,指示客户端是否应从服务器请求每个图块元数据(如果可用)。
ellipsoid 椭球体 可选 椭圆体。如果未指定,则使用 WGS84 椭球。
credit 信用 | 细绳 可选 数据源的功劳,显示在画布上。
Example:
// Create Arctic DEM terrain with normals.
const viewer = new Cesium.Viewer('cesiumContainer', {
    terrainProvider : new Cesium.CesiumTerrainProvider({
        url : Cesium.IonResource.fromAssetId(3956),
        requestVertexNormals : true
    })
});
See:

Members

获取一个对象,该对象可用于确定来自此提供程序的地形的可用性,例如点和矩形。在 CesiumTerrainProvider#ready 返回 true 之前不应调用此函数。如果可用性信息不可用,则此属性可能未定义。请注意,这反映了当前已知可用的图块。将来可能会发现额外的瓦片可用,例如,如果可用性信息存在于树的更深处,而不是在根处都可以发现。但是,现在可用的图块将来不会变得不可用。
当此地形提供者处于活动状态时,获得要显示的功劳。通常,这用于记录地形的来源。在 CesiumTerrainProvider#ready 返回 true 之前不应调用此函数。
获取当地形提供者遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个 TileProviderError 实例。

readonly hasMetadata : Boolean

获取一个值,该值指示请求的图块是否包含元数据。在 CesiumTerrainProvider#ready 返回 true 之前不应调用此函数。

readonly hasVertexNormals : Boolean

获取一个值,该值指示请求的图块是否包括顶点法线。在 CesiumTerrainProvider#ready 返回 true 之前不应调用此函数。

readonly hasWaterMask : Boolean

获取一个值,该值指示提供者是否包含水面具。水面罩指示地球的哪些区域是水而不是陆地,因此可以将它们渲染为带有动画波浪的反射表面。在 CesiumTerrainProvider#ready 返回 true 之前不应调用此函数。
获取一个值,该值指示提供程序是否已准备好使用。

readonly readyPromise : Promise.<Boolean>

当提供者准备好使用时,获取一个解析为 true 的承诺。

readonly requestMetadata : Boolean

指示客户端是否应从服务器请求元数据的布尔标志。仅当客户端请求元数据并且服务器提供元数据时,元数据才会附加到标准瓦片网格数据。

readonly requestVertexNormals : Boolean

指示客户端是否应从服务器请求顶点法线的布尔标志。仅当客户端请求顶点法线并且服务器提供顶点法线时,顶点法线数据才会附加到标准瓦片网格数据。

readonly requestWaterMask : Boolean

指示客户端是否应从服务器请求水掩码的布尔标志。仅当客户端请求水罩并且服务器提供水罩时,水罩数据才会附加到标准瓦片网格数据。
获取此提供程序使用的切片方案。在 CesiumTerrainProvider#ready 返回 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

请求给定图块的几何图形。在 CesiumTerrainProvider#ready 返回 true 之前不应调用此函数。结果必须包含地形数据,并且可以选择包含水掩膜和哪些子图块可用的指示。
Name Type Description
x Number 要为其请求几何图形的图块的 X 坐标。
y Number 要为其请求几何图形的图块的 Y 坐标。
level Number 为其请求几何图形的图块的级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对所请求几何的承诺。如果此方法返回 undefined 而不是 promise,则表明已经有太多请求处于未决状态,稍后将重试该请求。
Throws: