PostProcessStageCollection

new Cesium.PostProcessStageCollection()

一个 PostProcessStage 和/或 PostProcessStageComposite 的集合。

每个后处理阶段的输入纹理是由场景渲染的纹理或由集合中上一个阶段渲染的纹理。

如果启用了环境光遮蔽或辉光阶段,它们将在所有其他阶段之前执行。

如果启用了 FXAA 阶段,它将在所有其他阶段之后执行。

Members

一个后处理阶段,它对输入纹理应用基于地平线的环境光遮蔽 (HBAO)。

环境光遮蔽模拟来自环境光的阴影。这些阴影在表面接收光线时始终存在,无论光源的位置如何。

uniforms 具有以下属性: intensitybiaslengthCapstepSizefrustumLengthambientOcclusionOnlydeltasigmablurStepSize

  • intensity 是一个标量值,用于以指数方式增强或减弱阴影。较高的值使阴影变得更深。默认值为 3.0
  • bias 是代表弧度的标量值。如果样本的法线与指向相机的向量之间的点积小于此值, 则在当前方向上停止采样。这用于消除近似平面边缘的阴影。默认值为 0.1
  • lengthCap 是一个标量值,表示以米为单位的长度。如果当前样本到第一个样本的距离大于此值, 则在当前方向上停止采样。默认值为 0.26
  • stepSize 是一个标量值,表示当前方向上下一个纹理样本的距离。默认值为 1.95
  • frustumLength 是一个以米为单位的标量值。如果当前片段与相机的距离大于此值,则不计算该片段的环境光遮蔽。 默认值为 1000.0
  • ambientOcclusionOnly 是一个布尔值。当 true 时,仅生成的阴影会写入输出。当 false 时,输入纹理会与环境光遮蔽进行调制。 这是一个有用的调试选项,可以查看更改 uniform 值的效果。默认值为 false

deltasigmablurStepSize 是与 PostProcessStageLibrary#createBlurStage 相同的属性。 模糊应用于从图像生成的阴影,以使其更平滑。

启用时,该阶段将在所有其他阶段之前执行。

一个用于辉光效果的后处理阶段。

辉光效果添加了发光效果,使亮区更亮,暗区更暗。

此阶段具有以下 uniforms: contrastbrightnessglowOnlydeltasigmastepSize

  • contrast 是范围为 [-255.0, 255.0] 的标量值,影响效果的对比度。默认值为 128.0
  • brightness 是一个标量值。输入纹理的 RGB 值被转换为色调、饱和度和亮度 (HSB),然后将这个值添加到亮度中。默认值为 -0.3
  • glowOnly 是一个布尔值。当 true 时,仅显示辉光效果;当 false 时,辉光将添加到输入纹理中。 默认值为 false。这是一个调试选项,用于查看更改其他 uniform 值时的效果。

deltasigmastepSize 是与 PostProcessStageLibrary#createBlurStage 相同的属性。 模糊应用于从图像生成的阴影,以使其更平滑。

启用时,该阶段将在所有其他阶段之前执行。

控制高动态范围 (HDR) 打开时的曝光。小于 1.0 会使调色映射变暗,而大于 1.0 会使其变亮。
Default Value: 1.0
Example:
viewer.scene.postProcessStages.exposure = 1.0;
用于快速近似抗锯齿的后处理阶段。

启用时,该阶段将在所有其他阶段之后执行。

此集合中的后处理阶段数。
确定集合中的所有后处理阶段是否准备好执行。
指定在高动态范围渲染时使用的调色映射算法。 Sandcastle Demo
Default Value: Tonemapper.PBR_NEUTRAL
Example:
viewer.scene.postProcessStages.tonemapper = Cesium.Tonemapper.ACES;

Methods

将后处理阶段添加到集合中。
Name Type Description
stage PostProcessStage | PostProcessStageComposite 要添加到集合中的后处理阶段。
Returns:
被添加到集合中的后处理阶段。
Throws:
  • DeveloperError : 后处理阶段已被添加到集合中或没有唯一名称。
返回集合是否包含一个后处理阶段。
Name Type Description
stage PostProcessStage | PostProcessStageComposite 后处理阶段。
Returns:
集合是否包含该后处理阶段。
销毁此对象持有的 WebGL 资源。销毁对象允许确定性地释放 WebGL 资源,而不是依赖于垃圾收集器销毁此对象。

一旦对象被销毁,就不应使用;调用除 isDestroyed 之外的任何功能将导致 DeveloperError 异常。因此, 将返回值 (undefined) 赋给对象,如示例中所示。

Throws:
See:
获取在 index 的后处理阶段。
Name Type Description
index number 后处理阶段的索引。
Returns:
指定索引的后处理阶段。
如果此对象已被销毁,则返回 true;否则返回 false。

如果此对象已被销毁,则不应使用;调用除 isDestroyed 之外的任何功能将导致 DeveloperError 异常。

Returns:
如果此对象已被销毁,则返回 true;否则返回 false
See:
从集合中移除一个后处理阶段并销毁它。
Name Type Description
stage PostProcessStage | PostProcessStageComposite 要从集合中移除的后处理阶段。
Returns:
后处理阶段是否被成功移除。
从集合中移除所有后处理阶段并销毁它们。
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.