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

景深后处理

用 DepthOfFieldStage 设定焦平面,让前景清晰、远景虚化。

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

对焦距离怎么定

focalDistance 单位是米,和相机到目标的直线距离同量级。示例里相机离地面 26 米、俯角很小,焦平面落在 55 米外,所以近处盒子清晰、远景楼体虚化。

四个参数

delta 限制弥散圆半径,sigma 决定模糊核强度,stepSize 是采样步长。步长调大会更快,但高对比边缘容易出现明显的空心光斑。

什么时候看不出效果

正俯视时前后景都在同一距离,景深几乎没有变化。需要低视角、有明显前后景层次的构图。

uniform单位作用
focalDistance米焦平面距离
delta像素弥散圆上限
sigma数值模糊强度
stepSize像素采样步长

景深是逐帧的全屏后处理,移动端开销明显;不支持时 isDepthOfFieldSupported 返回 false,示例会直接跳过创建。