DynamicEnvironmentMapManager

new Cesium.DynamicEnvironmentMapManager(options)

根据场景的当前照明条件在给定位置生成环境贴图。由此,它生成了多级镜面反射贴图和球谐系数,这些系数可与 ImageBasedLighting 一起用于模型或瓦片集。
Name Type Description
options DynamicEnvironmentMapManager.ConstructorOptions optional 描述初始化选项的对象。
Examples:
// 在场景中启用时间环境映射
scene.atmosphere.dynamicLighting = Cesium.DynamicAtmosphereLightingType.SUNLIGHT;

// 减少定向照明贡献
scene.light.intensity = 0.5

// 增加环境贴图照明贡献的强度
const environmentMapManager = tileset.environmentMapManager;
environmentMapManager.atmosphereScatteringIntensity = 3.0;
// 将用于模型环境贴图的地面颜色更改为森林绿色
const environmentMapManager = model.environmentMapManager;
environmentMapManager.groundColor = Cesium.Color.fromCssColorString("#203b34");

Members

static readonly Cesium.DynamicEnvironmentMapManager.AVERAGE_EARTH_GROUND_COLOR : Color

地球上底色的平均色调,温暖的绿灰色。

static readonly Cesium.DynamicEnvironmentMapManager.DEFAULT_SPHERICAL_HARMONIC_COEFFICIENTS : Array.<Cartesian3>

默认的三阶球谐系数,用于基于图像的照明的漫反射颜色,即强度较低的白色环境光。

有 9 个 Cartesian3 系数。 系数的顺序是: L0,0, L1,-1, L1,0, L1,1, L2,-2, L2,-1, L2,0, L2,1, L2,2

See:

atmosphereScatteringIntensity : number

从大气中发射的散射光的强度。这应该相对于 Scene.light 强度的值进行调整。
Default Value: 2.0
See:
  • DirectionalLight.intensity
  • SunLight.intensity
从环境发出的光的亮度。1.0 使用未修改的 Emitted Environment Color。小于 1.0 使光更暗,而大于 1.0 会使光更亮。
Default Value: 1.0
如果为 true,则环境映射和相关属性将继续更新。
Default Value: true
应用于从环境发射的光范围的 Gamma 校正。1.0 使用未修改的入射灯光颜色。
Default Value: 1.0
从地面反射的光的百分比。平均地球反照率为 0.31。
Default Value: 0.31
纯色用于表示地面。
Default Value: DynamicEnvironmentMapManager.AVERAGE_EARTH_GROUND_COLOR
创建新环境贴图之前的最大位置差,以米为单位。位置的微小差异不会明显影响结果。
Default Value: 1000
创建新环境映射之前经过的最大秒数。
Default Value: 3600
生成环境贴图所围绕的位置。
从环境中发出的光的饱和度。1.0 使用未修改的 Emitted Environment Color。小于 1.0 会降低 饱和度 大于 1.0 时,饱和度会增加 Saturation。
Default Value: 1.0

Methods

static Cesium.DynamicEnvironmentMapManager.isDynamicUpdateSupported(scene)boolean

如果当前 WebGL 渲染上下文支持动态更新,则返回 true。 动态更新需要 EXT_color_buffer_float 或 EXT_color_buffer_half_float 扩展。
Name Type Description
scene Scene 包含渲染上下文的对象
Returns:
true 如果支持则
销毁此对象持有的 WebGL 资源。 销毁对象允许确定性 释放 WebGL 资源,而不是依赖垃圾回收器来销毁这个对象。

一旦对象被销毁,就不应该使用它;调用 isDestroyed将导致 DeveloperError 异常。 因此 将 return value (undefined) 分配给对象,如示例中所示。
Throws:
Example:
mapManager = mapManager && mapManager.destroy();
See:
如果此对象已销毁,则返回 true;否则为 false。

如果此对象已销毁,则不应使用它;调用 isDestroyed 将导致 DeveloperError 异常。
Returns:
true 如果此对象被销毁;否则为 false
See:

Type Definitions

Cesium.DynamicEnvironmentMapManager.ConstructorOptions

DynamicEnvironmentMapManager 构造函数的选项
Properties:
Name Type Attributes Default Description
enabled boolean <optional>
true 如果为 true,则环境映射和相关属性将继续更新。
mipmapLevels number <optional>
7 要为镜面反射贴图生成的 mipmap 级别数。更多的 mipmap 级别将产生更高分辨率的镜面反射。
maximumSecondsDifference number <optional>
3600 创建新环境映射之前经过的最大秒数。
maximumPositionEpsilon number <optional>
1000 创建新环境贴图之前的最大位置差,以米为单位。位置的微小差异不会明显影响结果。
atmosphereScatteringIntensity number <optional>
2.0 从大气中发射的散射光的强度。这应该相对于 Scene.light 强度的值进行调整。
gamma number <optional>
1.0 应用于从环境发射的光范围的 Gamma 校正。1.0 使用未修改的 Emitted Light 颜色。
brightness number <optional>
1.0 从环境发出的光的亮度。1.0 使用未修改的 Emitted Environment Color。小于 1.0 会使光线更暗,而大于 1.0 会使光线更亮。
saturation number <optional>
1.0 从环境中发出的光的饱和度。1.0 使用未修改的 Emitted Environment Color。小于 1.0 会降低饱和度,而大于 1.0 会增加饱和度。
groundColor Color <optional>
DynamicEnvironmentMapManager.AVERAGE_EARTH_GROUND_COLOR 纯色用于表示地面。
groundAlbedo number <optional>
0.31 从地面反射的光的百分比。平均地球反照率为 0.31。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.