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
    Setterset_param(value)
    Getterget_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.


    Setterset_blend_splits(value)
    Getteris_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
    Setterset_param(value)
    Getterget_param()

    The maximum distance for shadow splits.


    Setterset_shadow_mode(value)
    Getterget_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
    Setterset_param(value)
    Getterget_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
    Setterset_param(value)
    Getterget_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.