Sur cette page

Qt3DExtras::QPhongMaterial Class

class Qt3DExtras::QPhongMaterial

La classe QPhongMaterial fournit une implémentation par défaut de l'effet d'éclairage phong. Plus d'informations...

En-tête : #include <QPhongMaterial>
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

QPhongMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QPhongMaterial()
QColor ambient() const
QColor diffuse() const
float shininess() const
QColor specular() const

Emplacements publics

void setAmbient(const QColor &ambient)
void setDiffuse(const QColor &diffuse)
void setShininess(float shininess)
void setSpecular(const QColor &specular)

Signaux

void ambientChanged(const QColor &ambient)
void diffuseChanged(const QColor &diffuse)
void shininessChanged(float shininess)
void specularChanged(const QColor &specular)

Description détaillée

Cette classe est obsolète ; utilisez plutôt QDiffuseSpecularMaterial.

L'effet d'éclairage phong est basé sur la combinaison de 3 composantes d'éclairage : ambiant, diffus 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.

Fonctions d'accès :

QColor ambient() const
void setAmbient(const QColor &ambient)

Signal de notification :

void ambientChanged(const QColor &ambient)

diffuse : QColor

Détient la couleur diffuse.

Fonctions d'accès :

QColor diffuse() const
void setDiffuse(const QColor &diffuse)

Signal de notification :

void diffuseChanged(const QColor &diffuse)

shininess : float

Contient l'exposant de l'éclat.

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.

Fonctions d'accès :

QColor specular() const
void setSpecular(const QColor &specular)

Signal du notificateur :

void specularChanged(const QColor &specular)

Fonction membre Documentation

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

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

[virtual noexcept] QPhongMaterial::~QPhongMaterial()

Détruit le site QPhongMaterial.

© 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.