En esta página

Qt3DExtras::QPhongMaterial Class

class Qt3DExtras::QPhongMaterial

La clase QPhongMaterial ofrece una implementación predeterminada del efecto de iluminación Phong. Más información...

Encabezado: #include <qphongmaterial.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Heredado de: Qt3DRender::QMaterial
Estado: Obsoleta

Esta clase está en desuso. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

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

Ranuras públicas

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

Señales

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

Descripción detallada

Esta clase está obsoleta; utilice en su lugar QDiffuseSpecularMaterial.

El efecto de iluminación Phong se basa en la combinación de tres componentes de iluminación: ambiental, difuso y especular. La intensidad relativa de estos componentes se controla mediante sus coeficientes de reflectividad, que se modelan como tríos RGB:

  • El color ambiental es el que emite un objeto sin ninguna otra fuente de luz.
  • El color difuso es el que se emite en los reflejos de superficies rugosas con la luz.
  • El color especular es el que se emite en los reflejos de superficies brillantes con la luz.
  • El brillo de una superficie se controla mediante una propiedad de tipo float.

Este material utiliza un efecto con un enfoque de una sola pasada de renderizado y realiza la iluminación por fragmento. Se proporcionan técnicas para OpenGL 2, OpenGL 3 o superior, así como para OpenGL ES 2.

Documentación de propiedades

ambient : QColor

Almacena el color ambiental.

Funciones de acceso:

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

Señal de notificador:

void ambientChanged(const QColor &ambient)

diffuse : QColor

Contiene el color difuso.

Funciones de acceso:

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

Señal de notificación:

void diffuseChanged(const QColor &diffuse)

shininess : float

Almacena el exponente de brillo.

Funciones de acceso:

float shininess() const
void setShininess(float shininess)

Señal de notificación:

void shininessChanged(float shininess)

specular : QColor

Contiene el color especular.

Funciones de acceso:

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

Señal de notificación:

void specularChanged(const QColor &specular)

Documentación de las funciones de miembro

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

Crea una nueva instancia de QPhongMaterial con el objeto padre parent.

[virtual noexcept] QPhongMaterial::~QPhongMaterial()

Destruye el « 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.