# 景深
景深是指当焦点对准某一点时，其前后都仍可清晰的范围。它能决定是把背景模糊化来突出拍摄对象，还是拍出清晰的背景。
景深效果是模拟摄像机镜头对焦特性的一种常见的后处理效果。
# 初始化
使用DepthOfField类添加景深效果。
import {
Postprocessing,
DepthOfField
} from '@tx3d/postprocessing';
// 创建后处理类
const postprocessing = new Postprocessing( engine );
// 使用后期处理
engine.sceneRenderer.postprocessing = postprocessing;
// 添加后处理效果
const effect = postprocessing.addEffect( DepthOfField, {
resolutionY: 480, // 分辨率
worldFocusDistance: 70, // 焦距
worldFocusRange: 120, // 模糊范围
bokehScale: 2, // 模糊度
} );
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
提示
景深初始化参数，详见DepthOfFieldParams。
# 属性
🌏 worldFocusDistance 焦距
// 设置焦距
effect.worldFocusDistance = 70;
1
2
2
🌏 worldFocusRange 模糊范围
// 设置模糊范围
effect.worldFocusRange = 120;
1
2
2
🌏 bokehScale 模糊度
// 设置模糊度
effect.bokehScale = 2;
1
2
2