Qt3DExtras::QMetalRoughMaterial Class
class Qt3DExtras::QMetalRoughMaterialDas QMetalRoughMaterial bietet eine Standardimplementierung der PBR-Beleuchtung. Mehr...
| Überschrift: | #include <qmetalroughmaterial.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| In QML: | MetalRoughMaterial |
| Erbt von: | Qt3DRender::QMaterial |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
|
|
Öffentliche Funktionen
| QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr) | |
| virtual | ~QMetalRoughMaterial() |
| QVariant | ambientOcclusion() const |
| QVariant | baseColor() const |
| QVariant | metalness() const |
| QVariant | normal() const |
| QVariant | roughness() const |
| float | textureScale() const |
Öffentliche Slots
| void | setAmbientOcclusion(const QVariant &ambientOcclusion) |
| void | setBaseColor(const QVariant &baseColor) |
| void | setMetalness(const QVariant &metalness) |
| void | setNormal(const QVariant &normal) |
| void | setRoughness(const QVariant &roughness) |
| void | setTextureScale(float textureScale) |
Signale
| void | ambientOcclusionChanged(const QVariant &ambientOcclusion) |
| void | baseColorChanged(const QVariant &baseColor) |
| void | metalnessChanged(const QVariant &metalness) |
| void | normalChanged(const QVariant &normal) |
| void | roughnessChanged(const QVariant &roughness) |
| void | textureScaleChanged(float textureScale) |
Ausführliche Beschreibung
Dieses Material verwendet einen Effekt mit einem einzigen Render-Durchgang und führt eine fragmentweise Beleuchtung durch. Es werden Techniken für OpenGL 3 und OpenGL ES 3 bereitgestellt.
Dokumentation der Eigenschaften
ambientOcclusion : QVariant
Enthält die aktuelle Textur der Ambient-Occlusion-Map des Materials. Hier darf nur eine Textur angegeben werden, andernfalls wird der Eintrag ignoriert. Standardmäßig ist diese Map nicht festgelegt.
Zugriffsfunktionen:
| QVariant | ambientOcclusion() const |
| void | setAmbientOcclusion(const QVariant &ambientOcclusion) |
Notifier-Signal:
| void | ambientOcclusionChanged(const QVariant &ambientOcclusion) |
baseColor : QVariant
Enthält die aktuelle Grundfarbe des Materials. Dabei kann es sich entweder um einen einfachen Farbwert oder um eine Textur handeln. Standardmäßig lautet der Wert dieser Eigenschaft „grau“.
Zugriffsfunktionen:
| QVariant | baseColor() const |
| void | setBaseColor(const QVariant &baseColor) |
Benachrichtigungssignal:
| void | baseColorChanged(const QVariant &baseColor) |
metalness : QVariant
Enthält den aktuellen Metallizitätsgrad des Materials als Wert zwischen 0 (rein dielektrisch, Standardeinstellung) und 1 (rein metallisch). Dabei kann es sich entweder um einen einfachen, einheitlichen Wert oder um eine Textur handeln. Standardmäßig beträgt der Wert dieser Eigenschaft 0.
Zugriffsfunktionen:
| QVariant | metalness() const |
| void | setMetalness(const QVariant &metalness) |
Benachrichtigungssignal:
| void | metalnessChanged(const QVariant &metalness) |
normal : QVariant
Enthält die aktuelle Normal-Map-Textur des Materials. Es darf sich dabei ausschließlich um eine Textur handeln, andernfalls wird sie ignoriert. Standardmäßig ist diese Map nicht festgelegt.
Zugriffsfunktionen:
| QVariant | normal() const |
| void | setNormal(const QVariant &normal) |
Notifier-Signal:
| void | normalChanged(const QVariant &normal) |
roughness : QVariant
Enthält den aktuellen Rauheitsgrad des Materials. Dabei kann es sich entweder um einen einfachen, einheitlichen Wert oder um eine Textur handeln. Standardmäßig ist der Wert dieser Eigenschaft 0.
Zugriffsfunktionen:
| QVariant | roughness() const |
| void | setRoughness(const QVariant &roughness) |
Benachrichtigungssignal:
| void | roughnessChanged(const QVariant &roughness) |
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 Texturskalierungswert 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 Member-Funktionen
[explicit] QMetalRoughMaterial::QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)
Erstellt eine neue Instanz von `QMetalRoughMaterial` mit dem übergeordneten Objekt ` parent`.
[virtual noexcept] QMetalRoughMaterial::~QMetalRoughMaterial()
Löscht die Instanz „ QMetalRoughMaterial “.
© 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.
