godot-docs/classes/class_directionallight.rst

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the DirectionalLight.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_DirectionalLight:

DirectionalLight
================

**Inherits:** :ref:`Light<class_light>` **<** :ref:`VisualInstance<class_visualinstance>` **<** :ref:`Spatial<class_spatial>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`

**Category:** Core

Brief Description
-----------------

Directional Light, such as the Sun or the Moon.

Member Variables
----------------

  .. _class_DirectionalLight_directional_shadow_bias_split_scale:

- :ref:`float<class_float>` **directional_shadow_bias_split_scale**

  .. _class_DirectionalLight_directional_shadow_blend_splits:

- :ref:`bool<class_bool>` **directional_shadow_blend_splits**

  .. _class_DirectionalLight_directional_shadow_depth_range:

- :ref:`ShadowDepthRange<enum_directionallight_shadowdepthrange>` **directional_shadow_depth_range**

  .. _class_DirectionalLight_directional_shadow_max_distance:

- :ref:`float<class_float>` **directional_shadow_max_distance**

  .. _class_DirectionalLight_directional_shadow_mode:

- :ref:`ShadowMode<enum_directionallight_shadowmode>` **directional_shadow_mode**

  .. _class_DirectionalLight_directional_shadow_normal_bias:

- :ref:`float<class_float>` **directional_shadow_normal_bias**

  .. _class_DirectionalLight_directional_shadow_split_1:

- :ref:`float<class_float>` **directional_shadow_split_1**

  .. _class_DirectionalLight_directional_shadow_split_2:

- :ref:`float<class_float>` **directional_shadow_split_2**

  .. _class_DirectionalLight_directional_shadow_split_3:

- :ref:`float<class_float>` **directional_shadow_split_3**


Enums
-----

  .. _enum_DirectionalLight_ShadowDepthRange:

enum **ShadowDepthRange**

- **SHADOW_DEPTH_RANGE_STABLE** = **0**
- **SHADOW_DEPTH_RANGE_OPTIMIZED** = **1**

  .. _enum_DirectionalLight_ShadowMode:

enum **ShadowMode**

- **SHADOW_ORTHOGONAL** = **0**
- **SHADOW_PARALLEL_2_SPLITS** = **1**
- **SHADOW_PARALLEL_4_SPLITS** = **2**


Description
-----------

A DirectionalLight is a type of :ref:`Light<class_light>` node that emits light constantly in one direction (the negative z axis of the node). It is used lights with strong intensity that are located far away from the scene to model sunlight or moonlight. The worldspace location of the DirectionalLight transform (origin) is ignored, only the basis is used do determine light direction.