用于管理图块集和模型上基于图像的照明的属性。还管理必要的资源和纹理。
如果使用高光环境贴图,则当不再需要基于图像的光照来正确清理 GPU 资源时,必须调用
ImageBasedLighting#destroy
。如果模型或瓦片集创建了 ImageBasedLighting 的实例,它将处理此问题。否则,应用程序负责调用destroy()。
Name | Type | Default | Description |
---|---|---|---|
options.imageBasedLightingFactor
|
Cartesian2 |
Cartesian2(1.0, 1.0)
|
可选 缩放来自地球、天空、大气和星空天空盒的基于图像的漫反射和镜面反射照明。 |
options.luminanceAtZenith
|
Number |
0.2
|
可选 用于此模型的程序环境贴图的天顶处的太阳亮度(以千坎德拉每平方米为单位)。 |
options.sphericalHarmonicCoefficients
|
Array.< Cartesian3 > | 可选 用于基于图像的照明的漫反射颜色的三阶球面谐波系数。 | |
options.specularEnvironmentMaps
|
String | 可选 KTX2 文件的 URL,该文件包含高光照明的立方体贴图和卷积高光 mipmap。 |
Members
imageBasedLightingFactor : Cartesian2
Cesium 增加了来自地球、天空、大气和星空天空盒的光照。该笛卡尔坐标用于将来自这些光源的最终漫反射和镜面反射照明贡献缩放到最终颜色。值 0.0 将禁用这些光源。
-
Default Value:
Cartesian2(1.0, 1.0)
用于此模型的程序环境贴图的天顶处的太阳亮度(以千坎德拉每平方米为单位)。这在
ImageBasedLighting#specularEnvironmentMaps
和
ImageBasedLighting#sphericalHarmonicCoefficients
未定义时使用。
-
Default Value:
0.2
KTX2 文件的 URL,其中包含高光照明的立方体贴图和卷积高光 mipmap。
sphericalHarmonicCoefficients : Array.< Cartesian3 >
用于基于图像的照明的漫反射颜色的三阶球面谐波系数。当
undefined
时,使用从大气颜色计算的漫射辐照度。
有九个
Cartesian3
系数。系数的顺序是: L
0,0
, L
1,-1
, L
1,0
, L
1,1
, L
2,-2
, L
2,-1
, L
2,0
, L
2,1
,大号
2,2
cmgen
工具对环境图进行预处理来获得。这还将生成一个可提供给
Model#specularEnvironmentMaps
的 KTX 文件。