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.

OmniLight3D

繼承: Light3D < VisualInstance3D < Node3D < Node < Object

全向光,如燈泡或蠟燭。

說明

全向光是 Light3D 的一類,可以向所有方向發射光。光隨距離而衰減,該衰減可以通過修改其能量、半徑和衰減參數來配置。

注意:使用移動渲染方式時,每個網格資源上只能顯示 8 個全向燈。嘗試在單個網格資源上顯示 8 個以上的全向燈,將導致全向燈隨著相機移動而閃爍。使用 Compatibility 渲染方式時,預設情況下每個網格資源上只能顯示 8 個全向燈,但可以通過調整 ProjectSettings.rendering/limits/opengl/max_lights_per_object 來增加。

注意:當使用 Mobile 或 Compatibility 渲染方法時,全向燈只會正確影響可見性 AABB 與該燈光的 AABB 相交的網格。如果使用了著色器將網格進行了變形,超出了 AABB 的範圍,則必須將該網格的 GeometryInstance3D.extra_cull_margin 增大。否則燈光在該網格上可能不可見。

教學

屬性

float

light_specular

0.5 (overrides Light3D)

float

omni_attenuation

1.0

float

omni_range

5.0

ShadowMode

omni_shadow_mode

1

float

shadow_normal_bias

1.0 (overrides Light3D)


列舉

enum ShadowMode: 🔗

ShadowMode SHADOW_DUAL_PARABOLOID = 0

將陰影渲染到雙抛物面紋理。比 SHADOW_CUBE 更快,但品質較差。

ShadowMode SHADOW_CUBE = 1

將陰影渲染至立方體貼圖。比 SHADOW_DUAL_PARABOLOID 更慢,但品質更高。


屬性說明

float omni_attenuation = 1.0 🔗

控制全向燈的距離衰減函式。

值為 0.0 將在大部分範圍內保持恆定亮度,但會平滑地衰減範圍邊緣的光線。對於物理上準確的燈光,請使用值 2.0,因為它會產生正確的平方反比衰減。

注意:將衰減設定為 2.0 或更高可能會導致遠處的物體接收到的光線最少,即使在範圍內也是如此。例如,在 4096 的範圍內,100 單位處的物體會衰減 0.0001 倍。預設亮度為 1,光線在該距離處不可見。

注意:使用負值或高於 10.0 的值可能會導致意外結果。


float omni_range = 5.0 🔗

該燈光的半徑。請注意,根據使用的 omni_attenuation,有效照明區域可能看起來更小。無論使用 omni_attenuation 為何值,光線永遠不會到達該半徑之外的任何地方。

注意:omni_range 不受 Node3D.scale(無論是該燈光的縮放還是其父節點的縮放)的影響。


ShadowMode omni_shadow_mode = 1 🔗

There is currently no description for this property. Please help us by contributing one!