DirectionalLight QML Type

定义场景中的定向光。更多

• 所有成员（包括继承成员）的列表

属性

• csmBlendRatio : real (since 6.8)
• csmNumSplits : int (since 6.8)
• csmSplit1 : real (since 6.8)
• csmSplit2 : real (since 6.8)
• csmSplit3 : real (since 6.8)
• lockShadowmapTexels : bool (since 6.9)

详细说明

定向光从无限远处的一个无法识别的光源向一个方向发射光线。这与现实生活中阳光的作用方式类似。定向光的范围是无限的，并且不会减弱。

如果启用castsShadow ，阴影将与光线方向平行。

定向光实际上没有位置，因此移动它不会产生任何影响。光线将始终沿着光线的 Z 轴方向发射。

沿 X 轴或 Y 轴旋转光线会改变光线的发射方向。

只有在以下情况下才会对定向光进行缩放：

• 如果 Z 轴的刻度设置为负数，则光线将朝相反方向发射。
• 如果任意轴的缩放比例设置为 0，则光线将沿着世界的 Z 轴发射。

  注： 旋转光线不会产生任何效果。

我们来看一个简单的例子：

import QtQuick
import QtQuick3D
View3D {
    anchors.fill: parent

    PerspectiveCamera { z: 600 }

    DirectionalLight {
    }

    Model {
        source: "#Sphere"
        scale: Qt.vector3d(4, 4, 4)
        materials: PrincipledMaterial {
            baseColor: "#40c060"
            roughness: 0.1 // make specular highlight visible
        }
    }
}

在这里，DirectionalLight 使用默认的white 颜色，沿着 DirectionalLight 节点的 Z 轴方向发光。

绕 X 轴旋转 60 度会产生以下结果。灯光不再沿 Z 轴方向直射，而是 "向下 "60 度：

DirectionalLight {
    eulerRotation.x: 60
}

更多使用示例，请参见Qt Quick 3D - 灯光示例。

另请参阅 PointLight,SpotLight, 和阴影贴图。

属性文档