cesium添加实体不被地形遮挡的参数设置

### Cesium 中添加组件被地球模型遮挡解决方案 在开发基于 Cesium 的应用时，可能会遇到所添加的自定义组件（如标记、弹窗或其他图形对象）被地球表面或地形遮挡的情况。为了有效处理这一问题，可以采取多种策略来确保这些组件始终可见。 #### 使用 `viewer.scene.globe.depthTestAgainstTerrain` 通过设置此属性可控制渲染过程中是否执行深度测试以防止物体被地形覆盖。当该选项设为 `false` 时，所有绘制的对象都将忽略地形的存在而直接显示于最顶层[^1]： ```javascript viewer.scene.globe.depthTestAgainstTerrain = false; ``` 然而，在某些情况下完全禁用深度检测可能不是最佳选择，因为这会影响场景的真实感和其他交互效果。因此建议仅针对特定需要保持前置状态的元素调整其渲染顺序或透明度等样式特性。 #### 设置实体的高度偏移量 对于希望固定位置但又不想受制于地面高度变化影响的小部件来说，可以通过增加它们相对于地平面的位置参数值使其浮起一定距离之上从而避开潜在障碍物的影响。例如创建一个带有指定海拔增量的点位标注[^3]: ```javascript const entity = viewer.entities.add({ position : Cesium.Cartesian3.fromDegrees(longitude, latitude, altitudeOffset), // 经纬度坐标加上额外高度offset }); ``` 这里的关键在于合理设定 `altitudeOffset` 参数大小，既能够解决问题也不至于让UI显得突兀不自然。 #### 利用地形提供者事件监听器动态调整 如果应用程序中有频繁变动的内容，则考虑利用Cesium内置API中的回调机制实时监控并响应地形加载完成后的状况改变。比如下面这段代码展示了如何结合异步函数获取全球高程数据后再做相应操作的方法: ```javascript import { createWorldTerrainAsync } from 'cesium'; async function adjustComponentVisibility(viewer) { try { const terrainProvider = await createWorldTerrainAsync(); viewer.terrainProvider = terrainProvider; // 假定有一个名为componentToAdjust的DOM节点需调节可视性逻辑... } catch (error) { console.error('Failed to load and apply world terrain:', error); } } ``` 以上三种方式可以根据实际需求单独或者组合运用，灵活应对不同类型的视觉冲突挑战。