STKTerrainProvider - Cesium Documentation

new LSGlobe.STKTerrainProvider(options)

以LSGlobe地形格式访问地形数据的TerrainProvider

Name Type Description

options

Object

对象具有以下属性:

Name	Type	Default	Description
`url`	String		LSGlobe地形服务器的URL
`proxy`	Proxy		optional 用于请求的代理。如果需要，这个对象预计会有一个getURL函数返回代理URL
`requestVertexNormals`	Boolean	`false`	optional 以每个顶点法线（如果可用）的形式，指示客户端是否应该从服务器请求额外照明信息的标志
`requestWaterMask`	Boolean	`false`	optional 指示客户端是否应该从服务器请求每个磁盘水面罩的标志（如果可用）
`ellipsoid`	Ellipsoid		optional 椭球体。默认使用WGS84椭球体
`credit`	Credit \| String		optional credit的数据源，其被显示在canvas上

Example:

// 构建一个地形，它使用每个顶点法线进行照明，以将阴影细节添加到terrain provider
var terrainProvider = new LSGlobe.STKTerrainProvider({
    url : 'https://assets.agi.com/stk-terrain/v1/tilesets/world/tiles',
    requestVertexNormals : true
});

//  使用NaturalEarthII影像时，地球表面附近的地形几何图形很难观看，除非TerrainProvider提供了额外的照明信息来遮蔽地形
var imageryProvider = LSGlobe.createTileMapServiceImageryProvider({
       url : 'http://localhost:8080/Source/Assets/Textures/NaturalEarthII',
       fileExtension : 'jpg'
   });

var viewer = new LSGlobe.Viewer('cesiumContainer', {
    imageryProvider : imageryProvider,
    baseLayerPicker : false,
    terrainProvider : terrainProvider
});

//  globe必须使lightingT能够利用地形的顶点法线
viewer.scene.globe.enableLighting = true;

See:

TerrainProvider

Members

availability : TileAvailability

获取可用于确定此提供者的地形可用性的对象，例如点和矩形。此函数不应在STKTerrainProvider#ready 返回true之前调用。如果可用性信息不可用，则此属性可能未定义

credit : Credit

获取credit以在此地形提供者处于活动状态时显示。通常这用于表明地形的来源。此函数不应在STKTerrainProvider#ready返回true之前调用

errorEvent : Event

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

hasVertexNormals : Boolean

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

hasWaterMask : Boolean

获取一个值，指示提供者是否包含水面。水面指示地球的哪些区域是水而不是陆地，所以它们可以被渲染成具有动画波的反射表面。此函数不应在STKTerrainProvider#ready返回true之前调用

ready : Boolean

获取一个值，指示提供者是否已准备好使用

readonlyreadyPromise : Promise.<Boolean>

当提供者允许使用时，解析为true

requestVertexNormals : Boolean

Boolean，指示客户端是否应从服务器请求顶点法线。只有当客户端请求顶点法线并且服务器提供顶点法线时，顶点法线数据才会附加到标准瓦片网格数据

requestWaterMask : Boolean

Boolean，指示客户端是否应从服务器请求水印。仅当客户端请求水印以及服务器是否提供水印时，水印数据才会附加到标准瓦片网格数据

tilingScheme : GeographicTilingScheme

获取此提供程序使用的切片方案。此函数不应在STKTerrainProvider#ready返回true之前调用

Methods

getLevelMaximumGeometricError(level) → Number

获得给定级别的tile允许的最大几何误差

Name	Type	Description
`level`	Number	获得tile级别的最大几何误差

Returns:

最大几何误差

getTileDataAvailable(x, y, level) → Boolean

确定是否可以加载图块的数据

Name	Type	Description
`x`	Number	请求tile的几个图形的X坐标
`y`	Number	请求tile的几个图形的Y坐标
`level`	Number	请求tile的几个图形的级别

Returns:

未定义（如果不支持），否则为true或false

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

请求给定tile的几何图形。此函数不应在STKTerrainProvider#ready 返回true之前调用。结果必须包含地形数据，并且可以选择包含水面和指示哪些子瓦片可用

Name	Type	Description
`x`	Number	请求tile的几何图形的X坐标
`y`	Number	请求tile的几何图形的Y坐标
`level`	Number	请求tile的几何图形的级别
`request`	Request	optional 请求对象

Returns:

所请求的几何图形。如果此方法返回的是未定义，则表明太多请求已处于待处理状态，并且稍后将重新尝试请求

Throws:

DeveloperError : 在STKTerrainProvider#ready返回true之前，不能调用此函数