En esta página

Qt3DExtras::QDiffuseMapMaterial Class

class Qt3DExtras::QDiffuseMapMaterial

El QDiffuseMapMaterial ofrece una implementación predeterminada del efecto de iluminación Phong, en la que el componente de luz difusa se lee a partir de un mapa de texturas. Más información...

Encabezado: #include <qdiffusemapmaterial.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

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 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 especular es el color emitido por 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.

Funciones de acceso:

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

Señal de notificación:

void ambientChanged(const QColor &ambient)

diffuse : Qt3DRender::QAbstractTexture*

Almacena la textura actual que se utiliza como mapa difuso.

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.

Funciones de acceso:

float shininess() const
void setShininess(float shininess)

Señal de notificación:

void shininessChanged(float shininess)

specular : QColor

Almacena el color especular actual.

Funciones de acceso:

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

Señal de notificación:

void specularChanged(const QColor &specular)

textureScale : float

Almacena la escala actual de la textura. Se aplica como multiplicador a las coordenadas de textura en el momento del renderizado. El valor predeterminado 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] QDiffuseMapMaterial::QDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr)

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

[virtual noexcept] QDiffuseMapMaterial::~QDiffuseMapMaterial()

Elimina la instancia de « 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.