Sky

使用 Material 定義 3D 環境的背景。

說明

Sky 類使用 Material 來繪製背景，會更新反射/輻照度立方體貼圖。

屬性

ProcessMode	process_mode	`0`
RadianceSize	radiance_size	`3`
Material	sky_material

列舉

enum RadianceSize: 🔗

RadianceSize RADIANCE_SIZE_32 = 0

輻照度紋理尺寸為 32×32 圖元。

RadianceSize RADIANCE_SIZE_64 = 1

輻照度紋理尺寸為 64×64 圖元。

RadianceSize RADIANCE_SIZE_128 = 2

輻照度紋理尺寸為128×128圖元。

RadianceSize RADIANCE_SIZE_256 = 3

輻照度紋理尺寸為 256×256 圖元。

RadianceSize RADIANCE_SIZE_512 = 4

輻照度紋理尺寸為 512×512 圖元。

RadianceSize RADIANCE_SIZE_1024 = 5

輻照度紋理尺寸為 1024×1024 圖元。

RadianceSize RADIANCE_SIZE_2048 = 6

輻照度紋理尺寸為 2048×2048 圖元。

RadianceSize RADIANCE_SIZE_MAX = 7

代表 RadianceSize 列舉的大小。

enum ProcessMode: 🔗

ProcessMode PROCESS_MODE_AUTOMATIC = 0

根據天空著色器自動選擇合適的處理模式。如果著色器使用 TIME 或 POSITION，這將使用 PROCESS_MODE_REALTIME。如果著色器使用任何 LIGHT_* 變數或任何自訂 uniform，這將使用 PROCESS_MODE_INCREMENTAL。否則，這預設為 PROCESS_MODE_QUALITY。

ProcessMode PROCESS_MODE_QUALITY = 1

使用高品質重要性取樣處理輻照度貼圖。得到的結果通常比 PROCESS_MODE_REALTIME 的品質更高，但需要花費更多的時間來生成。如果你計畫在運行時修改天空，則不應使用。如果你發現反射不夠模糊，出現了火花或者螢火蟲，請嘗試增大 ProjectSettings.rendering/reflections/sky_reflections/ggx_samples。

ProcessMode PROCESS_MODE_INCREMENTAL = 2

使用與 PROCESS_MODE_QUALITY 相同的高品質重要性取樣來處理輻照度貼圖，但更新會佔用幾影格。影格數由 ProjectSettings.rendering/reflections/sky_reflections/roughness_layers 決定。當需要最高品質的輻照度貼圖，但天空更新緩慢時，請使用該選項。

ProcessMode PROCESS_MODE_REALTIME = 3

使用快速篩選演算法處理輻射度貼圖。一般來說，這會導致品質較低，但執行時間會大大加快。如果需要更好的品質，但仍需要每影格更新天空，請考慮開啟 ProjectSettings.rendering/reflections/sky_reflections/fast_filter_high_quality。

注意：快速篩選演算法被限制為 256x256 立方體貼圖，因此必須將 radiance_size 設定為 RADIANCE_SIZE_256。否則會輸出警告並忽略覆蓋的輻射度大小。

屬性說明

ProcessMode process_mode = 0 🔗

void set_process_mode(value: ProcessMode)
ProcessMode get_process_mode()

The method for generating the radiance map from the sky. The radiance map is a cubemap with increasingly blurry versions of the sky corresponding to different levels of roughness. Radiance maps can be expensive to calculate.

RadianceSize radiance_size = 3 🔗

void set_radiance_size(value: RadianceSize)
RadianceSize get_radiance_size()

The Sky's radiance map size. The higher the radiance map size, the more detailed the lighting from the Sky will be.

Note: Some hardware will have trouble with higher radiance sizes, especially RADIANCE_SIZE_512 and above. Only use such high values on high-end hardware.

Material sky_material 🔗

void set_material(value: Material)
Material get_material()

用於繪製該背景的 Material。可以是 PanoramaSkyMaterial、ProceduralSkyMaterial、PhysicalSkyMaterial，如果你想使用自訂著色器也可以是 ShaderMaterial。