DirectionalLight QML Type | Qt Quick 3D 5.14.1

Qt 5.14 | Qt Quick 3D | QML Types | DirectionalLight QML Type

Qt 5.14.1 Reference Documentation

# DirectionalLight QML Type

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

Import Statement: | import QtQuick3D 1.0
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 and PointLight.