Qt3DExtras::QNormalDiffuseMapMaterial Class
class Qt3DExtras::QNormalDiffuseMapMaterialDas `QNormalDiffuseMapMaterial` bietet eine Standardimplementierung der Phong-Beleuchtung und des Bump-Effekts, bei der die diffuse Lichtkomponente aus einer Texturkarte und die Normalen des gerenderten Meshes aus einer Normaltexturkarte ausgelesen werden. Mehr...
| Header: | #include <qnormaldiffusemapmaterial.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| Erbt von: | Qt3DRender::QMaterial |
| Vererbt an: | |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
|
Öffentliche Funktionen
| QNormalDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr) | |
| virtual | ~QNormalDiffuseMapMaterial() |
| QColor | ambient() const |
| Qt3DRender::QAbstractTexture * | diffuse() const |
| Qt3DRender::QAbstractTexture * | normal() const |
| float | shininess() const |
| QColor | specular() const |
| float | textureScale() const |
Öffentliche Slots
| void | setAmbient(const QColor &ambient) |
| void | setDiffuse(Qt3DRender::QAbstractTexture *diffuse) |
| void | setNormal(Qt3DRender::QAbstractTexture *normal) |
| void | setShininess(float shininess) |
| void | setSpecular(const QColor &specular) |
| void | setTextureScale(float textureScale) |
Signale
| void | ambientChanged(const QColor &ambient) |
| void | diffuseChanged(Qt3DRender::QAbstractTexture *diffuse) |
| void | normalChanged(Qt3DRender::QAbstractTexture *normal) |
| void | shininessChanged(float shininess) |
| void | specularChanged(const QColor &specular) |
| void | textureScaleChanged(float textureScale) |
Ausführliche Beschreibung
Diese Klasse ist veraltet; verwenden Sie stattdessen „ QDiffuseSpecularMaterial “.
Der Spiegelungseffekt basiert auf der Kombination von drei Beleuchtungskomponenten: Umgebungslicht, diffuses Licht und Spiegelung. Die relative Stärke dieser Komponenten wird über ihre Reflektivitätskoeffizienten gesteuert, die als RGB-Tripel modelliert sind:
- „Ambient“ ist die Farbe, die von einem Objekt ohne weitere Lichtquelle ausgestrahlt wird.
- „Diffuse“ ist die Farbe, die bei Reflexionen auf rauen Oberflächen durch die Lichter ausgestrahlt wird.
- „Specular“ ist die Farbe, die bei Reflexionen an glänzenden Oberflächen durch das Licht ausgestrahlt wird.
- Der Glanzgrad einer Oberfläche wird durch eine Float-Eigenschaft gesteuert.
Dieses Material verwendet einen Effekt mit einem Single-Render-Pass-Ansatz und führt eine fragmentweise Beleuchtung durch. Es werden Techniken für OpenGL 2, OpenGL 3 oder höher sowie für OpenGL ES 2 bereitgestellt.
Dokumentation der Eigenschaften
ambient : QColor
Enthält die aktuelle Umgebungsfarbe.
Zugriffsfunktionen:
| QColor | ambient() const |
| void | setAmbient(const QColor &ambient) |
Benachrichtigungssignal:
| void | ambientChanged(const QColor &ambient) |
diffuse : Qt3DRender::QAbstractTexture*
Enthält die aktuelle Diffus-Map-Textur.
Standardmäßig weist die Diffus-Textur folgende Eigenschaften auf:
- Lineare Verkleinerungs- und Vergrößerungsfilter
- Lineare Mipmap mit aktiviertem Mipmapping
- Wiederholungsmodus „Wrap“ M
- Maximale Anisotropie von 16,0
Zugriffsfunktionen:
| Qt3DRender::QAbstractTexture * | diffuse() const |
| void | setDiffuse(Qt3DRender::QAbstractTexture *diffuse) |
Benachrichtigungssignal:
| void | diffuseChanged(Qt3DRender::QAbstractTexture *diffuse) |
normal : Qt3DRender::QAbstractTexture*
Enthält die aktuelle Normal-Map-Textur.
Standardmäßig weist die Normaltextur die folgenden Eigenschaften auf:
- Lineare Verkleinerungs- und Vergrößerungsfilter
- Wiederholungs- und Umschlagmodus
- Maximale Anisotropie von 16,0
Zugriffsfunktionen:
| Qt3DRender::QAbstractTexture * | normal() const |
| void | setNormal(Qt3DRender::QAbstractTexture *normal) |
Benachrichtigungssignal:
| void | normalChanged(Qt3DRender::QAbstractTexture *normal) |
shininess : float
Speichert den aktuellen Glanzgrad als Float-Wert.
Zugriffsfunktionen:
| float | shininess() const |
| void | setShininess(float shininess) |
Notifier-Signal:
| void | shininessChanged(float shininess) |
specular : QColor
Enthält die aktuelle Spiegelungsfarbe.
Zugriffsfunktionen:
| QColor | specular() const |
| void | setSpecular(const QColor &specular) |
Benachrichtigungssignal:
| void | specularChanged(const QColor &specular) |
textureScale : float
Speichert den aktuellen Textur-Maßstab. Dieser wird beim Rendern als Multiplikator auf die Texturkoordinaten angewendet. Der Standardwert ist 1,0.
In Verbindung mit QTextureWrapMode::Repeat bietet textureScale eine einfache Möglichkeit, eine Textur über eine Oberfläche zu kacheln. Beispielsweise würde ein Texturskalierungsfaktor von 4.0 zu 16 (4×4) Kacheln führen.
Zugriffsfunktionen:
| float | textureScale() const |
| void | setTextureScale(float textureScale) |
Notifier-Signal:
| void | textureScaleChanged(float textureScale) |
Dokumentation der Mitgliedsfunktionen
[explicit] QNormalDiffuseMapMaterial::QNormalDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr)
Erstellt eine neue Instanz von „QNormalDiffuseMapMaterial“ mit dem übergeordneten Objekt „ parent “.
[virtual noexcept] QNormalDiffuseMapMaterial::~QNormalDiffuseMapMaterial()
Löscht die Instanz „ QNormalDiffuseMapMaterial “.
© 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.
