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

镜头光晕

用 LensFlareStage 模拟镜头对着太阳时的色散光斑与光环。

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

光晕出现的条件

只有太阳的屏幕位置落在视野内,光晕才会绘制。earthRadius 用来判断太阳是否被地球挡住,所以必须传 Ellipsoid.WGS84.maximumRadius。

三个主要参数

intensity 是整体亮度,distortion 决定色散强度,haloWidth 是光环粗细。ghostDispersal 控制鬼影间距。

性能

光晕是单个全屏 pass,代价固定。enabled 设为 false 即可完全跳过,弱设备可以按场景开关。

uniform建议值说明
intensity1 – 3光晕亮度
distortion5 – 15色散强度
haloWidth0.2 – 0.6光环宽度
earthRadiusWGS84 长半轴遮挡判断用的地球半径

相机背对太阳时光晕会自动消失;如果画面一直没反应,先确认 scene.sun.show 是 true。