mirror/godot
2
0
Fork 0
mirror of https://github.com/godotengine/godot.git synced 2024-12-27 11:24:59 +08:00
Code Issues Packages Projects Releases Wiki Activity
cc21871c9a
godot/scene/3d/light_3d.cpp

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

662 lines
29 KiB
C++
Raw Normal View History

GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
/**************************************************************************/
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
/* light_3d.cpp */
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/**************************************************************************/
Add missing copyright headers and fix formatting Using `misc/scripts/fix_headers.py` on all Godot files. Some missing header guards were added, and the header inclusion order was fixed in the Bullet module.
2018-01-05 07:50:27 +08:00
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
#include "core/config/project_settings.h"
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
#include "light_3d.h"
remove trailing whitespace
2016-03-09 07:00:52 +08:00
Use real_t in 3D nodes
2021-01-30 08:55:54 +08:00
void Light3D::set_param(Param p_param, real_t p_value) {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
ERR_FAIL_INDEX(p_param, PARAM_MAX);
param[p_param] = p_value;
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_set_param(light, RS::LightParam(p_param), p_value);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
if (p_param == PARAM_SPOT_ANGLE || p_param == PARAM_RANGE) {
Node3D gizmo improvements * Clean-up of node_3d_editor_plugin.{h,cpp}: removed unused code, fixed some bugs. * Moved node_3d_editor_gizmos.{h,cpp} to editor/plugins. * Added support for multiple gizmos per node. This means custom gizmos will no longer override the built-in ones and that multiple gizmos can be used in more complex nodes. * Added support for handle IDs. When adding handles to a gizmo, an ID can be specified for each one, making it easier to work with gizmos that have a variable number of handles. * Added support for subgizmos, selectable elements that can be transformed without needing a node of their own. By overriding _subgizmo_intersect_frustum() and/or _subgizmo_intersect_ray() gizmos can define which subgizmos should be selected on a region or click selection. Subgizmo transformations are applied using get/set/commit virtual methods, similar to how handles work.
2021-06-23 22:49:50 +08:00
update_gizmos();
Update Light properties in the inspector when dragging their gizmos
2018-09-08 04:59:55 +08:00
if (p_param == PARAM_SPOT_ANGLE) {
Use Array for node configuration warnings Previously, the warnings were passed as a string and delimitation of which were hard coded at each implementation.
2020-10-29 18:01:28 +08:00
update_configuration_warnings();
Update Light properties in the inspector when dragging their gizmos
2018-09-08 04:59:55 +08:00
}
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
}
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Use real_t in 3D nodes
2021-01-30 08:55:54 +08:00
real_t Light3D::get_param(Param p_param) const {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
ERR_FAIL_INDEX_V(p_param, PARAM_MAX, 0);
return param[p_param];
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
remove trailing whitespace
2016-03-09 07:00:52 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_shadow(bool p_enable) {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
shadow = p_enable;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_set_shadow(light, p_enable);
Add a configuration warning when using ultrawide SpotLight with shadows This partially addresses #12028.
2019-07-07 22:22:09 +08:00
Hide extra options from various nodes if they're not enabled
2020-02-14 10:34:59 +08:00
notify_property_list_changed();
Add warnings for unsupported features in mobile and gl_compatibility backends
2023-02-26 08:24:41 +08:00
update_configuration_warnings();
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Style: Enforce separation line between function definitions I couldn't find a tool that enforces it, so I went the manual route: ``` find -name "thirdparty" -prune \ -o -name "*.cpp" -o -name "*.h" -o -name "*.m" -o -name "*.mm" \ -o -name "*.glsl" > files perl -0777 -pi -e 's/\n}\n([^#])/\n}\n\n\1/g' $(cat files) misc/scripts/fix_style.sh -c ``` This adds a newline after all `}` on the first column, unless they are followed by `#` (typically `#endif`). This leads to having lots of places with two lines between function/class definitions, but clang-format then fixes it as we enforce max one line of separation. This doesn't fix potential occurrences of function definitions which are indented (e.g. for a helper class defined in a .cpp), but it's better than nothing. Also can't be made to run easily on CI/hooks so we'll have to be careful with new code. Part of #33027.
2020-05-14 20:29:06 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
bool Light3D::has_shadow() const {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
return shadow;
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_negative(bool p_enable) {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
negative = p_enable;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_set_negative(light, p_enable);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Style: Enforce separation line between function definitions I couldn't find a tool that enforces it, so I went the manual route: ``` find -name "thirdparty" -prune \ -o -name "*.cpp" -o -name "*.h" -o -name "*.m" -o -name "*.mm" \ -o -name "*.glsl" > files perl -0777 -pi -e 's/\n}\n([^#])/\n}\n\n\1/g' $(cat files) misc/scripts/fix_style.sh -c ``` This adds a newline after all `}` on the first column, unless they are followed by `#` (typically `#endif`). This leads to having lots of places with two lines between function/class definitions, but clang-format then fixes it as we enforce max one line of separation. This doesn't fix potential occurrences of function definitions which are indented (e.g. for a helper class defined in a .cpp), but it's better than nothing. Also can't be made to run easily on CI/hooks so we'll have to be careful with new code. Part of #33027.
2020-05-14 20:29:06 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
bool Light3D::is_negative() const {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
return negative;
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
void Light3D::set_enable_distance_fade(bool p_enable) {
distance_fade_enabled = p_enable;
RS::get_singleton()->light_set_distance_fade(light, distance_fade_enabled, distance_fade_begin, distance_fade_shadow, distance_fade_length);
notify_property_list_changed();
}
bool Light3D::is_distance_fade_enabled() const {
return distance_fade_enabled;
}
void Light3D::set_distance_fade_begin(real_t p_distance) {
distance_fade_begin = p_distance;
RS::get_singleton()->light_set_distance_fade(light, distance_fade_enabled, distance_fade_begin, distance_fade_shadow, distance_fade_length);
}
real_t Light3D::get_distance_fade_begin() const {
return distance_fade_begin;
}
void Light3D::set_distance_fade_shadow(real_t p_distance) {
distance_fade_shadow = p_distance;
RS::get_singleton()->light_set_distance_fade(light, distance_fade_enabled, distance_fade_begin, distance_fade_shadow, distance_fade_length);
}
real_t Light3D::get_distance_fade_shadow() const {
return distance_fade_shadow;
}
void Light3D::set_distance_fade_length(real_t p_length) {
distance_fade_length = p_length;
RS::get_singleton()->light_set_distance_fade(light, distance_fade_enabled, distance_fade_begin, distance_fade_shadow, distance_fade_length);
}
real_t Light3D::get_distance_fade_length() const {
return distance_fade_length;
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_cull_mask(uint32_t p_cull_mask) {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
cull_mask = p_cull_mask;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_set_cull_mask(light, p_cull_mask);
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
}
Style: Enforce separation line between function definitions I couldn't find a tool that enforces it, so I went the manual route: ``` find -name "thirdparty" -prune \ -o -name "*.cpp" -o -name "*.h" -o -name "*.m" -o -name "*.mm" \ -o -name "*.glsl" > files perl -0777 -pi -e 's/\n}\n([^#])/\n}\n\n\1/g' $(cat files) misc/scripts/fix_style.sh -c ``` This adds a newline after all `}` on the first column, unless they are followed by `#` (typically `#endif`). This leads to having lots of places with two lines between function/class definitions, but clang-format then fixes it as we enforce max one line of separation. This doesn't fix potential occurrences of function definitions which are indented (e.g. for a helper class defined in a .cpp), but it's better than nothing. Also can't be made to run easily on CI/hooks so we'll have to be careful with new code. Part of #33027.
2020-05-14 20:29:06 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
uint32_t Light3D::get_cull_mask() const {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
return cull_mask;
}
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_color(const Color &p_color) {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
color = p_color;
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
if (GLOBAL_GET("rendering/lights_and_shadows/use_physical_light_units")) {
Color combined = color.srgb_to_linear();
combined *= correlated_color.srgb_to_linear();
RS::get_singleton()->light_set_color(light, combined.linear_to_srgb());
} else {
RS::get_singleton()->light_set_color(light, color);
}
Tint 3D light gizmos using the light's color This makes navigation more convenient in the 3D viewport, especially when using the unshaded display mode.
2020-01-01 07:52:20 +08:00
// The gizmo color depends on the light color, so update it.
Node3D gizmo improvements * Clean-up of node_3d_editor_plugin.{h,cpp}: removed unused code, fixed some bugs. * Moved node_3d_editor_gizmos.{h,cpp} to editor/plugins. * Added support for multiple gizmos per node. This means custom gizmos will no longer override the built-in ones and that multiple gizmos can be used in more complex nodes. * Added support for handle IDs. When adding handles to a gizmo, an ID can be specified for each one, making it easier to work with gizmos that have a variable number of handles. * Added support for subgizmos, selectable elements that can be transformed without needing a node of their own. By overriding _subgizmo_intersect_frustum() and/or _subgizmo_intersect_ray() gizmos can define which subgizmos should be selected on a region or click selection. Subgizmo transformations are applied using get/set/commit virtual methods, similar to how handles work.
2021-06-23 22:49:50 +08:00
update_gizmos();
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
}
Style: Enforce separation line between function definitions I couldn't find a tool that enforces it, so I went the manual route: ``` find -name "thirdparty" -prune \ -o -name "*.cpp" -o -name "*.h" -o -name "*.m" -o -name "*.mm" \ -o -name "*.glsl" > files perl -0777 -pi -e 's/\n}\n([^#])/\n}\n\n\1/g' $(cat files) misc/scripts/fix_style.sh -c ``` This adds a newline after all `}` on the first column, unless they are followed by `#` (typically `#endif`). This leads to having lots of places with two lines between function/class definitions, but clang-format then fixes it as we enforce max one line of separation. This doesn't fix potential occurrences of function definitions which are indented (e.g. for a helper class defined in a .cpp), but it's better than nothing. Also can't be made to run easily on CI/hooks so we'll have to be careful with new code. Part of #33027.
2020-05-14 20:29:06 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
Color Light3D::get_color() const {
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
return color;
}
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_shadow_reverse_cull_face(bool p_enable) {
-Fix all shadow and culling related issues, fixes #9330
2017-08-20 07:06:40 +08:00
reverse_cull = p_enable;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_set_reverse_cull_face_mode(light, reverse_cull);
-Fix all shadow and culling related issues, fixes #9330
2017-08-20 07:06:40 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
bool Light3D::get_shadow_reverse_cull_face() const {
-Fix all shadow and culling related issues, fixes #9330
2017-08-20 07:06:40 +08:00
return reverse_cull;
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
AABB Light3D::get_aabb() const {
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
if (type == RenderingServer::LIGHT_DIRECTIONAL) {
Rename Rect3 to AABB. Fixes #12973.
2017-11-17 10:09:00 +08:00
return AABB(Vector3(-1, -1, -1), Vector3(2, 2, 2));
remove trailing whitespace
2016-03-09 07:00:52 +08:00
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
} else if (type == RenderingServer::LIGHT_OMNI) {
Rename Rect3 to AABB. Fixes #12973.
2017-11-17 10:09:00 +08:00
return AABB(Vector3(-1, -1, -1) * param[PARAM_RANGE], Vector3(2, 2, 2) * param[PARAM_RANGE]);
remove trailing whitespace
2016-03-09 07:00:52 +08:00
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
} else if (type == RenderingServer::LIGHT_SPOT) {
Fix some SpotLight3D issues (clustering artifacts, light leak)
2023-01-24 08:08:32 +08:00
real_t cone_slant_height = param[PARAM_RANGE];
real_t cone_angle_rad = Math::deg_to_rad(param[PARAM_SPOT_ANGLE]);
if (cone_angle_rad > Math_PI / 2.0) {
// Just return the AABB of an omni light if the spot angle is above 90 degrees.
return AABB(Vector3(-1, -1, -1) * cone_slant_height, Vector3(2, 2, 2) * cone_slant_height);
}
real_t size = Math::sin(cone_angle_rad) * cone_slant_height;
return AABB(Vector3(-size, -size, -cone_slant_height), Vector3(2 * size, 2 * size, cone_slant_height));
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Rename Rect3 to AABB. Fixes #12973.
2017-11-17 10:09:00 +08:00
return AABB();
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Revert "Update Node::get_configuration_warnings signature" This reverts commit d3852deaa450d77edb30df2bb1c77bd7bc45befc.
2024-02-18 02:03:21 +08:00
PackedStringArray Light3D::get_configuration_warnings() const {
PackedStringArray warnings = VisualInstance3D::get_configuration_warnings();
Show warning when scaling Light3D nodes
2022-10-10 20:33:51 +08:00
if (!get_scale().is_equal_approx(Vector3(1, 1, 1))) {
warnings.push_back(RTR("A light's scale does not affect the visual size of the light."));
}
return warnings;
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_bake_mode(BakeMode p_mode) {
-Add lightmapper -Fixes to unwrapper (remove degenerates), makes Thekla not crash -Added optional cancel button in EditorProgress -Added function to force processing of events (needed for cancel button)
2017-12-14 19:59:46 +08:00
bake_mode = p_mode;
Addition of SDFGI for open world global illumination Move GI to a deferred pass
2020-06-25 21:33:28 +08:00
RS::get_singleton()->light_set_bake_mode(light, RS::LightBakeMode(p_mode));
-Add lightmapper -Fixes to unwrapper (remove degenerates), makes Thekla not crash -Added optional cancel button in EditorProgress -Added function to force processing of events (needed for cancel button)
2017-12-14 19:59:46 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
Light3D::BakeMode Light3D::get_bake_mode() const {
-Add lightmapper -Fixes to unwrapper (remove degenerates), makes Thekla not crash -Added optional cancel button in EditorProgress -Added function to force processing of events (needed for cancel button)
2017-12-14 19:59:46 +08:00
return bake_mode;
}
Fix typo in light3d (Texture -> Texture2D)
2020-04-15 15:09:48 +08:00
void Light3D::set_projector(const Ref<Texture2D> &p_texture) {
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
projector = p_texture;
RID tex_id = projector.is_valid() ? projector->get_rid() : RID();
RS::get_singleton()->light_set_projector(light, tex_id);
Use Array for node configuration warnings Previously, the warnings were passed as a string and delimitation of which were hard coded at each implementation.
2020-10-29 18:01:28 +08:00
update_configuration_warnings();
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
}
Ref<Texture2D> Light3D::get_projector() const {
return projector;
}
Fix editor-only visibility for lights * Update visibility again for editor-only lights if owner changes. Fixes #26399, supersedes #52327
2022-06-23 14:19:18 +08:00
void Light3D::owner_changed_notify() {
// For cases where owner changes _after_ entering tree (as example, editor editing).
_update_visibility();
}
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
// Temperature expressed in Kelvins. Valid range 1000 - 15000
// First converts to CIE 1960 then to sRGB
// As explained in the Filament documentation: https://google.github.io/filament/Filament.md.html#lighting/directlighting/lightsparameterization
Color _color_from_temperature(float p_temperature) {
float T2 = p_temperature * p_temperature;
float u = (0.860117757f + 1.54118254e-4f * p_temperature + 1.28641212e-7f * T2) /
(1.0f + 8.42420235e-4f * p_temperature + 7.08145163e-7f * T2);
float v = (0.317398726f + 4.22806245e-5f * p_temperature + 4.20481691e-8f * T2) /
(1.0f - 2.89741816e-5f * p_temperature + 1.61456053e-7f * T2);
// Convert to xyY space.
float d = 1.0f / (2.0f * u - 8.0f * v + 4.0f);
float x = 3.0f * u * d;
float y = 2.0f * v * d;
// Convert to XYZ space
const float a = 1.0 / MAX(y, 1e-5f);
Vector3 xyz = Vector3(x * a, 1.0, (1.0f - x - y) * a);
// Convert from XYZ to sRGB(linear)
Vector3 linear = Vector3(3.2404542f * xyz.x - 1.5371385f * xyz.y - 0.4985314f * xyz.z,
-0.9692660f * xyz.x + 1.8760108f * xyz.y + 0.0415560f * xyz.z,
0.0556434f * xyz.x - 0.2040259f * xyz.y + 1.0572252f * xyz.z);
linear /= MAX(1e-5f, linear[linear.max_axis_index()]);
// Normalize, clamp, and convert to sRGB.
return Color(linear.x, linear.y, linear.z).clamp().linear_to_srgb();
}
void Light3D::set_temperature(const float p_temperature) {
temperature = p_temperature;
if (!GLOBAL_GET("rendering/lights_and_shadows/use_physical_light_units")) {
return;
}
correlated_color = _color_from_temperature(temperature);
Color combined = color.srgb_to_linear() * correlated_color.srgb_to_linear();
RS::get_singleton()->light_set_color(light, combined.linear_to_srgb());
// The gizmo color depends on the light color, so update it.
update_gizmos();
}
Color Light3D::get_correlated_color() const {
return correlated_color;
}
float Light3D::get_temperature() const {
return temperature;
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::_update_visibility() {
Style: Enforce braces around if blocks and loops Using clang-tidy's `readability-braces-around-statements`. https://clang.llvm.org/extra/clang-tidy/checks/readability-braces-around-statements.html
2020-05-14 22:41:43 +08:00
if (!is_inside_tree()) {
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
return;
Style: Enforce braces around if blocks and loops Using clang-tidy's `readability-braces-around-statements`. https://clang.llvm.org/extra/clang-tidy/checks/readability-braces-around-statements.html
2020-05-14 22:41:43 +08:00
}
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
Begining of GLES3 renderer: -Most 2D drawing is implemented -Missing shaders -Missing all 3D -Editor needs to be set on update always to be used, otherwise it does not refresh -Large parts of editor not working
2016-10-04 03:33:42 +08:00
bool editor_ok = true;
Collada -=-=-=- -Fixed some DAE import & export bugs -Changed Collada exporter to use the mesh loops API -Added tangent export to Collada exporter -Added triangulation option to Collada exporter -Changed a little how normalmaps are handled in shader. Not sure if it's working properly, be careful. -Fixed some strange bug with kinematic bodies #776 -Fix release compilaiton issues #782
2014-10-14 12:01:25 +08:00
#ifdef TOOLS_ENABLED
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
if (editor_only) {
Removes editor_hint from SceneTree
2017-08-19 07:02:56 +08:00
if (!Engine::get_singleton()->is_editor_hint()) {
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
editor_ok = false;
} else {
SceneMainLoop -> SceneTree -=-=-=-=-=-=-=-=-=-=-=-=-=- *YOUR SOURCE MIGHT NOT WORK* For mor information on fix: https://github.com/okamstudio/godot/wiki/devel_scene_tree Other stuff: -Shower of bullets demo -Fixes all around
2014-11-06 08:20:42 +08:00
editor_ok = (get_tree()->get_edited_scene_root() && (this == get_tree()->get_edited_scene_root() || get_owner() == get_tree()->get_edited_scene_root()));
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
}
}
light: respect editor_only setting in release build and dont show the light
2016-10-03 22:23:43 +08:00
#else
if (editor_only) {
editor_ok = false;
}
Collada -=-=-=- -Fixed some DAE import & export bugs -Changed Collada exporter to use the mesh loops API -Added tangent export to Collada exporter -Added triangulation option to Collada exporter -Changed a little how normalmaps are handled in shader. Not sure if it's working properly, be careful. -Fixed some strange bug with kinematic bodies #776 -Fix release compilaiton issues #782
2014-10-14 12:01:25 +08:00
#endif
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->instance_set_visible(get_instance(), is_visible_in_tree() && editor_ok);
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::_notification(int p_what) {
Use `switch` consistently in `_notification` (`scene` folder)
2022-02-16 01:06:48 +08:00
switch (p_what) {
Light3D show scaling warning immediately
2022-10-30 04:15:27 +08:00
case NOTIFICATION_TRANSFORM_CHANGED: {
update_configuration_warnings();
} break;
Use `switch` consistently in `_notification` (`scene` folder)
2022-02-16 01:06:48 +08:00
case NOTIFICATION_VISIBILITY_CHANGED:
case NOTIFICATION_ENTER_TREE: {
_update_visibility();
} break;
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
}
Light Baker! -=-=-=-=-=-= -Support for lightmap baker, have fun figuring out how it works before tutorial is published.
2014-06-11 21:41:03 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::set_editor_only(bool p_editor_only) {
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
editor_only = p_editor_only;
_update_visibility();
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
bool Light3D::is_editor_only() const {
Little Bits -=-=-=-=-=- -fix duplicate function bug when creating script callback in editor -fix bug where hiding lights does not work -fix 2D audio listener bug (romulox_x reported) -fix exported properties with inheritance bug -fix timer autostart (make it not work on editor) -reactivate first camara found if viewport runs out of active camera -option to hide gizmos in viewport -changed skeleton gizmo because it sucks -Make convex shapes using CollisionShape visible (use quickhull class) -fix up menu when editing a mesh, to export collision, navmesh, convex, etc. from it. -make a menu option to show SRGB in 3D editor views by default -make option to edit default light direction in viewport settings -make option to edit default ambient light in viewport settings -make software conversion of linear->RGB if hardware support not found
2014-10-12 13:13:22 +08:00
return editor_only;
}
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
void Light3D::_validate_property(PropertyInfo &p_property) const {
Add a per-light volumetric fog energy property Per-light energy gives more control to the user on the final result of volumetric fog. Specific lights can be fully excluded from volumetric fog by setting their volumetric fog energy to 0, which improves performance slightly. This can also be used to prevent short-lived dynamic effects from poorly interacting with volumetric fog, as it's updated over several frames by default unless temporal reprojection is disabled. Volumetric fog shadows now obey Light3D's Shadow Opacity property as well. The shadow fog fade property was removed as it had little visible impact on the final scene's rendering.
2021-07-09 16:28:33 +08:00
if (!shadow && (p_property.name == "shadow_bias" || p_property.name == "shadow_normal_bias" || p_property.name == "shadow_reverse_cull_face" || p_property.name == "shadow_transmittance_bias" || p_property.name == "shadow_opacity" || p_property.name == "shadow_blur" || p_property.name == "distance_fade_shadow")) {
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
p_property.usage = PROPERTY_USAGE_NO_EDITOR;
Hide extra options from various nodes if they're not enabled
2020-02-14 10:34:59 +08:00
}
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
if (get_light_type() != RS::LIGHT_DIRECTIONAL && (p_property.name == "light_angular_distance" || p_property.name == "light_intensity_lux")) {
// Angular distance and Light Intensity Lux are only used in DirectionalLight3D.
p_property.usage = PROPERTY_USAGE_NONE;
} else if (get_light_type() == RS::LIGHT_DIRECTIONAL && p_property.name == "light_intensity_lumens") {
p_property.usage = PROPERTY_USAGE_NONE;
}
if (!GLOBAL_GET("rendering/lights_and_shadows/use_physical_light_units") && (p_property.name == "light_intensity_lumens" || p_property.name == "light_intensity_lux" || p_property.name == "light_temperature")) {
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
p_property.usage = PROPERTY_USAGE_NONE;
Support light size and soft shadows
2020-04-10 02:11:15 +08:00
}
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
if (!distance_fade_enabled && (p_property.name == "distance_fade_begin" || p_property.name == "distance_fade_shadow" || p_property.name == "distance_fade_length")) {
p_property.usage = PROPERTY_USAGE_NO_EDITOR;
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
}
hide hdr and shadow_contact in gles2
2019-03-03 09:12:01 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void Light3D::_bind_methods() {
ClassDB::bind_method(D_METHOD("set_editor_only", "editor_only"), &Light3D::set_editor_only);
ClassDB::bind_method(D_METHOD("is_editor_only"), &Light3D::is_editor_only);
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_param", "param", "value"), &Light3D::set_param);
ClassDB::bind_method(D_METHOD("get_param", "param"), &Light3D::get_param);
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_shadow", "enabled"), &Light3D::set_shadow);
ClassDB::bind_method(D_METHOD("has_shadow"), &Light3D::has_shadow);
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_negative", "enabled"), &Light3D::set_negative);
ClassDB::bind_method(D_METHOD("is_negative"), &Light3D::is_negative);
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_cull_mask", "cull_mask"), &Light3D::set_cull_mask);
ClassDB::bind_method(D_METHOD("get_cull_mask"), &Light3D::get_cull_mask);
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
ClassDB::bind_method(D_METHOD("set_enable_distance_fade", "enable"), &Light3D::set_enable_distance_fade);
ClassDB::bind_method(D_METHOD("is_distance_fade_enabled"), &Light3D::is_distance_fade_enabled);
ClassDB::bind_method(D_METHOD("set_distance_fade_begin", "distance"), &Light3D::set_distance_fade_begin);
ClassDB::bind_method(D_METHOD("get_distance_fade_begin"), &Light3D::get_distance_fade_begin);
ClassDB::bind_method(D_METHOD("set_distance_fade_shadow", "distance"), &Light3D::set_distance_fade_shadow);
ClassDB::bind_method(D_METHOD("get_distance_fade_shadow"), &Light3D::get_distance_fade_shadow);
ClassDB::bind_method(D_METHOD("set_distance_fade_length", "distance"), &Light3D::set_distance_fade_length);
ClassDB::bind_method(D_METHOD("get_distance_fade_length"), &Light3D::get_distance_fade_length);
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_color", "color"), &Light3D::set_color);
ClassDB::bind_method(D_METHOD("get_color"), &Light3D::get_color);
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_shadow_reverse_cull_face", "enable"), &Light3D::set_shadow_reverse_cull_face);
ClassDB::bind_method(D_METHOD("get_shadow_reverse_cull_face"), &Light3D::get_shadow_reverse_cull_face);
-Fix all shadow and culling related issues, fixes #9330
2017-08-20 07:06:40 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_bake_mode", "bake_mode"), &Light3D::set_bake_mode);
ClassDB::bind_method(D_METHOD("get_bake_mode"), &Light3D::get_bake_mode);
-Add lightmapper -Fixes to unwrapper (remove degenerates), makes Thekla not crash -Added optional cancel button in EditorProgress -Added function to force processing of events (needed for cancel button)
2017-12-14 19:59:46 +08:00
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
ClassDB::bind_method(D_METHOD("set_projector", "projector"), &Light3D::set_projector);
ClassDB::bind_method(D_METHOD("get_projector"), &Light3D::get_projector);
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
ClassDB::bind_method(D_METHOD("set_temperature", "temperature"), &Light3D::set_temperature);
ClassDB::bind_method(D_METHOD("get_temperature"), &Light3D::get_temperature);
ClassDB::bind_method(D_METHOD("get_correlated_color"), &Light3D::get_correlated_color);
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("Light", "light_");
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_intensity_lumens", PROPERTY_HINT_RANGE, "0,100000.0,0.01,or_greater,suffix:lm"), "set_param", "get_param", PARAM_INTENSITY);
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_intensity_lux", PROPERTY_HINT_RANGE, "0,150000.0,0.01,or_greater,suffix:lx"), "set_param", "get_param", PARAM_INTENSITY);
ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "light_temperature", PROPERTY_HINT_RANGE, "1000,15000.0,1.0,suffix:k"), "set_temperature", "get_temperature");
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::COLOR, "light_color", PROPERTY_HINT_COLOR_NO_ALPHA), "set_color", "get_color");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_energy", PROPERTY_HINT_RANGE, "0,16,0.001,or_greater"), "set_param", "get_param", PARAM_ENERGY);
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_indirect_energy", PROPERTY_HINT_RANGE, "0,16,0.001,or_greater"), "set_param", "get_param", PARAM_INDIRECT_ENERGY);
Add a per-light volumetric fog energy property Per-light energy gives more control to the user on the final result of volumetric fog. Specific lights can be fully excluded from volumetric fog by setting their volumetric fog energy to 0, which improves performance slightly. This can also be used to prevent short-lived dynamic effects from poorly interacting with volumetric fog, as it's updated over several frames by default unless temporal reprojection is disabled. Volumetric fog shadows now obey Light3D's Shadow Opacity property as well. The shadow fog fade property was removed as it had little visible impact on the final scene's rendering.
2021-07-09 16:28:33 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_volumetric_fog_energy", PROPERTY_HINT_RANGE, "0,16,0.001,or_greater"), "set_param", "get_param", PARAM_VOLUMETRIC_FOG_ENERGY);
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "light_projector", PROPERTY_HINT_RESOURCE_TYPE, "Texture2D"), "set_projector", "get_projector");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_size", PROPERTY_HINT_RANGE, "0,1,0.001,or_greater,suffix:m"), "set_param", "get_param", PARAM_SIZE);
Fix Light3D `angular_distance` property hint being in radians The unit is internally stored as degrees and is treated as such, so it should be displayed as-is in the inspector.
2022-06-18 02:00:54 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_angular_distance", PROPERTY_HINT_RANGE, "0,90,0.01,degrees"), "set_param", "get_param", PARAM_SIZE);
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "light_negative"), "set_negative", "is_negative");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "light_specular", PROPERTY_HINT_RANGE, "0,16,0.001,or_greater"), "set_param", "get_param", PARAM_SPECULAR);
Remove GI methods in parentheses from light baking options
2023-11-22 22:16:53 +08:00
ADD_PROPERTY(PropertyInfo(Variant::INT, "light_bake_mode", PROPERTY_HINT_ENUM, "Disabled,Static,Dynamic"), "set_bake_mode", "get_bake_mode");
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::INT, "light_cull_mask", PROPERTY_HINT_LAYERS_3D_RENDER), "set_cull_mask", "get_cull_mask");
Fix missing Distance Fade category in OmniLight3D/SpotLight3D inspector
2022-07-26 01:11:24 +08:00
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("Shadow", "shadow_");
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "shadow_enabled"), "set_shadow", "has_shadow");
Refactored shadowmapping. - Made shadow bias size independent, so it will remain when changing light or camera size. - Implemented normal offset bias, which greatly enhances quality. - Added transmission to subsurface scattering - Reimplemented shadow filter modes Closes #17260
2020-04-08 09:51:52 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "shadow_bias", PROPERTY_HINT_RANGE, "0,10,0.001"), "set_param", "get_param", PARAM_SHADOW_BIAS);
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "shadow_normal_bias", PROPERTY_HINT_RANGE, "0,10,0.001"), "set_param", "get_param", PARAM_SHADOW_NORMAL_BIAS);
-Fix all shadow and culling related issues, fixes #9330
2017-08-20 07:06:40 +08:00
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "shadow_reverse_cull_face"), "set_shadow_reverse_cull_face", "get_shadow_reverse_cull_face");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "shadow_transmittance_bias", PROPERTY_HINT_RANGE, "-16,16,0.001"), "set_param", "get_param", PARAM_TRANSMITTANCE_BIAS);
Add a shadow opacity property to Light3D This can be used to make shadows translucent for a specific light. The light distance fade system also uses this to smoothly fade the shadow when the light fade transition distance is greater than 0.
2022-06-10 18:47:06 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "shadow_opacity", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_param", "get_param", PARAM_SHADOW_OPACITY);
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "shadow_blur", PROPERTY_HINT_RANGE, "0,10,0.001"), "set_param", "get_param", PARAM_SHADOW_BLUR);
Fix missing Distance Fade category in OmniLight3D/SpotLight3D inspector
2022-07-26 01:11:24 +08:00
ADD_GROUP("Distance Fade", "distance_fade_");
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "distance_fade_enabled"), "set_enable_distance_fade", "is_distance_fade_enabled");
Add suffixes to all nodes and resources
2022-05-20 13:24:41 +08:00
ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "distance_fade_begin", PROPERTY_HINT_RANGE, "0.0,4096.0,0.01,or_greater,suffix:m"), "set_distance_fade_begin", "get_distance_fade_begin");
ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "distance_fade_shadow", PROPERTY_HINT_RANGE, "0.0,4096.0,0.01,or_greater,suffix:m"), "set_distance_fade_shadow", "get_distance_fade_shadow");
ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "distance_fade_length", PROPERTY_HINT_RANGE, "0.0,4096.0,0.01,or_greater,suffix:m"), "set_distance_fade_length", "get_distance_fade_length");
Fix missing Distance Fade category in OmniLight3D/SpotLight3D inspector
2022-07-26 01:11:24 +08:00
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("Editor", "");
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "editor_only"), "set_editor_only", "is_editor_only");
Fix missing Distance Fade category in OmniLight3D/SpotLight3D inspector
2022-07-26 01:11:24 +08:00
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("", "");
A Whole New World (clang-format edition) I can show you the code Pretty, with proper whitespace Tell me, coder, now when did You last write readable code? I can open your eyes Make you see your bad indent Force you to respect the style The core devs agreed upon A whole new world A new fantastic code format A de facto standard With some sugar Enforced with clang-format A whole new world A dazzling style we all dreamed of And when we read it through It's crystal clear That now we're in a whole new world of code
2017-03-05 23:44:50 +08:00
ClassDB: Provide the enum name of integer constants
2017-08-20 23:45:01 +08:00
BIND_ENUM_CONSTANT(PARAM_ENERGY);
Ability to change indirect light energy.
2017-11-20 08:45:42 +08:00
BIND_ENUM_CONSTANT(PARAM_INDIRECT_ENERGY);
Add a per-light volumetric fog energy property Per-light energy gives more control to the user on the final result of volumetric fog. Specific lights can be fully excluded from volumetric fog by setting their volumetric fog energy to 0, which improves performance slightly. This can also be used to prevent short-lived dynamic effects from poorly interacting with volumetric fog, as it's updated over several frames by default unless temporal reprojection is disabled. Volumetric fog shadows now obey Light3D's Shadow Opacity property as well. The shadow fog fade property was removed as it had little visible impact on the final scene's rendering.
2021-07-09 16:28:33 +08:00
BIND_ENUM_CONSTANT(PARAM_VOLUMETRIC_FOG_ENERGY);
ClassDB: Provide the enum name of integer constants
2017-08-20 23:45:01 +08:00
BIND_ENUM_CONSTANT(PARAM_SPECULAR);
BIND_ENUM_CONSTANT(PARAM_RANGE);
doc: Sync classref with current source Add missing enum bindings.
2020-04-20 17:48:00 +08:00
BIND_ENUM_CONSTANT(PARAM_SIZE);
ClassDB: Provide the enum name of integer constants
2017-08-20 23:45:01 +08:00
BIND_ENUM_CONSTANT(PARAM_ATTENUATION);
BIND_ENUM_CONSTANT(PARAM_SPOT_ANGLE);
BIND_ENUM_CONSTANT(PARAM_SPOT_ATTENUATION);
BIND_ENUM_CONSTANT(PARAM_SHADOW_MAX_DISTANCE);
BIND_ENUM_CONSTANT(PARAM_SHADOW_SPLIT_1_OFFSET);
BIND_ENUM_CONSTANT(PARAM_SHADOW_SPLIT_2_OFFSET);
BIND_ENUM_CONSTANT(PARAM_SHADOW_SPLIT_3_OFFSET);
Directional lights and shadow mapping are functional.
2019-09-08 01:38:17 +08:00
BIND_ENUM_CONSTANT(PARAM_SHADOW_FADE_START);
ClassDB: Provide the enum name of integer constants
2017-08-20 23:45:01 +08:00
BIND_ENUM_CONSTANT(PARAM_SHADOW_NORMAL_BIAS);
BIND_ENUM_CONSTANT(PARAM_SHADOW_BIAS);
Refactored shadowmapping. - Made shadow bias size independent, so it will remain when changing light or camera size. - Implemented normal offset bias, which greatly enhances quality. - Added transmission to subsurface scattering - Reimplemented shadow filter modes Closes #17260
2020-04-08 09:51:52 +08:00
BIND_ENUM_CONSTANT(PARAM_SHADOW_PANCAKE_SIZE);
Add a shadow opacity property to Light3D This can be used to make shadows translucent for a specific light. The light distance fade system also uses this to smoothly fade the shadow when the light fade transition distance is greater than 0.
2022-06-10 18:47:06 +08:00
BIND_ENUM_CONSTANT(PARAM_SHADOW_OPACITY);
Add proper quality settings to soft shadows
2020-04-10 17:30:36 +08:00
BIND_ENUM_CONSTANT(PARAM_SHADOW_BLUR);
Refactored shadowmapping. - Made shadow bias size independent, so it will remain when changing light or camera size. - Implemented normal offset bias, which greatly enhances quality. - Added transmission to subsurface scattering - Reimplemented shadow filter modes Closes #17260
2020-04-08 09:51:52 +08:00
BIND_ENUM_CONSTANT(PARAM_TRANSMITTANCE_BIAS);
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
BIND_ENUM_CONSTANT(PARAM_INTENSITY);
ClassDB: Provide the enum name of integer constants
2017-08-20 23:45:01 +08:00
BIND_ENUM_CONSTANT(PARAM_MAX);
-Add lightmapper -Fixes to unwrapper (remove degenerates), makes Thekla not crash -Added optional cancel button in EditorProgress -Added function to force processing of events (needed for cancel button)
2017-12-14 19:59:46 +08:00
BIND_ENUM_CONSTANT(BAKE_DISABLED);
Addition of SDFGI for open world global illumination Move GI to a deferred pass
2020-06-25 21:33:28 +08:00
BIND_ENUM_CONSTANT(BAKE_STATIC);
Rename and reorder bake mode properties for consistency The order now goes from least to most computationally expensive: - Disabled - Static - Dynamic
2021-11-27 00:47:37 +08:00
BIND_ENUM_CONSTANT(BAKE_DYNAMIC);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
Light3D::Light3D(RenderingServer::LightType p_type) {
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
type = p_type;
Reworked how servers preallocate RIDs, should fix #10970
2017-11-10 10:34:01 +08:00
switch (p_type) {
Style: clang-format: Disable AllowShortCaseLabelsOnASingleLine Part of #33027.
2020-05-10 19:00:47 +08:00
case RS::LIGHT_DIRECTIONAL:
light = RenderingServer::get_singleton()->directional_light_create();
break;
case RS::LIGHT_OMNI:
light = RenderingServer::get_singleton()->omni_light_create();
break;
case RS::LIGHT_SPOT:
light = RenderingServer::get_singleton()->spot_light_create();
break;
Style: Apply new changes from clang-format 8.0 It seems to stay compatible with formatting done by clang-format 6.0 and 7.0, so contributors can keep using those versions for now (they will not undo those changes).
2019-04-09 23:08:36 +08:00
default: {
};
Reworked how servers preallocate RIDs, should fix #10970
2017-11-10 10:34:01 +08:00
}
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->instance_set_base(get_instance(), light);
Begining of GLES3 renderer: -Most 2D drawing is implemented -Missing shaders -Missing all 3D -Editor needs to be set on update always to be used, otherwise it does not refresh -Large parts of editor not working
2016-10-04 03:33:42 +08:00
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
set_color(Color(1, 1, 1, 1));
set_shadow(false);
set_negative(false);
set_cull_mask(0xFFFFFFFF);
set_param(PARAM_ENERGY, 1);
Ability to change indirect light energy.
2017-11-20 08:45:42 +08:00
set_param(PARAM_INDIRECT_ENERGY, 1);
Add a per-light volumetric fog energy property Per-light energy gives more control to the user on the final result of volumetric fog. Specific lights can be fully excluded from volumetric fog by setting their volumetric fog energy to 0, which improves performance slightly. This can also be used to prevent short-lived dynamic effects from poorly interacting with volumetric fog, as it's updated over several frames by default unless temporal reprojection is disabled. Volumetric fog shadows now obey Light3D's Shadow Opacity property as well. The shadow fog fade property was removed as it had little visible impact on the final scene's rendering.
2021-07-09 16:28:33 +08:00
set_param(PARAM_VOLUMETRIC_FOG_ENERGY, 1);
Huge amount of improvement in the material system. Materials should be a lot more complete and usable now.
2016-11-21 09:49:53 +08:00
set_param(PARAM_SPECULAR, 0.5);
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
set_param(PARAM_RANGE, 5);
Support light size and soft shadows
2020-04-10 02:11:15 +08:00
set_param(PARAM_SIZE, 0);
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
set_param(PARAM_ATTENUATION, 1);
set_param(PARAM_SPOT_ANGLE, 45);
set_param(PARAM_SPOT_ATTENUATION, 1);
set_param(PARAM_SHADOW_MAX_DISTANCE, 0);
set_param(PARAM_SHADOW_SPLIT_1_OFFSET, 0.1);
set_param(PARAM_SHADOW_SPLIT_2_OFFSET, 0.2);
set_param(PARAM_SHADOW_SPLIT_3_OFFSET, 0.5);
Directional lights and shadow mapping are functional.
2019-09-08 01:38:17 +08:00
set_param(PARAM_SHADOW_FADE_START, 0.8);
Refactored shadowmapping. - Made shadow bias size independent, so it will remain when changing light or camera size. - Implemented normal offset bias, which greatly enhances quality. - Added transmission to subsurface scattering - Reimplemented shadow filter modes Closes #17260
2020-04-08 09:51:52 +08:00
set_param(PARAM_SHADOW_PANCAKE_SIZE, 20.0);
Add a shadow opacity property to Light3D This can be used to make shadows translucent for a specific light. The light distance fade system also uses this to smoothly fade the shadow when the light fade transition distance is greater than 0.
2022-06-10 18:47:06 +08:00
set_param(PARAM_SHADOW_OPACITY, 1.0);
Add proper quality settings to soft shadows
2020-04-10 17:30:36 +08:00
set_param(PARAM_SHADOW_BLUR, 1.0);
Tweak shadow bias defaults for DirectionalLight3D and OmniLight3D - Increase DirectionalLight3D normal bias to 2.0 to reduce shadow acne at grazing angles. - Decrease OmniLight3D bias to 0.1 to reduce shadow peter-panning.
2022-12-06 04:44:23 +08:00
set_param(PARAM_SHADOW_BIAS, 0.1);
Refactored shadowmapping. - Made shadow bias size independent, so it will remain when changing light or camera size. - Implemented normal offset bias, which greatly enhances quality. - Added transmission to subsurface scattering - Reimplemented shadow filter modes Closes #17260
2020-04-08 09:51:52 +08:00
set_param(PARAM_SHADOW_NORMAL_BIAS, 1.0);
set_param(PARAM_TRANSMITTANCE_BIAS, 0.05);
Directional lights and shadow mapping are functional.
2019-09-08 01:38:17 +08:00
set_param(PARAM_SHADOW_FADE_START, 1);
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
// For OmniLight3D and SpotLight3D, specified in Lumens.
set_param(PARAM_INTENSITY, 1000.0);
set_temperature(6500.0); // Nearly white.
Ability to disable scale in nodes, closes #19927
2018-07-19 00:47:42 +08:00
set_disable_scale(true);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
Light3D::Light3D() {
Rename `instance()`->`instantiate()` when it's a verb
2021-06-18 06:03:09 +08:00
ERR_PRINT("Light3D should not be instantiated directly; use the DirectionalLight3D, OmniLight3D or SpotLight3D subtypes instead.");
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
Light3D::~Light3D() {
Add safety-checks before some servers `free()`
2022-12-13 01:42:37 +08:00
ERR_FAIL_NULL(RenderingServer::get_singleton());
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->instance_set_base(get_instance(), RID());
PBR more or less working, still working on bringing gizmos back
2016-10-27 22:50:26 +08:00
Style: Enforce braces around if blocks and loops Using clang-tidy's `readability-braces-around-statements`. https://clang.llvm.org/extra/clang-tidy/checks/readability-braces-around-statements.html
2020-05-14 22:41:43 +08:00
if (light.is_valid()) {
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RenderingServer::get_singleton()->free(light);
Style: Enforce braces around if blocks and loops Using clang-tidy's `readability-braces-around-statements`. https://clang.llvm.org/extra/clang-tidy/checks/readability-braces-around-statements.html
2020-05-14 22:41:43 +08:00
}
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Style: Enforce separation line between function definitions I couldn't find a tool that enforces it, so I went the manual route: ``` find -name "thirdparty" -prune \ -o -name "*.cpp" -o -name "*.h" -o -name "*.m" -o -name "*.mm" \ -o -name "*.glsl" > files perl -0777 -pi -e 's/\n}\n([^#])/\n}\n\n\1/g' $(cat files) misc/scripts/fix_style.sh -c ``` This adds a newline after all `}` on the first column, unless they are followed by `#` (typically `#endif`). This leads to having lots of places with two lines between function/class definitions, but clang-format then fixes it as we enforce max one line of separation. This doesn't fix potential occurrences of function definitions which are indented (e.g. for a helper class defined in a .cpp), but it's better than nothing. Also can't be made to run easily on CI/hooks so we'll have to be careful with new code. Part of #33027.
2020-05-14 20:29:06 +08:00
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
/////////////////////////////////////////
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void DirectionalLight3D::set_shadow_mode(ShadowMode p_mode) {
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
shadow_mode = p_mode;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_directional_set_shadow_mode(light, RS::LightDirectionalShadowMode(p_mode));
Only show relevant properties in the DirectionalLight3D inspector Some split distance properties are unused depending on the current shadow mode. Also, Blend Splits can only be used if the shadow mode is PSSM 2 Splits or PSSM 4 Splits. This also moves the Fade Start property to be located after the split properties. This avoids intertwining "conditional" properties with a property that's always available.
2021-10-23 18:41:10 +08:00
notify_property_list_changed();
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
DirectionalLight3D::ShadowMode DirectionalLight3D::get_shadow_mode() const {
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
return shadow_mode;
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void DirectionalLight3D::set_blend_splits(bool p_enable) {
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
blend_splits = p_enable;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_directional_set_blend_splits(light, p_enable);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
bool DirectionalLight3D::is_blend_splits_enabled() const {
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
return blend_splits;
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Replace DirectionalLight3D's `use_in_sky_only` with `sky_mode` enum 3 options are available: - Light and Sky (default) - Light Only (new) - Sky Only (equivalent to `use_in_sky_only = true`) Co-authored by: clayjohn <claynjohn@gmail.com>
2021-10-20 06:40:46 +08:00
void DirectionalLight3D::set_sky_mode(SkyMode p_mode) {
sky_mode = p_mode;
RS::get_singleton()->light_directional_set_sky_mode(light, RS::LightDirectionalSkyMode(p_mode));
Add sky_only setting to DirectionalLight3Ds
2020-10-22 14:22:53 +08:00
}
Replace DirectionalLight3D's `use_in_sky_only` with `sky_mode` enum 3 options are available: - Light and Sky (default) - Light Only (new) - Sky Only (equivalent to `use_in_sky_only = true`) Co-authored by: clayjohn <claynjohn@gmail.com>
2021-10-20 06:40:46 +08:00
DirectionalLight3D::SkyMode DirectionalLight3D::get_sky_mode() const {
return sky_mode;
Add sky_only setting to DirectionalLight3Ds
2020-10-22 14:22:53 +08:00
}
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
void DirectionalLight3D::_validate_property(PropertyInfo &p_property) const {
if (shadow_mode == SHADOW_ORTHOGONAL && (p_property.name == "directional_shadow_split_1" || p_property.name == "directional_shadow_blend_splits")) {
Fix properties being displayed when they shouldn't in DirectionalLight3D The parent `_validate_property()` wasn't called, which led to shadow properties being visible even if shadows were disabled on a DirectionalLight3D node.
2021-10-26 04:04:30 +08:00
// Split 2 and split blending are only used with the PSSM 2 Splits and PSSM 4 Splits shadow modes.
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
p_property.usage = PROPERTY_USAGE_NO_EDITOR;
Only show relevant properties in the DirectionalLight3D inspector Some split distance properties are unused depending on the current shadow mode. Also, Blend Splits can only be used if the shadow mode is PSSM 2 Splits or PSSM 4 Splits. This also moves the Fade Start property to be located after the split properties. This avoids intertwining "conditional" properties with a property that's always available.
2021-10-23 18:41:10 +08:00
}
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
if ((shadow_mode == SHADOW_ORTHOGONAL || shadow_mode == SHADOW_PARALLEL_2_SPLITS) && (p_property.name == "directional_shadow_split_2" || p_property.name == "directional_shadow_split_3")) {
Fix properties being displayed when they shouldn't in DirectionalLight3D The parent `_validate_property()` wasn't called, which led to shadow properties being visible even if shadows were disabled on a DirectionalLight3D node.
2021-10-26 04:04:30 +08:00
// Splits 3 and 4 are only used with the PSSM 4 Splits shadow mode.
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
p_property.usage = PROPERTY_USAGE_NO_EDITOR;
Only show relevant properties in the DirectionalLight3D inspector Some split distance properties are unused depending on the current shadow mode. Also, Blend Splits can only be used if the shadow mode is PSSM 2 Splits or PSSM 4 Splits. This also moves the Fade Start property to be located after the split properties. This avoids intertwining "conditional" properties with a property that's always available.
2021-10-23 18:41:10 +08:00
}
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
if (p_property.name == "light_size" || p_property.name == "light_projector" || p_property.name == "light_specular") {
Only show relevant properties in the DirectionalLight3D inspector Some split distance properties are unused depending on the current shadow mode. Also, Blend Splits can only be used if the shadow mode is PSSM 2 Splits or PSSM 4 Splits. This also moves the Fade Start property to be located after the split properties. This avoids intertwining "conditional" properties with a property that's always available.
2021-10-23 18:41:10 +08:00
// Not implemented in DirectionalLight3D (`light_size` is replaced by `light_angular_distance`).
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
p_property.usage = PROPERTY_USAGE_NONE;
Only show relevant properties in the DirectionalLight3D inspector Some split distance properties are unused depending on the current shadow mode. Also, Blend Splits can only be used if the shadow mode is PSSM 2 Splits or PSSM 4 Splits. This also moves the Fade Start property to be located after the split properties. This avoids intertwining "conditional" properties with a property that's always available.
2021-10-23 18:41:10 +08:00
}
Fix properties being displayed when they shouldn't in DirectionalLight3D The parent `_validate_property()` wasn't called, which led to shadow properties being visible even if shadows were disabled on a DirectionalLight3D node.
2021-10-26 04:04:30 +08:00
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
if (p_property.name == "distance_fade_enabled" || p_property.name == "distance_fade_begin" || p_property.name == "distance_fade_shadow" || p_property.name == "distance_fade_length") {
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
// Not relevant for DirectionalLight3D, as the light LOD system only pertains to point lights.
// For DirectionalLight3D, `directional_shadow_max_distance` can be used instead.
Make `_validate_property` a multilevel method
2022-08-13 04:57:11 +08:00
p_property.usage = PROPERTY_USAGE_NONE;
Implement distance fade properties in OmniLight3D and SpotLight3D This can be used to fade lights and their shadows in the distance, similar to Decal nodes. This can bring significant performance improvements, especially for lights with shadows enabled and when using higher-than-default shadow quality settings. While lights can be smoothly faded out over distance, shadows are currently "all or nothing" since per-light shadow color is no longer customizable in the Vulkan renderer. This may result in noticeable pop-in when leaving the shadow cutoff distance, but depending on the scene, it may not always be that noticeable.
2022-02-25 05:55:14 +08:00
}
Only show relevant properties in the DirectionalLight3D inspector Some split distance properties are unused depending on the current shadow mode. Also, Blend Splits can only be used if the shadow mode is PSSM 2 Splits or PSSM 4 Splits. This also moves the Fade Start property to be located after the split properties. This avoids intertwining "conditional" properties with a property that's always available.
2021-10-23 18:41:10 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void DirectionalLight3D::_bind_methods() {
ClassDB::bind_method(D_METHOD("set_shadow_mode", "mode"), &DirectionalLight3D::set_shadow_mode);
ClassDB::bind_method(D_METHOD("get_shadow_mode"), &DirectionalLight3D::get_shadow_mode);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
ClassDB::bind_method(D_METHOD("set_blend_splits", "enabled"), &DirectionalLight3D::set_blend_splits);
ClassDB::bind_method(D_METHOD("is_blend_splits_enabled"), &DirectionalLight3D::is_blend_splits_enabled);
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
Replace DirectionalLight3D's `use_in_sky_only` with `sky_mode` enum 3 options are available: - Light and Sky (default) - Light Only (new) - Sky Only (equivalent to `use_in_sky_only = true`) Co-authored by: clayjohn <claynjohn@gmail.com>
2021-10-20 06:40:46 +08:00
ClassDB::bind_method(D_METHOD("set_sky_mode", "mode"), &DirectionalLight3D::set_sky_mode);
ClassDB::bind_method(D_METHOD("get_sky_mode"), &DirectionalLight3D::get_sky_mode);
Add sky_only setting to DirectionalLight3Ds
2020-10-22 14:22:53 +08:00
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("Directional Shadow", "directional_shadow_");
Add performance hints to the DirectionalLight shadow mode property hint This also clarifies some parts in the DirectionalLight documentation.
2020-06-01 07:20:35 +08:00
ADD_PROPERTY(PropertyInfo(Variant::INT, "directional_shadow_mode", PROPERTY_HINT_ENUM, "Orthogonal (Fast),PSSM 2 Splits (Average),PSSM 4 Splits (Slow)"), "set_shadow_mode", "get_shadow_mode");
Variant: Added 64-bit packed arrays, renamed Variant::REAL to FLOAT. - Renames PackedIntArray to PackedInt32Array. - Renames PackedFloatArray to PackedFloat32Array. - Adds PackedInt64Array and PackedFloat64Array. - Renames Variant::REAL to Variant::FLOAT for consistency. Packed arrays are for storing large amount of data and creating stuff like meshes, buffers. textures, etc. Forcing them to be 64 is a huge waste of memory. That said, many users requested the ability to have 64 bits packed arrays for their games, so this is just an optional added type. For Variant, the float datatype is always 64 bits, and exposed as `float`. We still have `real_t` which is the datatype that can change from 32 to 64 bits depending on a compile flag (not entirely working right now, but that's the idea). It affects math related datatypes and code only. Neither Variant nor PackedArray make use of real_t, which is only intended for math precision, so the term is removed from there to keep only float.
2020-02-25 02:20:53 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "directional_shadow_split_1", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_param", "get_param", PARAM_SHADOW_SPLIT_1_OFFSET);
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "directional_shadow_split_2", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_param", "get_param", PARAM_SHADOW_SPLIT_2_OFFSET);
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "directional_shadow_split_3", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_param", "get_param", PARAM_SHADOW_SPLIT_3_OFFSET);
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "directional_shadow_blend_splits"), "set_blend_splits", "is_blend_splits_enabled");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "directional_shadow_fade_start", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_param", "get_param", PARAM_SHADOW_FADE_START);
Fix editor suffixes and degrees conversion * Functions to convert to/from degrees are all gone. Conversion is done by the editor. * Use PROPERTY_HINT_ANGLE instead of PROPERTY_HINT_RANGE to edit radian angles in degrees. * Added possibility to add suffixes to range properties, use "min,max[,step][,suffix:<something>]" example "0,100,1,suffix:m" * In general, can add suffixes for EditorSpinSlider Not covered by this PR, will have to be addressed by future ones: * Ability to switch radians/degrees in the inspector for angle properties (if actually wanted). * Animations previously made will most likely break, need to add a way to make old ones compatible. * Only added a "px" suffix to 2D position and a "m" one to 3D position, someone needs to go through the rest of the engine and add all remaining suffixes. * Likely also need to track down usage of EditorSpinSlider outside properties to add suffixes to it too.
2021-06-30 03:42:12 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "directional_shadow_max_distance", PROPERTY_HINT_RANGE, "0,8192,0.1,or_greater,exp"), "set_param", "get_param", PARAM_SHADOW_MAX_DISTANCE);
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "directional_shadow_pancake_size", PROPERTY_HINT_RANGE, "0,1024,0.1,or_greater,exp"), "set_param", "get_param", PARAM_SHADOW_PANCAKE_SIZE);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
Replace DirectionalLight3D's `use_in_sky_only` with `sky_mode` enum 3 options are available: - Light and Sky (default) - Light Only (new) - Sky Only (equivalent to `use_in_sky_only = true`) Co-authored by: clayjohn <claynjohn@gmail.com>
2021-10-20 06:40:46 +08:00
ADD_PROPERTY(PropertyInfo(Variant::INT, "sky_mode", PROPERTY_HINT_ENUM, "Light and Sky,Light Only,Sky Only"), "set_sky_mode", "get_sky_mode");
Add sky_only setting to DirectionalLight3Ds
2020-10-22 14:22:53 +08:00
ClassDB: Provide the enum name of integer constants
2017-08-20 23:45:01 +08:00
BIND_ENUM_CONSTANT(SHADOW_ORTHOGONAL);
BIND_ENUM_CONSTANT(SHADOW_PARALLEL_2_SPLITS);
BIND_ENUM_CONSTANT(SHADOW_PARALLEL_4_SPLITS);
Replace DirectionalLight3D's `use_in_sky_only` with `sky_mode` enum 3 options are available: - Light and Sky (default) - Light Only (new) - Sky Only (equivalent to `use_in_sky_only = true`) Co-authored by: clayjohn <claynjohn@gmail.com>
2021-10-20 06:40:46 +08:00
BIND_ENUM_CONSTANT(SKY_MODE_LIGHT_AND_SKY);
BIND_ENUM_CONSTANT(SKY_MODE_LIGHT_ONLY);
BIND_ENUM_CONSTANT(SKY_MODE_SKY_ONLY);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
DirectionalLight3D::DirectionalLight3D() :
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
Light3D(RenderingServer::LIGHT_DIRECTIONAL) {
Lower the default directional shadow maximum distance to 100 With the default camera node settings, this makes directional shadows look consistent between the editor and the running project. The original issue occurs because the editor camera defaults to a Z-far value of 500, whereas the Camera node defaults to a Z-far value of 100. Since the directional shadow maximum distance is clamped to the Z-far value, it caused the running project's effective shadow distance to be lower compared to the editor (100 instead of 200). This partially addresses #13575.
2019-07-18 01:44:00 +08:00
set_param(PARAM_SHADOW_MAX_DISTANCE, 100);
Directional lights and shadow mapping are functional.
2019-09-08 01:38:17 +08:00
set_param(PARAM_SHADOW_FADE_START, 0.8);
Tweak shadow bias defaults for DirectionalLight3D and OmniLight3D - Increase DirectionalLight3D normal bias to 2.0 to reduce shadow acne at grazing angles. - Decrease OmniLight3D bias to 0.1 to reduce shadow peter-panning.
2022-12-06 04:44:23 +08:00
// Increase the default shadow normal bias to better suit most scenes.
set_param(PARAM_SHADOW_NORMAL_BIAS, 2.0);
Implement Physical Light Units as an optional setting. This allows light sources to be specified in physical light units in addition to the regular energy multiplier. In order to avoid loss of precision at high values, brightness values are premultiplied by an exposure normalization value. In support of Physical Light Units this PR also renames CameraEffects to CameraAttributes.
2022-08-01 07:20:24 +08:00
set_param(PARAM_INTENSITY, 100000.0); // Specified in Lux, approximate mid-day sun.
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
set_shadow_mode(SHADOW_PARALLEL_4_SPLITS);
blend_splits = false;
Replace DirectionalLight3D's `use_in_sky_only` with `sky_mode` enum 3 options are available: - Light and Sky (default) - Light Only (new) - Sky Only (equivalent to `use_in_sky_only = true`) Co-authored by: clayjohn <claynjohn@gmail.com>
2021-10-20 06:40:46 +08:00
set_sky_mode(SKY_MODE_LIGHT_AND_SKY);
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
}
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void OmniLight3D::set_shadow_mode(ShadowMode p_mode) {
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
shadow_mode = p_mode;
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
RS::get_singleton()->light_omni_set_shadow_mode(light, RS::LightOmniShadowMode(p_mode));
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
OmniLight3D::ShadowMode OmniLight3D::get_shadow_mode() const {
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
return shadow_mode;
}
Revert "Update Node::get_configuration_warnings signature" This reverts commit d3852deaa450d77edb30df2bb1c77bd7bc45befc.
2024-02-18 02:03:21 +08:00
PackedStringArray OmniLight3D::get_configuration_warnings() const {
PackedStringArray warnings = Light3D::get_configuration_warnings();
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
if (!has_shadow() && get_projector().is_valid()) {
String: Remove TTR and DTR defines in non-tools build This ensures we don't use TTR in runtime code, as it's specifically meant to source translations for the editor.
2022-03-28 21:24:14 +08:00
warnings.push_back(RTR("Projector texture only works with shadows active."));
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
}
Add warnings for unsupported features in mobile and gl_compatibility backends
2023-02-26 08:24:41 +08:00
if (get_projector().is_valid() && OS::get_singleton()->get_current_rendering_method() == "gl_compatibility") {
warnings.push_back(RTR("Projector textures are not supported when using the GL Compatibility backend yet. Support will be added in a future release."));
}
Use Array for node configuration warnings Previously, the warnings were passed as a string and delimitation of which were hard coded at each implementation.
2020-10-29 18:01:28 +08:00
return warnings;
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void OmniLight3D::_bind_methods() {
ClassDB::bind_method(D_METHOD("set_shadow_mode", "mode"), &OmniLight3D::set_shadow_mode);
ClassDB::bind_method(D_METHOD("get_shadow_mode"), &OmniLight3D::get_shadow_mode);
all light types and shadows are working, pending a lot of clean-up
2016-11-10 10:55:06 +08:00
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("Omni", "omni_");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "omni_range", PROPERTY_HINT_RANGE, "0,4096,0.001,or_greater,exp"), "set_param", "get_param", PARAM_RANGE);
Modify display and documentation of attenuation for Light3D
2024-01-25 21:27:09 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "omni_attenuation", PROPERTY_HINT_RANGE, "-10,10,0.001,or_greater,or_less"), "set_param", "get_param", PARAM_ATTENUATION);
Remove use of _SCS from ADD_METHOD This saves typing and is a step towards fixing #56
2017-02-12 08:11:37 +08:00
ADD_PROPERTY(PropertyInfo(Variant::INT, "omni_shadow_mode", PROPERTY_HINT_ENUM, "Dual Paraboloid,Cube"), "set_shadow_mode", "get_shadow_mode");
Fix enums bindings Add missed bindings for enums Move some enums to class to have correct output of api.json
2017-09-13 03:09:06 +08:00
BIND_ENUM_CONSTANT(SHADOW_DUAL_PARABOLOID);
BIND_ENUM_CONSTANT(SHADOW_CUBE);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
OmniLight3D::OmniLight3D() :
Renaming of servers for coherency. VisualServer -> RenderingServer PhysicsServer -> PhysicsServer3D Physics2DServer -> PhysicsServer2D NavigationServer -> NavigationServer3D Navigation2DServer -> NavigationServer2D Also renamed corresponding files.
2020-03-28 02:21:27 +08:00
Light3D(RenderingServer::LIGHT_OMNI) {
Change Omni light default mode to Cube, avoids users confusing it as a bug, closes #8813
2017-06-13 10:36:33 +08:00
set_shadow_mode(SHADOW_CUBE);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Revert "Update Node::get_configuration_warnings signature" This reverts commit d3852deaa450d77edb30df2bb1c77bd7bc45befc.
2024-02-18 02:03:21 +08:00
PackedStringArray SpotLight3D::get_configuration_warnings() const {
PackedStringArray warnings = Light3D::get_configuration_warnings();
Add a configuration warning when using ultrawide SpotLight with shadows This partially addresses #12028.
2019-07-07 22:22:09 +08:00
if (has_shadow() && get_param(PARAM_SPOT_ANGLE) >= 90.0) {
String: Remove TTR and DTR defines in non-tools build This ensures we don't use TTR in runtime code, as it's specifically meant to source translations for the editor.
2022-03-28 21:24:14 +08:00
warnings.push_back(RTR("A SpotLight3D with an angle wider than 90 degrees cannot cast shadows."));
Add a configuration warning when using ultrawide SpotLight with shadows This partially addresses #12028.
2019-07-07 22:22:09 +08:00
}
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
if (!has_shadow() && get_projector().is_valid()) {
String: Remove TTR and DTR defines in non-tools build This ensures we don't use TTR in runtime code, as it's specifically meant to source translations for the editor.
2022-03-28 21:24:14 +08:00
warnings.push_back(RTR("Projector texture only works with shadows active."));
Add support for projectors in spot and omni lights.
2020-04-15 04:05:45 +08:00
}
Add warnings for unsupported features in mobile and gl_compatibility backends
2023-02-26 08:24:41 +08:00
if (get_projector().is_valid() && OS::get_singleton()->get_current_rendering_method() == "gl_compatibility") {
warnings.push_back(RTR("Projector textures are not supported when using the GL Compatibility backend yet. Support will be added in a future release."));
}
Use Array for node configuration warnings Previously, the warnings were passed as a string and delimitation of which were hard coded at each implementation.
2020-10-29 18:01:28 +08:00
return warnings;
Add a configuration warning when using ultrawide SpotLight with shadows This partially addresses #12028.
2019-07-07 22:22:09 +08:00
}
Renamed 2D and 3D nodes to make their types explicit Fixes #30736.
2020-03-27 05:49:16 +08:00
void SpotLight3D::_bind_methods() {
-Conversion of most properties to a simpler syntax, easier to use by script -Modified help to display properties GDScript can still not make use of them, though.
2017-01-04 12:16:14 +08:00
ADD_GROUP("Spot", "spot_");
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "spot_range", PROPERTY_HINT_RANGE, "0,4096,0.001,or_greater,exp,suffix:m"), "set_param", "get_param", PARAM_RANGE);
Modify display and documentation of attenuation for Light3D
2024-01-25 21:27:09 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "spot_attenuation", PROPERTY_HINT_RANGE, "-10,10,0.01,or_greater,or_less"), "set_param", "get_param", PARAM_ATTENUATION);
Tweak Light3D property hints for greater flexibility - Specular can now be set above 1.0. - Blur can be set to 0 to disable shadow blurring entirely, which is useful on lights that have a non-zero size. - When shadow blurring is disabled, lights that have a non-zero size will not use PCSS-like soft shadows, speeding up shadow rendering considerably. - Some property hints now allow more precise values.
2021-07-16 09:33:10 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "spot_angle", PROPERTY_HINT_RANGE, "0,180,0.01,degrees"), "set_param", "get_param", PARAM_SPOT_ANGLE);
Variant: Added 64-bit packed arrays, renamed Variant::REAL to FLOAT. - Renames PackedIntArray to PackedInt32Array. - Renames PackedFloatArray to PackedFloat32Array. - Adds PackedInt64Array and PackedFloat64Array. - Renames Variant::REAL to Variant::FLOAT for consistency. Packed arrays are for storing large amount of data and creating stuff like meshes, buffers. textures, etc. Forcing them to be 64 is a huge waste of memory. That said, many users requested the ability to have 64 bits packed arrays for their games, so this is just an optional added type. For Variant, the float datatype is always 64 bits, and exposed as `float`. We still have `real_t` which is the datatype that can change from 32 to 64 bits depending on a compile flag (not entirely working right now, but that's the idea). It affects math related datatypes and code only. Neither Variant nor PackedArray make use of real_t, which is only intended for math precision, so the term is removed from there to keep only float.
2020-02-25 02:20:53 +08:00
ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "spot_angle_attenuation", PROPERTY_HINT_EXP_EASING, "attenuation"), "set_param", "get_param", PARAM_SPOT_ATTENUATION);
GODOT IS OPEN SOURCE
2014-02-10 09:10:30 +08:00
}
Tweak shadow bias defaults for DirectionalLight3D and OmniLight3D - Increase DirectionalLight3D normal bias to 2.0 to reduce shadow acne at grazing angles. - Decrease OmniLight3D bias to 0.1 to reduce shadow peter-panning.
2022-12-06 04:44:23 +08:00
SpotLight3D::SpotLight3D() :
Light3D(RenderingServer::LIGHT_SPOT) {
// Decrease the default shadow bias to better suit most scenes.
set_param(PARAM_SHADOW_BIAS, 0.03);
}
Reference in New Issue Copy Permalink