En esta página

Qt3DExtras::QNormalDiffuseMapMaterial Class

class Qt3DExtras::QNormalDiffuseMapMaterial

El QNormalDiffuseMapMaterial ofrece una implementación predeterminada de la iluminación Phong y el efecto de relieve, en la que el componente de luz difusa se lee desde un mapa de texturas y las normales de la malla que se está renderizando, desde un mapa de texturas de normales. Más...

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

Qt3DExtras::QNormalDiffuseMapAlphaMaterial

Estado: Obsoleta

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

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

Ranuras públicas

void setAmbient(const QColor &ambient)
void setDiffuse(Qt3DRender::QAbstractTexture *diffuse)
void setNormal(Qt3DRender::QAbstractTexture *normal)
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 normalChanged(Qt3DRender::QAbstractTexture *normal)
void shininessChanged(float shininess)
void specularChanged(const QColor &specular)
void textureScaleChanged(float textureScale)

Descripción detallada

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

El efecto de iluminación especular 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:

  • La iluminación ambiental es el color que emite un objeto sin ninguna otra fuente de luz.
  • El difuso es el color que se emite en los reflejos de superficies rugosas con la luz.
  • El especular es el color emitido por los reflejos de las 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 &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 estas propiedades:

  • Filtros lineales de reducción y ampliación
  • Mipmap lineal con mipmapping activado
  • Modo de repetición «wrap» M
  • 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)

normal : Qt3DRender::QAbstractTexture*

Contiene la textura del mapa normal actual.

Por defecto, la textura normal tiene las siguientes propiedades:

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

Funciones de acceso:

Qt3DRender::QAbstractTexture *normal() const
void setNormal(Qt3DRender::QAbstractTexture *normal)

Señal de notificación:

void normalChanged(Qt3DRender::QAbstractTexture *normal)

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 de textura actual. 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 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] QNormalDiffuseMapMaterial::QNormalDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr)

Crea una nueva instancia de `QNormalDiffuseMapMaterial` cuyo objeto padre es ` parent`.

[virtual noexcept] QNormalDiffuseMapMaterial::~QNormalDiffuseMapMaterial()

Elimina la instancia de « QNormalDiffuseMapMaterial ».

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