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.
Checking the stable version of the documentation...
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) 🔗
地面底部的顏色。會與 ground_horizon_color 混合。
從 ground_horizon_color 漸變到 ground_bottom_color 的速度。
float ground_energy_multiplier = 1.0 🔗
地面顏色的乘數。值越高,地面越亮。
Color ground_horizon_color = Color(0.6463, 0.6558, 0.6708, 1) 🔗
地面在地平線處的顏色。會與 ground_bottom_color 混合。
要使用的天空覆蓋紋理。這個紋理必須使用一個等角投影(類似於PanoramaSkyMaterial)。 該紋理的顏色將被新增到現有的天空顏色中,並將乘以 sky_energy_multiplier 和 sky_cover_modulate。這主要適用於顯示夜晚的星星,但也可以用來顯示白天或夜晚的雲彩(具有非物理精確性的外觀)。
Color sky_cover_modulate = Color(1, 1, 1, 1) 🔗
套用於 sky_cover 紋理的色調。可用於改變天空覆蓋的顏色或不透明度,不受天空能量的影響,對於晝夜轉換或天氣轉換很有用。只有在 sky_cover 中定義了紋理時才有效。
從 sky_horizon_color 漸變到 sky_top_color 的速度。
float sky_energy_multiplier = 1.0 🔗
天空顏色的倍數。值越高天空越亮。
Color sky_horizon_color = Color(0.6463, 0.6558, 0.6708, 1) 🔗
天空在地平線處的顏色。會與 sky_top_color 混合。
Color sky_top_color = Color(0.385, 0.454, 0.55, 1) 🔗
天空在頂部的顏色。會與 sky_horizon_color 混合。
太陽完全淡出消失的位置與太陽中心的距離。
在太陽圓盤邊緣和 sun_angle_max 之間,太陽消失得有多快。
如果為 true,則啟用去色帶。去色帶會增加少量噪點,這有助於減少天空中顏色的平滑變化而出現的色帶。