Qt3DRender::QPointLight Class
class Qt3DRender::QPointLightEncapsule un objet de lumière ponctuelle dans une scène Qt 3D. Plus...
| En-tête : | #include <QPointLight> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | PointLight |
| Hérite : | Qt3DRender::QAbstractLight |
| Statut : | Déclassé |
Propriétés
- constantAttenuation : float
- linearAttenuation : float
- quadraticAttenuation : float
Fonctions publiques
| QPointLight(Qt3DCore::QNode *parent = nullptr) | |
| float | constantAttenuation() const |
| float | linearAttenuation() const |
| float | quadraticAttenuation() const |
Emplacements publics
| void | setConstantAttenuation(float value) |
| void | setLinearAttenuation(float value) |
| void | setQuadraticAttenuation(float value) |
Signaux
| void | constantAttenuationChanged(float constantAttenuation) |
| void | linearAttenuationChanged(float linearAttenuation) |
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Description détaillée
Une lumière ponctuelle est une source lumineuse qui émet de la lumière dans toutes les directions, à partir d'un seul point. D'un point de vue conceptuel, cette source est similaire à la lumière émise par une ampoule électrique standard.
Une lumière ponctuelle utilise trois facteurs d'atténuation pour décrire comment l'intensité de la lumière diminue en fonction de la distance. Ces facteurs sont conçus pour être utilisés ensemble dans le calcul de l'atténuation totale. Pour les matériaux de Qt3D Extras, la formule suivante est utilisée, où la distance est la distance entre la lumière et la surface rendue :
totalAttenuation = 1.0 / (constantAttenuation + (linearAttenuation * distance) + (quadraticAttenuation * distance * distance));
Les matériaux personnalisés peuvent choisir d'interpréter ces facteurs différemment.
Documentation sur les propriétés
constantAttenuation : float
Spécifie l'atténuation constante de la lumière ponctuelle.
Remarque : la signification et l'utilisation exactes de cette propriété dépendent de la mise en œuvre du matériau.
Fonctions d'accès :
| float | constantAttenuation() const |
| void | setConstantAttenuation(float value) |
Signal du notificateur :
| void | constantAttenuationChanged(float constantAttenuation) |
linearAttenuation : float
Spécifie l'atténuation linéaire de la lumière ponctuelle.
Remarque : la signification et l'utilisation exactes de cette propriété dépendent de la mise en œuvre du matériau.
Fonctions d'accès :
| float | linearAttenuation() const |
| void | setLinearAttenuation(float value) |
Signal du notificateur :
| void | linearAttenuationChanged(float linearAttenuation) |
quadraticAttenuation : float
Spécifie l'atténuation quadratique de la lumière ponctuelle.
Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation matérielle.
Fonctions d'accès :
| float | quadraticAttenuation() const |
| void | setQuadraticAttenuation(float value) |
Notifier signal :
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Member Function Documentation
[explicit] QPointLight::QPointLight(Qt3DCore::QNode *parent = nullptr)
Construit un nouveau QPointLight avec la valeur spécifiée parent.
© 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.
