Cesium3DTilesTerrainData

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东北
waterMask Uint8Array optional 包含水域掩码的缓冲区。
实验性

此功能尚未定型,可能会在未遵循 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:
指定位置处的地形高度,如果网格未定义则返回 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;否则为 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。
需要帮助?获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。