外观
设置贴地、贴模型操作
约 1094 字
如何设置贴地、贴模型
按需进行选择:
- 设置贴地参数 clampToGround 为 true,需查看对应 API,确认存在该参数后才可设置;
自该版本起将同时支持贴模型和贴地形,HeightReference 单独控制;

早期版本点对象不支持贴模型;自 v3.7.3 起
clampToGround: true已同时支持贴模型和贴地形(HeightReference单独控制贴模型或贴地形)该参数会影响效率,在大数据量或军事标绘场景下不建议使用
先计算高度值,再将结果赋值给坐标
在对应的矢量 API 页面中,查看是否有 autoSurfaceHeight 方法,如有可直接调用;
例如 fixedRoute 对象,可在功能示例代码中全局搜索查看;

对 GraphiLayer 图层也可使用该方法,具体可参考示例代码;
对于墙这类没有贴地参数的矢量,如何让其底部贴地?
这类矢量需要通过计算实现,可查看 API:求路线的贴地线坐标(插值)。 具体用法可参考示例:行政区突出展示
贴模型时,如何让矢量排除部分模型不进行计算
- 对矢量设置 objectsToExclude 参数;
// graphic是加载的矢量;arrModel是被排除的模型
graphic.objectsToExclude = arrModel;- 在计算时设置 objectsToExclude 参数;

矢量设置 clampToGround 参数后,popup 弹出的位置存在偏差
popupOptions 中的参数也需要同时设置贴地参数。
矢量设置 clampToGround 参数后,拾取与点击获取的对象不一致
这是 Cesium 本身的问题,entity 贴地对象存在拾取异常,可换成 primitive 或 Combine 对象。
DivGraphic 矢量设置贴地后,视觉上未贴地
DivGraphic 矢量的位置不仅与坐标有关,与 CSS 样式也有关系; 可打开 testPoint 测试点,对比调整 CSS
// 打开测试点,与DIV点进行对比位置调整css
descGraphic.testPoint = true;PathEntity 的线被模型挡住,autoSurfaceHeight 不生效
autoSurfaceHeight 依赖当前已加载的地形或模型。如果地图刚创建就调用,地形往往尚未就绪,计算出的高度是错误的。
可以先等待地形加载完成:
await map.terrainPromise再按现有线坐标生成贴地线。如果线段仍然穿模,可用 PolyUtil.computeSurfaceLine 做插值,按模型表面采样高程后再赋回坐标。
面或注记设置了 clampToGround 后,需要移动一下地图才能正确贴地
贴地高度按当前已加载的地形计算,地形加载完成后不会自动重算。初始化时地形瓦片尚未到达,注记会挤在一起或产生漂移。
处理方式:
await map.terrainPromise之后再添加矢量。- 注记被地形裁切时,可改为不贴地,用高度将其抬升:
label: {
text: attr.name,
font_size: 16,
color: "#000",
clampToGround: false,
visibleDepth: true,
addHeight: 1000
}addHeight 按实际遮挡情况调整,过小会被地形截断。
矢量贴模型时如何避免显示在模型下方
回复默认贴地时,矢量会显示在模型下方。若需要矢量只贴附到 3D Tiles 模型而不参与地形,需设置 classificationType 参数:classificationType: Cesium.ClassificationType.CESIUM_3D_TILEshp 面贴地卡顿与贴合的权衡
1、三维场景已加载地形数据,开启地形遮挡功能;
2、导入行政区域面 SHP 矢量数据,矢量图层核心配置参数 clampToGround: true;
3、统一固定高度抬升矢量:地形高地位置矢量仍被掩埋,地形低洼处矢量悬空漂浮,效果不贴合真实地形;
需求 1、行政区域面如何既要贴合地形,又要流畅加载
回复方案一(既贴合又流畅,推荐): 首次加载时读取各面的位置数据,计算并保存该面的贴地高度;下次加载时直接赋值保存的高度,避免运行时逐点实时求高。
方案二(最省性能): 若业务允许,不开启深度检测,直接依赖 clampToGround,流畅度最好。
方案三(不推荐): 批量加统一固定高度,无法贴合复杂地形,即当前遇到的问题。
