Qt3DRender::QPointLight Class
class Qt3DRender::QPointLightIntégrer un objet « Point Light » dans une scène « Qt 3D ». En savoir plus...
| En-tête : | #include <qpointlight.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | PointLight |
| Hérite de : | Qt3DRender::QAbstractLight |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
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 source lumineuse ponctuelle est une source qui émet de la lumière dans toutes les directions à partir d’un point unique. D’un point de vue conceptuel, cela s’apparente à la lumière émise par une ampoule classique.
Une lumière ponctuelle utilise trois facteurs d’atténuation pour décrire la façon dont l’intensité de la lumière diminue en fonction de la distance. Ces facteurs sont conçus pour être utilisés conjointement dans le calcul de l’atténuation totale. Pour les matériaux de Qt3D Extras, la formule suivante est utilisée, où « distance » correspond à la distance entre la lumière et la surface en cours de rendu :
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
Définit l'atténuation constante de la source lumineuse ponctuelle.
Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation du matériau.
Fonctions d'accès :
| float | constantAttenuation() const |
| void | setConstantAttenuation(float value) |
Signal de notification :
| void | constantAttenuationChanged(float constantAttenuation) |
linearAttenuation : float
Spécifie l'atténuation linéaire de la source lumineuse ponctuelle.
Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation du matériau.
Fonctions d'accès :
| float | linearAttenuation() const |
| void | setLinearAttenuation(float value) |
Signal de notification :
| void | linearAttenuationChanged(float linearAttenuation) |
quadraticAttenuation : float
Définit l'atténuation quadratique de la source lumineuse ponctuelle.
Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation du matériau.
Fonctions d'accès :
| float | quadraticAttenuation() const |
| void | setQuadraticAttenuation(float value) |
Signal de notification :
| void | quadraticAttenuationChanged(float quadraticAttenuation) |
Documentation des fonctions membres
[explicit] QPointLight::QPointLight(Qt3DCore::QNode *parent = nullptr)
Crée un nouvel objet `QPointLight` avec l'parent` spécifiée.
© 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.
