Sur cette page

Qt3DExtras::QMetalRoughMaterial Class

class Qt3DExtras::QMetalRoughMaterial

Le QMetalRoughMaterial fournit une implémentation par défaut de l'éclairage PBR. En savoir plus...

En-tête : #include <qmetalroughmaterial.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake : QT += 3dextras
En QML : MetalRoughMaterial
Hérite de : Qt3DRender::QMaterial
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

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 à passe de rendu unique et effectue un éclairage par fragment. Des techniques sont fournies pour OpenGL 3 et OpenGL ES 3.

Documentation des propriétés

ambientOcclusion : QVariant

Contient la texture actuelle de la carte d'occlusion ambiante du matériau. Il doit s'agir exclusivement 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

Contient la couleur de base actuelle du matériau. Il peut s'agir soit d'une valeur de couleur unie, soit d'une texture. Par défaut, la valeur de cette propriété est « gris ».

Fonctions d'accès :

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

Signal de notification :

void baseColorChanged(const QVariant &baseColor)

metalness : QVariant

Stocke le niveau actuel de métallicité du matériau, sous la forme d'une valeur comprise entre 0 (purement diélectrique, valeur par défaut) et 1 (purement métallique). Il peut s'agir soit d'une valeur uniforme simple, soit 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 carte normale actuelle du matériau. Il doit s'agir exclusivement 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

Stocke le niveau de rugosité actuel du matériau. Il peut s'agir soit d'une simple valeur uniforme, soit 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

Stocke l'échelle actuelle de la texture. Elle est appliquée sous forme de multiplicateur aux coordonnées de texture au moment du rendu. La valeur par défaut est 1,0.

Utilisé conjointement avec QTextureWrapMode::Repeat, textureScale offre un moyen simple de répéter une texture sur une surface. Par exemple, une échelle de texture de 4.0 donnerait lieu à 16 tuiles (4x4).

Fonctions d'accès :

float textureScale() const
void setTextureScale(float textureScale)

Signal de notification :

void textureScaleChanged(float textureScale)

Documentation des fonctions membres

[explicit] QMetalRoughMaterial::QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)

Crée une nouvelle instance de `QMetalRoughMaterial` dont l'objet parent est ` parent`.

[virtual noexcept] QMetalRoughMaterial::~QMetalRoughMaterial()

Supprime l'instance de l'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.