以
TerrainProvider
地形格式访问地形数据的 TerrainProvider。地形格式可以是以下之一:
Name | Type | Description | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的对象:
|
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
readonly availability : TileAvailability
获取一个对象,该对象可用于确定来自此提供程序的地形的可用性,例如点和矩形。在
CesiumTerrainProvider#ready
返回 true 之前不应调用此函数。如果可用性信息不可用,则此属性可能未定义。请注意,这反映了当前已知可用的图块。将来可能会发现额外的瓦片可用,例如,如果可用性信息存在于树的更深处,而不是在根处都可以发现。但是,现在可用的图块将来不会变得不可用。
readonly credit : Credit
当此地形提供者处于活动状态时,获得要显示的功劳。通常,这用于记录地形的来源。在
CesiumTerrainProvider#ready
返回 true 之前不应调用此函数。
readonly errorEvent : Event
获取当地形提供者遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个
TileProviderError
实例。
获取一个值,该值指示请求的图块是否包含元数据。在
CesiumTerrainProvider#ready
返回 true 之前不应调用此函数。
获取一个值,该值指示请求的图块是否包括顶点法线。在
CesiumTerrainProvider#ready
返回 true 之前不应调用此函数。
获取一个值,该值指示提供者是否包含水面具。水面罩指示地球的哪些区域是水而不是陆地,因此可以将它们渲染为带有动画波浪的反射表面。在
CesiumTerrainProvider#ready
返回 true 之前不应调用此函数。
获取一个值,该值指示提供程序是否已准备好使用。
当提供者准备好使用时,获取一个解析为 true 的承诺。
指示客户端是否应从服务器请求元数据的布尔标志。仅当客户端请求元数据并且服务器提供元数据时,元数据才会附加到标准瓦片网格数据。
指示客户端是否应从服务器请求顶点法线的布尔标志。仅当客户端请求顶点法线并且服务器提供顶点法线时,顶点法线数据才会附加到标准瓦片网格数据。
指示客户端是否应从服务器请求水掩码的布尔标志。仅当客户端请求水罩并且服务器提供水罩时,水罩数据才会附加到标准瓦片网格数据。
readonly tilingScheme : GeographicTilingScheme
获取此提供程序使用的切片方案。在
CesiumTerrainProvider#ready
返回 true 之前不应调用此函数。
Methods
获取给定级别的图块中允许的最大几何误差。
Name | Type | Description |
---|---|---|
level
|
Number | 获得最大几何误差的切片级别。 |
Returns:
最大几何误差。
确定是否可以加载磁贴的数据。
Name | Type | Description |
---|---|---|
x
|
Number | 要为其请求几何图形的图块的 X 坐标。 |
y
|
Number | 要为其请求几何图形的图块的 Y 坐标。 |
level
|
Number | 为其请求几何图形的图块的级别。 |
Returns:
如果不支持或可用性未知,则未定义,否则为真或假。
确保我们加载磁贴的可用性数据
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:
-
DeveloperError : 在
CesiumTerrainProvider#ready
返回 true 之前,不得调用此函数。