Qt3DExtras::QDiffuseMapMaterial Class
class Qt3DExtras::QDiffuseMapMaterialLe matériau QDiffuseMapMaterial fournit une implémentation par défaut de l'effet d'éclairage phong où la composante de lumière diffuse est lue à partir d'une carte de texture. Plus d'informations...
| En-tête : | #include <QDiffuseMapMaterial> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3dextras)target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake : | QT += 3dextras |
| Hérite : | Qt3DRender::QMaterial |
| Statut : | Déclassé |
Cette classe est obsolète. Il est fortement déconseillé de l'utiliser dans un nouveau code.
Propriétés
|
Fonctions publiques
| QDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr) | |
| virtual | ~QDiffuseMapMaterial() |
| QColor | ambient() const |
| Qt3DRender::QAbstractTexture * | diffuse() const |
| float | shininess() const |
| QColor | specular() const |
| float | textureScale() const |
Emplacements publics
| void | setAmbient(const QColor &color) |
| void | setDiffuse(Qt3DRender::QAbstractTexture *diffuse) |
| void | setShininess(float shininess) |
| void | setSpecular(const QColor &specular) |
| void | setTextureScale(float textureScale) |
Signaux
| void | ambientChanged(const QColor &ambient) |
| void | diffuseChanged(Qt3DRender::QAbstractTexture *diffuse) |
| void | shininessChanged(float shininess) |
| void | specularChanged(const QColor &specular) |
| void | textureScaleChanged(float textureScale) |
Description détaillée
Cette classe est obsolète ; utilisez plutôt Qt3DExtras::QDiffuseSpecularMaterial.
L'effet d'éclairage spéculaire est basé sur la combinaison de 3 composantes d'éclairage : ambiante, diffuse et spéculaire. Les forces relatives de ces composantes sont contrôlées au moyen de leurs coefficients de réflectivité qui sont modélisés sous forme de triplets RVB :
- Ambiant est la couleur émise par un objet sans autre source de lumière.
- Diffuse est la couleur émise pour les réflexions de surface brutes avec les lumières.
- La couleur spéculaire est la couleur émise pour les reflets de surface brillants avec les lumières.
- La brillance d'une surface est contrôlée par une propriété flottante.
Ce matériau utilise un effet avec une approche de passage de rendu unique et effectue un éclairage par fragment. Les techniques sont fournies pour OpenGL 2, OpenGL 3 ou supérieur ainsi que pour OpenGL ES 2.
Documentation sur les propriétés
ambient : QColor
Maintient la couleur ambiante actuelle.
Fonctions d'accès :
| QColor | ambient() const |
| void | setAmbient(const QColor &color) |
Signal de notification :
| void | ambientChanged(const QColor &ambient) |
diffuse : Qt3DRender::QAbstractTexture*
Détient la texture courante utilisée comme carte de diffusion.
Par défaut, la texture diffuse a les propriétés suivantes :
- Filtres de minimisation et d'agrandissement linéaires
- Mipmap linéaire avec mipmapping activé
- Mode de répétition de l'enveloppement
- Anisotropie maximale de 16,0
Fonctions d'accès :
| Qt3DRender::QAbstractTexture * | diffuse() const |
| void | setDiffuse(Qt3DRender::QAbstractTexture *diffuse) |
Signal de notification :
| void | diffuseChanged(Qt3DRender::QAbstractTexture *diffuse) |
shininess : float
Détient la brillance actuelle sous la forme d'une valeur flottante.
Fonctions d'accès :
| float | shininess() const |
| void | setShininess(float shininess) |
Signal de notification :
| void | shininessChanged(float shininess) |
specular : QColor
Détient la couleur spéculaire actuelle.
Fonctions d'accès :
| QColor | specular() const |
| void | setSpecular(const QColor &specular) |
Signal de notification :
| void | specularChanged(const QColor &specular) |
textureScale : float
Indique l'échelle actuelle de la texture. Elle est appliquée comme un multiplicateur aux coordonnées de la texture au moment du rendu. La valeur par défaut est 1.0.
Utilisée conjointement avec QTextureWrapMode::Repeat, textureScale fournit un moyen simple de répartir une texture sur une surface. Par exemple, une échelle de texture de 4.0 permet d'obtenir 16 tuiles (4x4).
Fonctions d'accès :
| float | textureScale() const |
| void | setTextureScale(float textureScale) |
Signal Notifier :
| void | textureScaleChanged(float textureScale) |
Member Function Documentation
[explicit] QDiffuseMapMaterial::QDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr)
Construit une nouvelle instance de QDiffuseMapMaterial avec l'objet parent parent.
[virtual noexcept] QDiffuseMapMaterial::~QDiffuseMapMaterial()
Détruit l'instance QDiffuseMapMaterial.
© 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.
