Sur cette page

SpotLight QML Type

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

Import Statement: import Qt3D.Render 2.12
In C++: QSpotLight
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

Un projecteur est une source lumineuse qui émet un cône de lumière dans une direction particulière.

Un projecteur 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 source lumineuse et la surface à rendre :

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

Les matériaux personnalisés peuvent choisir d’interpréter ces facteurs différemment.

Documentation des propriétés

constantAttenuation : real

Spécifie l'atténuation constante du faisceau lumineux.

Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation du matériau.

cutOffAngle : real

Définit l'angle de coupure du faisceau lumineux.

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 du faisceau lumineux.

Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation du matériau.

localDirection : vector3d

Spécifie la direction locale du projecteur.

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 du faisceau lumineux.

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.