Sur cette page

Qt3DExtras::QMetalRoughMaterial Class

class Qt3DExtras::QMetalRoughMaterial

Le matériau QMetalRoughMaterial fournit une implémentation par défaut de l'éclairage PBR. Plus d'informations...

En-tête : #include <QMetalRoughMaterial>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake : QT += 3dextras
En QML : MetalRoughMaterial
Hérite : Qt3DRender::QMaterial
Statut : Déclassé

Propriétés

Fonctions publiques

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

Emplacements publics

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)

Signaux

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)

Description détaillée

Ce matériau utilise un effet avec une approche de rendu unique et effectue un éclairage par fragment. Les techniques sont fournies pour OpenGL 3 et OpenGL ES 3.

Documentation sur les propriétés

ambientOcclusion : QVariant

Détient la texture actuelle de la carte d'occlusion ambiante du matériau. Il ne peut s'agir que d'une texture, sinon elle est ignorée. Par défaut, cette carte n'est pas définie.

Fonctions d'accès :

QVariant ambientOcclusion() const
void setAmbientOcclusion(const QVariant &ambientOcclusion)

Signal de notification :

void ambientOcclusionChanged(const QVariant &ambientOcclusion)

baseColor : QVariant

Indique la couleur de base actuelle du matériau. Il peut s'agir d'une couleur simple ou d'une texture. Par défaut, la valeur de cette propriété est "grey".

Fonctions d'accès :

QVariant baseColor() const
void setBaseColor(const QVariant &baseColor)

Signal de notification :

void baseColorChanged(const QVariant &baseColor)

metalness : QVariant

Indique le niveau de métallisation actuel du matériau, sous la forme d'une valeur comprise entre 0 (purement diélectrique, par défaut) et 1 (purement métallique). Il peut s'agir d'une valeur uniforme ou d'une texture. Par défaut, la valeur de cette propriété est 0.

Fonctions d'accès :

QVariant metalness() const
void setMetalness(const QVariant &metalness)

Signal de notification :

void metalnessChanged(const QVariant &metalness)

normal : QVariant

Contient la texture de la carte de normalité actuelle du matériau. Il ne peut s'agir que d'une texture, sinon elle est ignorée. Par défaut, cette carte n'est pas définie.

Fonctions d'accès :

QVariant normal() const
void setNormal(const QVariant &normal)

Signal de notification :

void normalChanged(const QVariant &normal)

roughness : QVariant

Indique le niveau de rugosité actuel du matériau. Il peut s'agir d'une valeur uniforme ou d'une texture. Par défaut, la valeur de cette propriété est 0.

Fonctions d'accès :

QVariant roughness() const
void setRoughness(const QVariant &roughness)

Signal de notification :

void roughnessChanged(const QVariant &roughness)

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] QMetalRoughMaterial::QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)

Construit une nouvelle instance de QMetalRoughMaterial avec l'objet parent parent.

[virtual noexcept] QMetalRoughMaterial::~QMetalRoughMaterial()

Détruit l'instance 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.