PostProcessStage 和/或 PostProcessStageComposite 的集合。
每个后处理阶段的输入纹理是由场景渲染的纹理或由集合中上一个阶段渲染的纹理。
如果启用了环境光遮蔽或辉光阶段,它们将在所有其他阶段之前执行。
如果启用了 FXAA 阶段,它将在所有其他阶段之后执行。
Members
readonly ambientOcclusion : PostProcessStageComposite
环境光遮蔽模拟来自环境光的阴影。这些阴影在表面接收光线时始终存在,无论光源的位置如何。
uniforms 具有以下属性: intensity、bias、lengthCap、
stepSize、frustumLength、ambientOcclusionOnly、
delta、sigma 和 blurStepSize。
intensity是一个标量值,用于以指数方式增强或减弱阴影。较高的值使阴影变得更深。默认值为3.0。bias是代表弧度的标量值。如果样本的法线与指向相机的向量之间的点积小于此值, 则在当前方向上停止采样。这用于消除近似平面边缘的阴影。默认值为0.1。lengthCap是一个标量值,表示以米为单位的长度。如果当前样本到第一个样本的距离大于此值, 则在当前方向上停止采样。默认值为0.26。stepSize是一个标量值,表示当前方向上下一个纹理样本的距离。默认值为1.95。frustumLength是一个以米为单位的标量值。如果当前片段与相机的距离大于此值,则不计算该片段的环境光遮蔽。 默认值为1000.0。ambientOcclusionOnly是一个布尔值。当true时,仅生成的阴影会写入输出。当false时,输入纹理会与环境光遮蔽进行调制。 这是一个有用的调试选项,可以查看更改 uniform 值的效果。默认值为false。
delta、sigma 和 blurStepSize 是与 PostProcessStageLibrary#createBlurStage 相同的属性。
模糊应用于从图像生成的阴影,以使其更平滑。
启用时,该阶段将在所有其他阶段之前执行。
辉光效果添加了发光效果,使亮区更亮,暗区更暗。
此阶段具有以下 uniforms: contrast、brightness、glowOnly、
delta、sigma 和 stepSize。
contrast是范围为 [-255.0, 255.0] 的标量值,影响效果的对比度。默认值为128.0。brightness是一个标量值。输入纹理的 RGB 值被转换为色调、饱和度和亮度 (HSB),然后将这个值添加到亮度中。默认值为-0.3。glowOnly是一个布尔值。当true时,仅显示辉光效果;当false时,辉光将添加到输入纹理中。 默认值为false。这是一个调试选项,用于查看更改其他 uniform 值时的效果。
delta、sigma 和 stepSize 是与 PostProcessStageLibrary#createBlurStage 相同的属性。
模糊应用于从图像生成的阴影,以使其更平滑。
启用时,该阶段将在所有其他阶段之前执行。
-
Default Value:
1.0
Example:
viewer.scene.postProcessStages.exposure = 1.0;
启用时,该阶段将在所有其他阶段之后执行。
-
Default Value:
Tonemapper.PBR_NEUTRAL
Example:
viewer.scene.postProcessStages.tonemapper = Cesium.Tonemapper.ACES;
Methods
add(stage) → PostProcessStage|PostProcessStageComposite
| Name | Type | Description |
|---|---|---|
stage |
PostProcessStage | PostProcessStageComposite | 要添加到集合中的后处理阶段。 |
Returns:
Throws:
-
DeveloperError : 后处理阶段已被添加到集合中或没有唯一名称。
| Name | Type | Description |
|---|---|---|
stage |
PostProcessStage | PostProcessStageComposite | 后处理阶段。 |
Returns:
一旦对象被销毁,就不应使用;调用除 isDestroyed 之外的任何功能将导致 DeveloperError 异常。因此,
将返回值 (undefined) 赋给对象,如示例中所示。
Throws:
-
DeveloperError : 此对象已被销毁,即调用了 destroy()。
get(index) → PostProcessStage|PostProcessStageComposite
index 的后处理阶段。
| Name | Type | Description |
|---|---|---|
index |
number | 后处理阶段的索引。 |
Returns:
如果此对象已被销毁,则不应使用;调用除 isDestroyed 之外的任何功能将导致 DeveloperError 异常。
Returns:
true;否则返回 false。
| Name | Type | Description |
|---|---|---|
stage |
PostProcessStage | PostProcessStageComposite | 要从集合中移除的后处理阶段。 |
