Qt3DExtras::QNormalDiffuseSpecularMapMaterial Class
class Qt3DExtras::QNormalDiffuseSpecularMapMaterialEl QNormalDiffuseSpecularMapMaterial ofrece una implementación predeterminada de la iluminación Phong y del efecto de relieve, en la que los componentes de luz difusa y especular se leen a partir de mapas de textura, y las normales de la malla que se está renderizando, a partir de un mapa de texturas de normales. Más...
| Encabezado: | #include <qnormaldiffusespecularmapmaterial.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. Recomendamos encarecidamente no utilizarla en código nuevo.
Propiedades
|
Funciones públicas
| QNormalDiffuseSpecularMapMaterial(Qt3DCore::QNode *parent = nullptr) | |
| virtual | ~QNormalDiffuseSpecularMapMaterial() |
| QColor | ambient() const |
| Qt3DRender::QAbstractTexture * | diffuse() const |
| Qt3DRender::QAbstractTexture * | normal() 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 | setNormal(Qt3DRender::QAbstractTexture *normal) |
| 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 | normalChanged(Qt3DRender::QAbstractTexture *normal) |
| void | shininessChanged(float shininess) |
| void | specularChanged(Qt3DRender::QAbstractTexture *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, difusa y especular. La intensidad relativa de estos componentes se controla mediante sus coeficientes de reflectividad, que se modelan como tríos de valores 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 una superficie brillante 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 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 * | 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 : 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 mosaico por toda 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] QNormalDiffuseSpecularMapMaterial::QNormalDiffuseSpecularMapMaterial(Qt3DCore::QNode *parent = nullptr)
Crea una nueva instancia de `QNormalDiffuseSpecularMapMaterial` con el objeto padre ` parent`.
[virtual noexcept] QNormalDiffuseSpecularMapMaterial::~QNormalDiffuseSpecularMapMaterial()
Elimina la instancia de « QNormalDiffuseSpecularMapMaterial ».
© 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.