Vaillant Jeremy
01ea3af253
Apply Godot 4.6 automated conversion: renames Spatial.translate->position, margin_*->offset_*, tool->@tool, .empty()->.is_empty(), DynamicFont->FontFile, onready->@onready, export()->@export, and many more. 127 files changed by the tool. Manual fixes still required for: - godot_db_manager plugin (incompatible APIs: WindowDialog, Tabs, etc.) - lod plugin (Spatial -> Node3D renames) - ResourceLoader.load_interactive removed -> load_threaded_request - OS.set_window_fullscreen removed -> DisplayServer - Viewport.set_size_override removed Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
93 lines
3.8 KiB
GDScript
93 lines
3.8 KiB
GDScript
# Copyright © 2020 Hugo Locurcio and contributors - MIT License
|
|
# See `LICENSE.md` included in the source distribution for details.
|
|
extends OmniLight3D
|
|
class_name LODOmniLight, "lod_omni_light.svg"
|
|
|
|
# If `false`, LOD won't update anymore. This can be used for performance comparison
|
|
# purposes.
|
|
@export var enable_lod := true
|
|
|
|
# The maximum shadow distance in units. Past this distance, the shadow will be disabled.
|
|
@export var shadow_max_distance := 25 # (float, 0.0, 1000.0, 0.1)
|
|
|
|
# The distance factor at which the shadow starts fading.
|
|
# A value of 0.0 will result in the smoothest transition whereas a value of 1.0 disables fading.
|
|
@export var shadow_fade_start := 0.8 # (float, 0.0, 1.0, 0.1)
|
|
|
|
# The maximum shadow distance in units. Past this distance, the light will be hidden.
|
|
@export var light_max_distance := 50 # (float, 0.0, 1000.0, 0.1)
|
|
|
|
# The distance factor at which the light starts fading.
|
|
# A value of 0.0 will result in the smoothest transition whereas a value of 1.0 disables fading.
|
|
@export var light_fade_start := 0.8 # (float, 0.0, 1.0, 0.1)
|
|
|
|
# The rate at which LODs will be updated (in seconds). Lower values are more reactive
|
|
# but use more CPU, which is especially noticeable with large amounts of LOD-enabled nodes.
|
|
# Set this accordingly depending on your camera movement speed.
|
|
# The default value should suit most projects already.
|
|
# Note: Slow cameras don't need to have LOD-enabled objects update their status often.
|
|
# By default, lights have their LOD updated faster than other LOD nodes since their
|
|
# light/shadow intensity needs to change as smoothly as posible.
|
|
# This can overridden by setting the project setting `lod/light_refresh_rate`.
|
|
var refresh_rate := 0.05
|
|
|
|
# The LOD bias in units.
|
|
# Positive values will decrease the detail level and improve performance.
|
|
# Negative values will improve visual appearance at the cost of performance.
|
|
# This can overridden by setting the project setting `lod/bias`.
|
|
var lod_bias := 0.0
|
|
|
|
# The internal refresh timer.
|
|
var timer := 0.0
|
|
|
|
# The light's energy when it was instanced.
|
|
var base_light_energy := light_energy
|
|
|
|
|
|
func _ready() -> void:
|
|
if ProjectSettings.has_setting("lod/light_bias"):
|
|
lod_bias = ProjectSettings.get_setting("lod/light_bias")
|
|
if ProjectSettings.has_setting("lod/light_refresh_rate"):
|
|
refresh_rate = ProjectSettings.get_setting("lod/light_refresh_rate")
|
|
|
|
# Add random jitter to the timer to ensure LODs don't all swap at the same time.
|
|
randomize()
|
|
timer += randf_range(0, refresh_rate)
|
|
|
|
# Despite LOD not being related to physics, we chose to run in `_physics_process()`
|
|
# to minimize the amount of method calls per second (and therefore decrease CPU usage).
|
|
func _physics_process(delta: float) -> void:
|
|
if not enable_lod:
|
|
return
|
|
|
|
# We need a camera to do the rest.
|
|
var camera := get_viewport().get_camera_3d()
|
|
if camera == null:
|
|
return
|
|
|
|
if timer <= refresh_rate:
|
|
timer += delta
|
|
return
|
|
|
|
timer = 0.0
|
|
|
|
var distance := camera.global_transform.origin.distance_to(global_transform.origin) + lod_bias
|
|
|
|
visible = distance < light_max_distance
|
|
var light_fade_start_distance := light_max_distance * light_fade_start
|
|
if distance > light_fade_start_distance:
|
|
light_energy = max(0, (1 - (distance - light_fade_start_distance) / (light_max_distance - light_fade_start_distance)) * base_light_energy)
|
|
else:
|
|
# We're close enough to the light to show it at full brightness.
|
|
light_energy = base_light_energy
|
|
|
|
shadow_enabled = distance < shadow_max_distance
|
|
var shadow_fade_start_distance := shadow_max_distance * shadow_fade_start
|
|
var shadow_value: float
|
|
if distance > shadow_fade_start_distance:
|
|
shadow_value = min(1, (distance - shadow_fade_start_distance) / (shadow_max_distance - shadow_fade_start_distance))
|
|
else:
|
|
# We're close enough to the light to show its shadow at full darkness.
|
|
shadow_value = 0.0
|
|
shadow_color = Color(shadow_value, shadow_value, shadow_value)
|