DirectionalLight
Category: Core
Directional light from a distance, as from the Sun.
Properties
enum ShadowMode:
- SHADOW_PARALLEL_2_SPLITS = 1 — Splits the view frustum in 2 areas, each with its own shadow map.
- SHADOW_PARALLEL_4_SPLITS = 2 — Splits the view frustum in 4 areas, each with its own shadow map.
enum ShadowDepthRange:
- SHADOW_DEPTH_RANGE_STABLE = 0 — Keeps the shadow stable when the camera moves, at the cost of lower effective shadow resolution. Default value.
- SHADOW_DEPTH_RANGE_OPTIMIZED = 1 — Tries to achieve maximum shadow resolution. May result in saw effect on shadow edges.
Description
Property Descriptions
- float directional_shadow_bias_split_scale
Setter | set_param(value) |
Getter | get_param() |
Amount of extra bias for shadow splits that are far away. If self shadowing occurs only on the splits far away, this value can fix them.
Setter | set_blend_splits(value) |
Getter | is_blend_splits_enabled() |
If , shadow detail is sacrificed in exchange for smoother transitions between splits. Default value:false
.
- directional_shadow_depth_range
Optimizes shadow rendering for detail versus movement. See ShadowDepthRange.
- directional_shadow_max_distance
Setter | set_param(value) |
Getter | get_param() |
The maximum distance for shadow splits.
- ShadowMode directional_shadow_mode
Setter | set_shadow_mode(value) |
Getter | get_shadow_mode() |
- directional_shadow_normal_bias
Can be used to fix special cases of self shadowing when objects are perpendicular to the light.
- float directional_shadow_split_1
Setter | set_param(value) |
Getter | get_param() |
The distance from camera to shadow split 1. Relative to . Only used when directional_shadow_mode is one of the constants.
- directional_shadow_split_2
Setter | set_param(value) |
Getter | get_param() |
The distance from shadow split 1 to split 2. Relative to directional_shadow_max_distance. Only used when is SHADOW_PARALLEL_3_SPLITS
or .
The distance from shadow split 2 to split 3. Relative to directional_shadow_max_distance. Only used when is SHADOW_PARALLEL_4_SPLITS
.