Sur cette page

PointLight QML Type

Intégrer un objet « Point Light » dans une scène « Qt 3D ». En savoir plus…

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

Light

Status: Deprecated

Ce type est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

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é lumineuse 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 source lumineuse 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 : real

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.

linearAttenuation : real

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.

quadraticAttenuation : real

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.

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