经纬志
首页 / Cesium / 使用示例

地下颜色

设置球体的地下颜色,让看穿地表的部分有明确的视觉标识。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

它解决什么问题

相机贴近地表时,视线会越过地平线看到球体背面,那里没有地表数据,默认是黑色或异常颜色。给地下部分一个明确的颜色,用户能立刻判断这是「地下」而不是加载失败。

按距离渐变

undergroundColorAlphaByDistance 为 true 时,地下颜色随相机与地表的距离调整透明度,避免在正常视角下颜色过重。示例设为 false 以便看清效果。

属性类型说明
undergroundColorColor地下部分颜色
undergroundColorAlphaByDistance布尔是否按距离渐变
enableCollisionDetection布尔是否允许贴近地表

地下颜色会与地形挖洞同时出现;如果只想表达挖洞,不需要关闭碰撞检测,把相机抬高即可。