En esta página

Qt3DExtras::QDiffuseSpecularMapMaterial Class

class Qt3DExtras::QDiffuseSpecularMapMaterial

El QDiffuseSpecularMapMaterial ofrece una implementación predeterminada del efecto de iluminación Phong, en la que los componentes de luz difusa y especular se obtienen a partir de mapas de textura. Más...

Encabezado: #include <qdiffusespecularmapmaterial.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á obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QDiffuseSpecularMapMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QDiffuseSpecularMapMaterial()
QColor ambient() const
Qt3DRender::QAbstractTexture *diffuse() const
float shininess() const
Qt3DRender::QAbstractTexture *specular() const
float textureScale() const

Ranuras públicas

void setAmbient(const QColor &ambient)
void setDiffuse(Qt3DRender::QAbstractTexture *diffuse)
void setShininess(float shininess)
void setSpecular(Qt3DRender::QAbstractTexture *specular)
void setTextureScale(float textureScale)

Señales

void ambientChanged(const QColor &ambient)
void diffuseChanged(Qt3DRender::QAbstractTexture *diffuse)
void shininessChanged(float shininess)
void specularChanged(Qt3DRender::QAbstractTexture *specular)
void textureScaleChanged(float textureScale)

Descripción detallada

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

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

  • La iluminación ambiental 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

ambient : QColor

Almacena el color ambiental actual 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 : Qt3DRender::QAbstractTexture*

Contiene la textura del mapa difuso actual.

Por defecto, la textura difusa tiene las siguientes propiedades:

  • Filtros lineales de reducción y ampliación
  • Mipmap lineal con mipmapping activado
  • Modo de repetición envolvente
  • Anisotropía máxima de 16,0

Funciones de acceso:

Qt3DRender::QAbstractTexture *diffuse() const
void setDiffuse(Qt3DRender::QAbstractTexture *diffuse)

Señal de notificación:

void diffuseChanged(Qt3DRender::QAbstractTexture *diffuse)

shininess : float

Almacena el brillo actual como un valor de tipo «float». Cuanto mayor sea el valor de brillo, más pequeño y brillante será el reflejo.

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 : Qt3DRender::QAbstractTexture*

Contiene la textura del mapa especular actual.

Por defecto, la textura especular tiene las siguientes propiedades:

  • Filtros lineales de reducción y ampliación
  • Mipmap lineal con mipmapping activado
  • Modo de repetición «wrap»
  • Anisotropía máxima de 16,0

Funciones de acceso:

Qt3DRender::QAbstractTexture *specular() const
void setSpecular(Qt3DRender::QAbstractTexture *specular)

Señal de notificación:

void specularChanged(Qt3DRender::QAbstractTexture *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 repetir 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 notificador:

void textureScaleChanged(float textureScale)

Documentación de las funciones miembro

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

Crea una nueva instancia de `QDiffuseSpecularMapMaterial` con el objeto padre ` parent`.

[virtual noexcept] QDiffuseSpecularMapMaterial::~QDiffuseSpecularMapMaterial()

Elimina la instancia de « QDiffuseSpecularMapMaterial ».

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