本页内容

SpotLight QML Type

在Qt 3D 场景中封装一个Spot Light对象。更多内容...

Import Statement: import Qt3D.Render 2.12
In C++: QSpotLight
Inherits:

Light

Status: Deprecated

此类型已弃用。我们强烈建议不要在新代码中使用它。

属性

详细说明

聚光灯是一种向特定方向发射锥形光束的光源。

聚光灯使用三个衰减因子来描述光强随距离的衰减情况。这些因子旨在共同用于计算总衰减。对于 Qt3D Extras 中的材质,使用以下公式,其中距离是指从光源到被渲染表面的距离:

totalAttenuation = 1.0 / (constantAttenuation + (linearAttenuation * distance) + (quadraticAttenuation * distance * distance));

自定义材质可选择以不同的方式解释这些因子。

属性文档

constantAttenuation : real

指定聚光灯的恒定衰减。

注意: 该属性的确切含义和用法取决于具体实现。

cutOffAngle : real

指定聚光灯的截止角。

注意: 该属性的确切含义和用法取决于具体实现。

linearAttenuation : real

指定聚光灯的线性衰减。

注意: 该属性的确切含义 和用法取决于具体的材料实现。

localDirection : vector3d

指定聚光灯的本地方向。

注意: 该属性的确切含义和用法取决于具体实现。

quadraticAttenuation : real

指定聚光灯的二次衰减。

注意: 该属性的确切含义和用法取决于具体实现。

© 2026 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.