En esta página

Qt3DExtras::QDiffuseSpecularMaterial Class

class Qt3DExtras::QDiffuseSpecularMaterial

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

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

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

Propiedades

Funciones públicas

QDiffuseSpecularMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QDiffuseSpecularMaterial()
QColor ambient() const
QVariant diffuse() const
bool isAlphaBlendingEnabled() const
QVariant normal() const
float shininess() const
QVariant specular() const
float textureScale() const

Ranuras públicas

void setAlphaBlendingEnabled(bool enabled)
void setAmbient(const QColor &ambient)
void setDiffuse(const QVariant &diffuse)
void setNormal(const QVariant &normal)
void setShininess(float shininess)
void setSpecular(const QVariant &specular)
void setTextureScale(float textureScale)

Señales

void alphaBlendingEnabledChanged(bool enabled)
void ambientChanged(const QColor &ambient)
void diffuseChanged(const QVariant &diffuse)
void normalChanged(const QVariant &normal)
void shininessChanged(float shininess)
void specularChanged(const QVariant &specular)
void textureScaleChanged(float textureScale)

Descripción detallada

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 «Ambient» es el color 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

alphaBlending : bool

Indica si se tendrá en cuenta la información alfa procedente de la propiedad «difusa» durante el renderizado. El valor predeterminado es «false».

Funciones de acceso:

bool isAlphaBlendingEnabled() const
void setAlphaBlendingEnabled(bool enabled)

Señal de notificación:

void alphaBlendingEnabledChanged(bool enabled)

ambient : QColor

Contiene el color ambiental que emite un objeto sin ninguna otra fuente de luz.

Funciones de acceso:

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

Señal de notificación:

void ambientChanged(const QColor &ambient)

diffuse : QVariant

Almacena el color difuso del material que se emite en los reflejos de superficies rugosas con las luces. Puede ser tanto un valor de color liso como una textura.

Funciones de acceso:

QVariant diffuse() const
void setDiffuse(const QVariant &diffuse)

Señal de notificación:

void diffuseChanged(const QVariant &diffuse)

normal : QVariant

Almacena la textura del mapa normal actual del material. Solo puede ser una textura; de lo contrario, se ignora. Por defecto, este mapa no está configurado.

Funciones de acceso:

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

Señal de notificación:

void normalChanged(const QVariant &normal)

shininess : float

Almacena el exponente de brillo. Cuanto mayor sea el valor de brillo, más pequeño y brillante será el punto de luz.

El valor por defecto es 150,0.

Funciones de acceso:

float shininess() const
void setShininess(float shininess)

Señal de notificación:

void shininessChanged(float shininess)

specular : QVariant

Almacena el color especular del material que se emite para los reflejos de las superficies brillantes con las luces. Puede tratarse tanto de un valor de color liso como de una textura.

Funciones de acceso:

QVariant specular() const
void setSpecular(const QVariant &specular)

Señal de notificación:

void specularChanged(const QVariant &specular)

textureScale : float

Almacena la escala de textura actual. Se aplica como multiplicador a las coordenadas de textura en el momento del renderizado. El valor por defecto es 1,0.

Cuando se utiliza junto con QTextureWrapMode::Repeat, textureScale ofrece una forma sencilla de repitir una textura en una superficie. Por ejemplo, una escala de textura de 4.0 daría como resultado 16 mosaicos (4x4).

Funciones de acceso:

float textureScale() const
void setTextureScale(float textureScale)

Señal de notificación:

void textureScaleChanged(float textureScale)

Documentación de las funciones miembro

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

Crea una nueva instancia de QDiffuseSpecularMaterial con el objeto padre « parent ».

[virtual noexcept] QDiffuseSpecularMaterial::~QDiffuseSpecularMaterial()

Destruye el « QDiffuseSpecularMaterial ».

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