diff --git a/doc/classes/Light.xml b/doc/classes/Light.xml index 12fdde022c0..89d8da9cf02 100644 --- a/doc/classes/Light.xml +++ b/doc/classes/Light.xml @@ -4,7 +4,7 @@ Provides a base class for different kinds of light nodes. - Light is the abstract base class for light nodes, so it shouldn't be used directly (it can't be instanced). Other types of light nodes inherit from it. Light contains the common variables and parameters used for lighting. + Light is the [i]abstract[/i] base class for light nodes. As it can't be instanced, it shouldn't be used directly. Other types of light nodes inherit from it. Light contains the common variables and parameters used for lighting. https://docs.godotengine.org/en/latest/tutorials/3d/lights_and_shadows.html @@ -39,13 +39,13 @@ The light's bake mode. See [enum BakeMode]. - The light's color. + The light's color. An [i]overbright[/i] color can be used to achieve a result equivalent to increasing the light's [member light_energy]. The light will affect objects in the selected layers. - The light's strength multiplier. + The light's strength multiplier (this is not a physical unit). For [OmniLight] and [SpotLight], changing this value will only change the light color's intensity, not the light's radius. Secondary multiplier used with indirect light (light bounces). This works on both [BakedLightmap] and [GIProbe]. @@ -54,10 +54,10 @@ If [code]true[/code], the light's effect is reversed, darkening areas and casting bright shadows. - The intensity of the specular blob in objects affected by the light. At [code]0[/code] the light becomes a pure diffuse light. + The intensity of the specular blob in objects affected by the light. At [code]0[/code], the light becomes a pure diffuse light. When not baking emission, this can be used to avoid unrealistic reflections when placing lights above an emissive surface. - Used to adjust shadow appearance. Too small a value results in self-shadowing, while too large a value causes shadows to separate from casters. Adjust as needed. + Used to adjust shadow appearance. Too small a value results in self-shadowing ("shadow acne"), while too large a value causes shadows to separate from casters ("peter-panning"). Adjust as needed. The color of shadows cast by this light. diff --git a/doc/classes/OmniLight.xml b/doc/classes/OmniLight.xml index e3e0a8eb201..923cb45765d 100644 --- a/doc/classes/OmniLight.xml +++ b/doc/classes/OmniLight.xml @@ -16,7 +16,7 @@ The light's attenuation (drop-off) curve. A number of presets are available in the [b]Inspector[/b] by right-clicking the curve. - The light's radius. + The light's radius. Note that the effectively lit area may appear to be smaller depending on the [member omni_attenuation] in use. No matter the [member omni_attenuation] in use, the light will never reach anything outside this radius. See [enum ShadowDetail]. diff --git a/doc/classes/SpotLight.xml b/doc/classes/SpotLight.xml index 2e4fceb9700..032830671f0 100644 --- a/doc/classes/SpotLight.xml +++ b/doc/classes/SpotLight.xml @@ -22,7 +22,7 @@ The spotlight's light energy attenuation curve. - The maximal range that can be reached by the spotlight. + The maximal range that can be reached by the spotlight. Note that the effectively lit area may appear to be smaller depending on the [member spot_attenuation] in use. No matter the [member spot_attenuation] in use, the light will never reach anything outside this range.