Cesium3DTilesTerrainData

new Cesium.Cesium3DTilesTerrainData(options)

单个地块的地形数据,其中地形数据以 glb(二进制 glTF)形式表示。
Name Type Description
options object Object 具有以下属性:
Name Type Default Description
gltf Object.<string, *> 解析后的 glTF JSON。
minimumHeight number 瓦片内的最低地形高度,以参考椭球体上方的米为单位。
maximumHeight number 瓦片内的最大地形高度,以参考椭球体以上的米为单位。
boundingSphere BoundingSphere 一个包围网格中所有顶点的球体。
orientedBoundingBox OrientedBoundingBox 一个包含网格中所有顶点的定向包围盒。
horizonOcclusionPoint Cartesian3 网格的地平线遮挡点。如果该点位于地平线以下,则假定整个瓷砖也位于地平线以下。该点以椭球缩放坐标表示。
skirtHeight number 裙子的高度添加在瓷砖的边缘上。
requestVertexNormals boolean false optional 指示是否应加载法线。
requestWaterMask boolean false optional 指示是否应加载水体掩膜数据。
credits Array.<Credit> optional 此图块的版权数组。
childTileMask number 15 optional 一个位掩码,指示此瓦片的四个子瓦片中哪些存在。 如果某个子瓦片的位被设置,当需要时也会请求该瓦片的几何信息。 如果该位被清除,则不会请求子瓦片,而是从父瓦片上对几何信息进行上采样。位值如下所示:
Bit PositionBit ValueChild Tile
01Southwest
12Southeast
24Northwest
38Northeast
waterMask Uint8Array optional The buffer containing the water mask.
Experimental

此功能不是最终的,在没有 Cesium 的标准弃用政策的情况下可能会发生变化。

See:

Members

此图块的版权列表。

waterMask : Uint8Array|HTMLImageElement|HTMLCanvasElement|ImageBitmap|undefined

此地形数据中包含的水体掩膜(如果有)。水体掩膜是一个矩形的 Uint8Array 或图像,其中值为 255 表示水域,值为 0 表示陆地。 也允许介于 0 和 255 之间的值,以便在陆地和水域之间平滑过渡。

Methods

interpolateHeight(rectangle, longitude, latitude)number|undefined

返回指定经度和纬度的地形高度,如果网格未定义,则返回未定义。
Name Type Description
rectangle Rectangle 由此地形数据覆盖的矩形。
longitude number 以弧度为单位的经度。
latitude number 以弧度为单位的纬度。
Returns:
指定位置的地形高度,如果网格未定义则返回未定义。 如果位置在矩形之外,此方法将外推高度, 对于矩形之外的远距离位置,高度值可能会极不准确。

isChildAvailable(thisX, thisY, childX, childY)boolean

根据 TerrainData#childTileMask 判断给定的子瓦片是否可用。给定的子瓦片坐标被假定为该瓦片的四个子瓦片之一。如果提供的坐标不是子瓦片坐标,则返回东南子瓦片的可用性。
Name Type Description
thisX number 当前(父)瓦片的瓦片 X 坐标。
thisY number 当前(父)瓦片的瓦片 Y 坐标。
childX number 要检查可用性的子瓦片的瓦片 X 坐标。
childY number 要检查可用性的子瓦片的瓦片 Y 坐标。
Returns:
如果子瓦片可用,返回 true;否则返回 false。

upsample(tilingScheme, thisX, thisY, thisLevel, descendantX, descendantY, descendantLevel)Promise.<TerrainData>|undefined

对该地形数据进行上采样,以供后代瓦片使用。
Name Type Description
tilingScheme TilingScheme 此地形数据的瓦片划分方案。
thisX number 此瓦片在瓦片划分方案中的 X 坐标。
thisY number 此瓦片在瓦片划分方案中的 Y 坐标。
thisLevel number 此瓦片在瓦片划分方案中的级别。
descendantX number 要进行上采样的后代瓦片在瓦片划分方案中的 X 坐标。
descendantY number 要进行上采样的后代瓦片在瓦片划分方案中的 Y 坐标。
descendantLevel number 要进行上采样的后代瓦片在瓦片划分方案中的级别。
Returns:
返回子瓦片的上采样地形数据的 Promise,如果尚未调用 createMesh 或者过多的异步上采样操作正在进行且请求已被延迟,则返回 undefined。

wasCreatedByUpsampling()boolean

获取一个值,指示该地形数据是否是通过对低分辨率地形数据进行上采样生成的。如果该值为 false,则表示数据是从其他来源获取的,例如从远程服务器下载。对于通过调用 Cesium3DTilesTerrainData#upsample 返回的实例,该方法应返回 true。
Returns:
如果此实例是通过上采样创建的,则返回 true;否则返回 false。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.