- Qt 5.15
- Qt Quick 3D
- QML Types
- DirectionalLight QML Type
- Qt Quick 3D | Commercial or GPLv3

# DirectionalLight QML Type

Defines a directional light in the scene. More...

Import Statement: | import QtQuick3D 1.15
Inherits: | Light

- List of all members, including inherited members

## Detailed Description

The directional light emits light in one direction from an unidentifiable source located infinitely far away. This is similar to the way sunlight works in real life. A directional light has infinite range and does not diminish.

If castsShadow is enabled, shadows will be parallel to the light direction.

Moving a directional light does not have any effect. The light will always be emitted in the direction of the light's Z axis.

Rotating the light along its X or Y axis will change the direction of the light emission.

Scaling a directional light will only have an effect in the following cases:

- If Z scale is set to a negative number, the light will be emitted in the opposite direction.
- If the scale of any axis is set to 0, the light will be emitted along the world's Z axis.

  Note: Rotating the light will then have no effect.

See also AreaLight, PointLight, and SpotLight.