mirror of
https://github.com/godotengine/godot
synced 2024-10-01 02:19:07 +00:00
eb52b95997
This is required in rendering methods that don't use clustering to check which meshes should be affected by decals, reflection probes and lights.
35 lines
2.4 KiB
XML
35 lines
2.4 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="OmniLight3D" inherits="Light3D" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Omnidirectional light, such as a light bulb or a candle.
|
|
</brief_description>
|
|
<description>
|
|
An Omnidirectional light is a type of [Light3D] that emits light in all directions. The light is attenuated by distance and this attenuation can be configured by changing its energy, radius, and attenuation parameters.
|
|
[b]Note:[/b] When using the Mobile or Compatibility rendering methods, omni lights will only correctly affect meshes whose visibility AABB intersects with the light's AABB. If using a shader to deform the mesh in a way that makes it go outside its AABB, [member GeometryInstance3D.extra_cull_margin] must be increased on the mesh. Otherwise, the light may not be visible on the mesh.
|
|
</description>
|
|
<tutorials>
|
|
<link title="3D lights and shadows">$DOCS_URL/tutorials/3d/lights_and_shadows.html</link>
|
|
</tutorials>
|
|
<members>
|
|
<member name="omni_attenuation" type="float" setter="set_param" getter="get_param" default="1.0">
|
|
The light's attenuation (drop-off) curve. A number of presets are available in the [b]Inspector[/b] by right-clicking the curve.
|
|
</member>
|
|
<member name="omni_range" type="float" setter="set_param" getter="get_param" default="5.0">
|
|
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.
|
|
[b]Note:[/b] [member omni_range] is not affected by [member Node3D.scale] (the light's scale or its parent's scale).
|
|
</member>
|
|
<member name="omni_shadow_mode" type="int" setter="set_shadow_mode" getter="get_shadow_mode" enum="OmniLight3D.ShadowMode" default="1">
|
|
See [enum ShadowMode].
|
|
</member>
|
|
<member name="shadow_normal_bias" type="float" setter="set_param" getter="get_param" overrides="Light3D" default="1.0" />
|
|
</members>
|
|
<constants>
|
|
<constant name="SHADOW_DUAL_PARABOLOID" value="0" enum="ShadowMode">
|
|
Shadows are rendered to a dual-paraboloid texture. Faster than [constant SHADOW_CUBE], but lower-quality.
|
|
</constant>
|
|
<constant name="SHADOW_CUBE" value="1" enum="ShadowMode">
|
|
Shadows are rendered to a cubemap. Slower than [constant SHADOW_DUAL_PARABOLOID], but higher-quality.
|
|
</constant>
|
|
</constants>
|
|
</class>
|