根据场景的当前照明条件在给定位置生成环境贴图。由此,它生成了多级镜面反射贴图和球谐系数,这些系数可与
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
从大气中发射的散射光的强度。这应该相对于
Scene.light
强度的值进行调整。
-
Default Value:
- DirectionalLight.intensity
- SunLight.intensity
2.0
See:
从环境发出的光的亮度。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
groundColor : Color
纯色用于表示地面。
-
Default Value:
DynamicEnvironmentMapManager.AVERAGE_EARTH_GROUND_COLOR
创建新环境贴图之前的最大位置差,以米为单位。位置的微小差异不会明显影响结果。
-
Default Value:
1000
创建新环境映射之前经过的最大秒数。
-
Default Value:
3600
position : Cartesian3|undefined
生成环境贴图所围绕的位置。
从环境中发出的光的饱和度。1.0 使用未修改的 Emitted Environment Color。小于 1.0 会降低
饱和度 大于 1.0 时,饱和度会增加 Saturation。
-
Default Value:
1.0
Methods
如果当前 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:
-
DeveloperError : 此对象已销毁,即调用 destroy() 。
Example:
mapManager = mapManager && mapManager.destroy();
See:
Returns:
true
如果此对象被销毁;否则为 false
。
Type Definitions
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。 |