ProceduralSkyMaterial

ProceduralSkyMaterial

继承： Material < Resource < RefCounted < Object

一种材质，可为 Sky 资源定义简单天空。

描述

ProceduralSkyMaterial 提供了一种通过为太阳、天空、和地面定义程序参数，来快速创建一个有效背景的方法。天空和地面由主颜色、地平线颜色、以及在它们之间插值的缓动曲线定义。太阳通过天空中的位置、颜色、以及缓动曲线结束时距太阳的最大角度来描述。因此，最大角度定义了天空中太阳的大小。

ProceduralSkyMaterial 支持最多 4 个太阳，它们使用场景中前四个 DirectionalLight3D 节点的颜色、能量、方向、和角距离。这意味着太阳由其相应的 DirectionalLight3D 的属性单独定义，并由 sun_angle_max 和 sun_curve 全局定义。

ProceduralSkyMaterial 使用轻量级着色器来绘制天空，因此适合实时更新。这使得它成为简单、低计算成本且不切实际的天空的绝佳选择。如果你需要更真实的程序化选项，请使用 PhysicalSkyMaterial。

属性

Color	ground_bottom_color	`Color(0.2, 0.169, 0.133, 1)`
float	ground_curve	`0.02`
float	ground_energy_multiplier	`1.0`
Color	ground_horizon_color	`Color(0.6463, 0.6558, 0.6708, 1)`
Texture2D	sky_cover
Color	sky_cover_modulate	`Color(1, 1, 1, 1)`
float	sky_curve	`0.15`
float	sky_energy_multiplier	`1.0`
Color	sky_horizon_color	`Color(0.6463, 0.6558, 0.6708, 1)`
Color	sky_top_color	`Color(0.385, 0.454, 0.55, 1)`
float	sun_angle_max	`30.0`
float	sun_curve	`0.15`
bool	use_debanding	`true`

属性说明

Color ground_bottom_color = Color(0.2, 0.169, 0.133, 1)

void set_ground_bottom_color ( Color value )
Color get_ground_bottom_color ( )

地面底部的颜色。会与 ground_horizon_color 混合。

float ground_curve = 0.02

void set_ground_curve ( float value )
float get_ground_curve ( )

从 ground_horizon_color 渐变到 ground_bottom_color 的速度。

float ground_energy_multiplier = 1.0

void set_ground_energy_multiplier ( float value )
float get_ground_energy_multiplier ( )

地面颜色的乘数。值越高，地面越亮。

Color ground_horizon_color = Color(0.6463, 0.6558, 0.6708, 1)

void set_ground_horizon_color ( Color value )
Color get_ground_horizon_color ( )

地面在地平线处的颜色。会与 ground_bottom_color 混合。

Texture2D sky_cover

void set_sky_cover ( Texture2D value )
Texture2D get_sky_cover ( )

要使用的天空覆盖纹理。这个纹理必须使用一个等角投影（类似于PanoramaSkyMaterial）。该纹理的颜色将被添加到现有的天空颜色中，并将乘以 sky_energy_multiplier 和 sky_cover_modulate。这主要适用于显示夜晚的星星，但也可以用来显示白天或夜晚的云彩（具有非物理精确性的外观）。

Color sky_cover_modulate = Color(1, 1, 1, 1)