En esta página

Qt3DExtras::QDiffuseMapMaterial Class

class Qt3DExtras::QDiffuseMapMaterial

El QDiffuseMapMaterial proporciona una implementación por defecto del efecto de iluminación phong donde el componente de luz difusa se lee de un mapa de textura. Más...

Cabecera: #include <QDiffuseMapMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Hereda: Qt3DRender::QMaterial
Status: Obsoleto

Esta clase está obsoleta. Desaconsejamos su uso en código nuevo.

Propiedades

Funciones públicas

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

Ranuras públicas

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

Señales

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

Descripción detallada

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

El efecto de iluminación especular se basa en la combinación de 3 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 tripletes RGB:

  • Ambiente es el color que emite un objeto sin ninguna otra fuente de luz.
  • Difuso es el color emitido por los reflejos de la superficie con las luces.
  • Especular es el color que se emite para los reflejos brillantes de la superficie con las luces.
  • El brillo de una superficie se controla mediante una propiedad 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 OpenGL ES 2.

Documentación de propiedades

ambient : QColor

Mantiene el color ambiente actual.

Funciones de acceso:

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

Señal de aviso:

void ambientChanged(const QColor &ambient)

diffuse : Qt3DRender::QAbstractTexture*

Contiene la textura actual utilizada como mapa difuso.

Por defecto, la textura difusa tiene las siguientes propiedades:

  • Filtros de minificación y magnificación lineales
  • Mipmap lineal con mipmapping activado
  • Modo de envoltura de repetición
  • Anisotropía máxima de 16.0

Funciones de acceso:

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

Señal notificadora:

void diffuseChanged(Qt3DRender::QAbstractTexture *diffuse)

shininess : float

Mantiene el brillo actual como un valor flotante.

Funciones de acceso:

float shininess() const
void setShininess(float shininess)

Señal del notificador:

void shininessChanged(float shininess)

specular : QColor

Mantiene el color especular actual.

Funciones de acceso:

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

Señal del notificador:

void specularChanged(const QColor &specular)

textureScale : float

Mantiene la escala actual de la textura. Se aplica como un multiplicador a las coordenadas de la textura en tiempo de renderizado. Por defecto es 1.0.

Cuando se utiliza junto con QTextureWrapMode::Repeat, textureScale proporciona una forma sencilla de mosaico de una textura a través de una superficie. Por ejemplo, una escala de textura de 4.0 resultaría en 16 (4x4) mosaicos.

Funciones de acceso:

float textureScale() const
void setTextureScale(float textureScale)

Señal notificadora:

void textureScaleChanged(float textureScale)

Documentación de la función miembro

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

Construye una nueva instancia de QDiffuseMapMaterial con el objeto padre parent.

[virtual noexcept] QDiffuseMapMaterial::~QDiffuseMapMaterial()

Destruye la instancia QDiffuseMapMaterial.

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