Cesium3DTilesTerrainProvider - CesiumJS API 文档

new Cesium.Cesium3DTilesTerrainProvider(options)

要构造一个Cesium3DTILESTrain Provider,请拨打 Cesium3DTilesTerrainProvider.fromIonAssetId 或 Cesium3DTilesTerrainProvider.fromUrl . 不要直接给建筑师打电话.

A TerrainProvider that accesses terrain data in a 3D Tiles format.

Name	Type	Description
`options`	Cesium3DTilesTerrainProvider.ConstructorOptions	optional An object describing initialization options

Experimental

This feature is not final and is subject to change without Cesium's standard deprecation policy.

See:

TerrainProvider
Cesium3DTilesTerrainProvider.fromUrl
Cesium3DTilesTerrainProvider.fromIonAssetId // Create GTOPO30 with vertex normals try { const viewer = new Cesium.Viewer("cesiumContainer", { terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, { requestVertexNormals: true }) }); } catch (error) { console.log(error); }

Members

availability : TileAvailability|undefined

从此提供者获取一个可用于确定地形可用的对象, 例如在点和矩形上.

credit : Credit

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

errorEvent : Event

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

hasVertexNormals : boolean

获得一个表示所请求的牌是否包含顶点正常值的值.

hasWaterMask : boolean

获得一个表示提供者是否包含水面罩的值。那个水面罩说明全球哪些地区是水而不是土地,以便加以制造作为带有动画波的反射面.

tilingScheme : TilingScheme

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

Methods

static Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(assetId, options) → Promise.<CesiumTerrainProvider>

Creates a TerrainProvider from a Cesium ion asset ID that accesses terrain data in a Cesium 3D Tiles format

Name	Type	Description
`assetId`	number	The Cesium ion asset id.
`options`	CesiumTerrainProvider.ConstructorOptions	optional 一个描述初始化选项的对象 .

Returns:

Throws:

RuntimeError : layer.json does not specify a format
RuntimeError : layer.json specifies an unknown format
RuntimeError : layer.json specifies an unsupported quantized-mesh version
RuntimeError : layer.json does not specify a tiles property, or specifies an empty array
RuntimeError : layer.json does not specify any tile URL templates

Example:

// Create GTOPO30 with vertex normals
try {
  const viewer = new Cesium.Viewer("cesiumContainer", {
    terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, {
        requestVertexNormals: true
    })
  });
} catch (error) {
  console.log(error);
}

static Cesium.Cesium3DTilesTerrainProvider.fromUrl(url, options) → Promise.<Cesium3DTilesTerrainProvider>

Creates a TerrainProvider that accesses terrain data in a Cesium 3D Tiles format.

Name	Type	Description
`url`	Resource \| string \| Promise.<Resource> \| Promise.<string>	Cesium 地形服务器的 URL .
`options`	Cesium3DTilesTerrainProvider.ConstructorOptions	optional 一个描述初始化选项的对象 .

Returns:

一个能解决地形问题的承诺.

Example:

// Create terrain with normals.
try {
  const viewer = new Cesium.Viewer("cesiumContainer", {
    terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromUrl(
      Cesium.IonResource.fromAssetId(3956), {
        requestVertexNormals: true
    })
  });
} catch (error) {
  console.log(error);
}

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:

Undefined if not supported or availability is unknown, otherwise true or false.

loadTileDataAvailability(_x, _y, _level) → Promise.<void>|undefined

确保加载一个瓦片的可用数据

Name	Type	Description
`_x`	number	用于请求几何的瓷砖的X坐标.
`_y`	number	用于请求几何的瓦片的Y坐标.
`_level`	number	用于请求几何的瓦片的级别.

Returns:

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

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

请求给定的瓦片的几何。此函数不应在 Cesium3DTilesTerrainProvider#ready returns true. The result must include terrain data and 可选择包括一个水面罩,并注明有哪些儿童瓷砖.

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

Returns:

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

Type Definitions

Cesium.Cesium3DTilesTerrainProvider.ConstructorOptions

Cesium3DTILESTrain 设计器的初始化选项

Properties:

Name	Type	Attributes	Default	Description
`requestVertexNormals`	boolean	<optional>	false	Flag that indicates if the client should request additional lighting information from the server, in the form of per vertex normals if available.
`requestWaterMask`	boolean	<optional>	false	Flag that indicates if the client should request per tile water masks from the server, if available.
`ellipsoid`	Ellipsoid	<optional>	Ellipsoid.default	The ellipsoid. If not specified, the WGS84 ellipsoid is used.
`credit`	Credit \| string	<optional>		数据源的信用,在画布上显示.