DirectionalLight QML Type

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

Import Statement: import QtQuick3D 1.15
Inherits:

Light

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.

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.