Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

ProceduralSkyMaterial

繼承: Material < Resource < RefCounted < Object

以圖塊的形式向 TileSet 資源暴露一組場景。

說明

ProceduralSkyMaterial 提供了一種通過為太陽、天空和地面定義程式參數,來快速建立一個有效背景的方法。天空和地面由主顏色、地平線顏色、以及在它們之間插值的緩動曲線定義。太陽通過天空中的位置、顏色、以及緩動曲線結束時距太陽的最大角度來描述。因此,最大角度定義了天空中太陽的大小。

ProceduralSkyMaterial 支援最多 4 個太陽,它們使用場景中前四個 DirectionalLight3D 節點的顏色、能量、方向和角距離。這意味著太陽由其相應的 DirectionalLight3D 的屬性單獨定義,並由 sun_angle_max 和 sun_curve 全域定義。

ProceduralSkyMaterial 使用輕量級著色器來繪製天空,因此適合即時更新。這使得它成為簡單、低計算成本且不切實際的天空的絕佳選擇。如果你需要更真實的程式化選項,請使用 PhysicalSkyMaterial。

屬性

float

energy_multiplier

1.0

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


屬性說明

float energy_multiplier = 1.0 🔗

  • void set_energy_multiplier(value: float)

  • float get_energy_multiplier()

天空整體亮度的乘數。數值越高,天空就越亮。


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

  • void set_ground_bottom_color(value: Color)

  • Color get_ground_bottom_color()

地面底部的顏色。會與 ground_horizon_color 混合。


float ground_curve = 0.02 🔗

  • void set_ground_curve(value: float)

  • float get_ground_curve()

從 ground_horizon_color 漸變到 ground_bottom_color 的速度。


float ground_energy_multiplier = 1.0 🔗

  • void set_ground_energy_multiplier(value: float)

  • float get_ground_energy_multiplier()

地面顏色的乘數。值越高,地面越亮。


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

  • void set_ground_horizon_color(value: Color)

  • Color get_ground_horizon_color()

地面在地平線處的顏色。會與 ground_bottom_color 混合。


Texture2D sky_cover 🔗

要使用的天空覆蓋紋理。這個紋理必須使用一個等角投影(類似於PanoramaSkyMaterial)。 該紋理的顏色將被新增到現有的天空顏色中,並將乘以 sky_energy_multiplier 和 sky_cover_modulate。這主要適用於顯示夜晚的星星,但也可以用來顯示白天或夜晚的雲彩(具有非物理精確性的外觀)。


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

  • void set_sky_cover_modulate(value: Color)

  • Color get_sky_cover_modulate()

套用於 sky_cover 紋理的色調。可用於改變天空覆蓋的顏色或不透明度,不受天空能量的影響,對於晝夜轉換或天氣轉換很有用。只有在 sky_cover 中定義了紋理時才有效。


float sky_curve = 0.15 🔗

  • void set_sky_curve(value: float)

  • float get_sky_curve()

從 sky_horizon_color 漸變到 sky_top_color 的速度。


float sky_energy_multiplier = 1.0 🔗

  • void set_sky_energy_multiplier(value: float)

  • float get_sky_energy_multiplier()

天空顏色的倍數。值越高天空越亮。


Color sky_horizon_color = Color(0.6463, 0.6558, 0.6708, 1) 🔗

  • void set_sky_horizon_color(value: Color)

  • Color get_sky_horizon_color()

天空在地平線處的顏色。會與 sky_top_color 混合。


Color sky_top_color = Color(0.385, 0.454, 0.55, 1) 🔗

  • void set_sky_top_color(value: Color)

  • Color get_sky_top_color()

天空在頂部的顏色。會與 sky_horizon_color 混合。


float sun_angle_max = 30.0 🔗

  • void set_sun_angle_max(value: float)

  • float get_sun_angle_max()

太陽完全淡出消失的位置與太陽中心的距離。


float sun_curve = 0.15 🔗

  • void set_sun_curve(value: float)

  • float get_sun_curve()

在太陽圓盤邊緣和 sun_angle_max 之間,太陽消失得有多快。


bool use_debanding = true 🔗

  • void set_use_debanding(value: bool)

  • bool get_use_debanding()

如果為 true,則啟用去色帶。去色帶會增加少量噪點,這有助於減少天空中顏色的平滑變化而出現的色帶。