Cesium3DTilesTerrainData
Cesium v1.147 · 中文

new Cesium.Cesium3DTilesTerrainData(options)

单个瓦片的地形数据以 glb(二进制 glTF)格式呈现。
Name Type Description
options 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 指示该瓦片的四个子瓦片中哪些存在的位掩码。 如果某个子瓦片的位被设置,当该子瓦片 需要时,也会请求其几何数据。如果位被清除,则不会请求该子瓦片的几何数据,而是从父瓦片进行上采样。位值如下:
位位置位值子瓦片
01西南
12东南
24西北
38东北
312北
waterMask Uint8Array optional 包含水掩模的缓冲区。
Experimental

This 该特征尚未最终确定,可能会根据 Cesium 的标准弃用政策发生变化。

See:

Members

此瓦片的致谢列表。

waterMask : Uint8Array|HTMLImageElement|HTMLCanvasElement|ImageBitmap|undefined

如果有的话,此地形数据中包含的水掩模。水掩模是一个矩形 Uint8Array 或图像,其中值 255 表示水域,值 0 表示陆地。 0 到 255 之间的数值也被允许,用于平滑地过渡陆地和水域。

Methods

interpolateHeight(rectangle, longitude, latitude) → number|undefined

返回指定经度和纬度处的地形高度,如果网格未定义则返回 undefined。
Name Type Description
rectangle Rectangle 此地形数据所覆盖的矩形区域。
longitude number 以弧度表示的经度。
latitude number 以弧度表示的纬度。
Returns:
The 指定位置处的地形高度,如果网格未定义则返回 undefined。 如果位置在矩形区域之外,此方法将外推高度, 对于矩形区域外的位置,这种外推结果很可能非常不准确。

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 如果子瓦片可用,则为 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:
A 对于子 tile 的放大地形数据承诺值,如果尚未调用 createMesh 或正在执行过多异步放大操作导致请求被延迟,则值为 undefined。

wasCreatedByUpsampling() → boolean

获取一个值指示此地形数据是否通过放大低分辨率数据创建。 地形数据。如果此值为 false,则数据来自其他来源,例如从远程服务器下载。此方法对于通过 Cesium3DTilesTerrainData#upsample 调用得到的实例应返回 true。 如果此实例是通过放大创建的,则值为 true;否则为 false。 returned from a call to Cesium3DTilesTerrainData#upsample.
Returns:
True 地形网格。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.