TerrainLoaderCesium

TerrainLoaderCesium

通过对一个椭球面进行镶嵌来生成几何图形的地形提供器。TerrainLoader的一种实现。

Constructor

new TerrainLoaderCesium(options)

Author:
  • zpc
Example
var TerrainLoaderCesium = new TerrainLoaderCesium({
    url: Cesium.IonResource.fromAssetId(1),
    name : "Cesium官方地形",
    requestVertexNormals: true,
    requestWaterMask: false
});
Parameters:
Name Type Description
options Object 对象，具有以下属性：
Properties
Name Type Attributes Default Description
assetId Number 资源ID。和options.url任选其一。
id String <optional>
 Cesium.createGuid() 地形ID。
name String <optional>
 "" 地形名称。
url Cesium.Resource | String | Promise.<Cesium.Resource> | Promise.<String> Cesium地形服务器的URL。和options.assetId任选其一。
requestVertexNormals Boolean <optional>
 false 指示客户端是否应该从服务器请求额外的光照信息，以每个顶点法线的形式表示（如果可用）。
requestWaterMask Boolean <optional>
 false 指示客户端是否应该从服务器请求每个瓦片的水掩膜（如果可用）。
requestMetadata Boolean <optional>
 true 指示客户端是否应该从服务器请求每个瓦片元数据（如果可用）。
ellipsoid Cesium.Ellipsoid <optional>
 椭球。如果没有指定，则使用WGS84椭球体。
credit Cesium.Credit | String <optional>
 将显示在画布上的数据源的版权（credit）。

Extends

Members

(readonly) availability :Cesium.TileAvailability

Overrides:
获取一个对象，该对象可用于从该提供器确定地形的可用性，例如在点和矩形中。 在TerrainLoader#ready返回true之前，不应该调用这个函数。如果可用性信息不可用，则此属性可能未定义。
Type:
  • Cesium.TileAvailability

(readonly) credit :Cesium.Credit

Overrides:
获取地形提供器处于活动状态时显示的版权（credit）。通常这是用来确认地形的来源。 在TerrainLoader#ready返回true之前，不应该调用这个函数。
Type:
  • Cesium.Credit

(readonly) errorEvent :Cesium.Event

Overrides:
获取地形提供器遇到异步错误时引发的事件。通过订阅事件， 您将收到错误通知，并可能从中恢复。事件监听器传递一个Cesium.TileProviderError的实例。
Type:
  • Cesium.Event

(readonly) hasVertexNormals :Boolean

Overrides:
获取一个值，指示请求的瓦片是否包含顶点法线。 在TerrainLoader#ready返回true之前，不应该调用这个属性。
Type:
  • Boolean

(readonly) hasWaterMask :Boolean

Overrides:
获取一个值，指示提供器是否包含水掩膜。水掩膜显示了地球上哪些区域是水而不是陆地，因此它们可以被渲染成一个带有波浪的反射面。 在TerrainLoader#ready返回true之前，不应该调用这个属性。
Type:
  • Boolean

(readonly) id :String

Overrides:
获取地形加载器的唯一标识符。
Type:
  • String

(readonly) provider :Cesium.TerrainProvider

Overrides:
获取地形加载器包装的地形提供器。
Type:
  • Cesium.TerrainProvider

(readonly) ready :Boolean

Overrides:
获取一个值，指示提供器是否已能使用。
Type:
  • Boolean

(readonly) readyPromise :Promise.<Boolean>

Overrides:
获取一个约定，当提供器能使用时解析为true。
Type:
  • Promise.<Boolean>

requestMetadata :Boolean

布尔值，指示客户端是否应该从服务器请求元数据。 只有在客户端请求元数据和服务器提供元数据的情况下，元数据才被附加到标准的瓦片网格数据中。
Type:
  • Boolean

requestVertexNormals :Boolean

布尔值，指示客户端是否应该从服务器请求顶点法线。 只有在客户端请求顶点法线和服务器提供顶点法线的情况下，顶点法线数据才被附加到标准的瓦片网格数据中。
Type:
  • Boolean

requestWaterMask :Boolean

布尔值，指示客户端是否应该从服务器请求一个水掩膜。 只有在客户端请求水掩膜并且服务器提供了水掩膜的情况下，才会将水掩膜数据附加到标准的瓦片网格数据中。
Type:
  • Boolean

(readonly) tilingScheme :Cesium.TilingScheme

Overrides:
获取地形提供器使用的切片方案。 在TerrainLoader#ready返回true之前，不应该调用这个函数。
Type:
  • Cesium.TilingScheme

Methods

getLevelMaximumGeometricError(level) → {Number}

Overrides:
获取给定级别瓦片中允许的最大几何误差。
Parameters:
Name Type Description
level Number 要为其获取最大几何误差的瓦片级级。
Returns:
最大几何误差。
Type
Number

getTileDataAvailable(x, y, level) → {Boolean}

Overrides:
确定是否可以加载瓦片的数据。
Parameters:
Name Type Description
x Number 要为其请求几何图形的瓦片的X坐标。
y Number 要为其请求几何图形的瓦片的Y坐标。
level Number 要为其请求几何图形的瓦片的级别。
Returns:
如果地形提供器不支持，则undefined，否则为true或false。
Type
Boolean

loadTileDataAvailability(x, y, level) → {undefined|Promise}

Overrides:
确保为瓦片加载可用性数据。
Parameters:
Name Type Description
x Number 要为其请求几何图形的瓦片的X坐标。
y Number 要为其请求几何图形的瓦片的Y坐标。
level Number 要为其请求几何图形的瓦片的级别。
Returns:
如果不需要加载任何内容则为undefined，或者在所需的瓦片加载完成时解析的出的约定。
Type
undefined | Promise

requestTileGeometry(x, y, level, requestopt) → {Promise.<Cesium.TerrainData>|undefined}

Overrides:
请求给定瓦片的几何图形。在TerrainLoaderCesium#ready返回true之前，不应该调用这个函数。 结果必须包括地形数据，并可以选择包括一个水掩模和哪些子瓦片可用的指示。
Parameters:
Name Type Attributes Description
x Number 要为其请求几何图形的瓦片的X坐标。
y Number 要为其请求几何图形的瓦片的Y坐标。
level Number 要为其请求几何图形的瓦片的级别。
request Cesium.Request <optional>
 请求对象。仅供内部使用。
Throws:
在TerrainLoaderCesium#ready返回true之前，不能调用此函数。
Type
Cesium.DeveloperError
Returns:
请求的几何图形的约定。 如果此方法返回undefined而不是约定（promise），则表示有太多请求已经挂起，稍后将重试请求。
Type
Promise.<Cesium.TerrainData> | undefined