Qt3DExtras::QDiffuseSpecularMaterial Class
class Qt3DExtras::QDiffuseSpecularMaterialLa clase `QDiffuseSpecularMaterial` ofrece una implementación predeterminada del efecto de iluminación Phong. Más información...
| Encabezado: | #include <qdiffusespecularmaterial.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| En QML: | DiffuseSpecularMaterial |
| Heredado de: | Qt3DRender::QMaterial |
| Estado: | Obsoleta |
Esta clase está en desuso. Recomendamos encarecidamente no utilizarla en código nuevo.
Propiedades
|
|
Funciones públicas
| QDiffuseSpecularMaterial(Qt3DCore::QNode *parent = nullptr) | |
| virtual | ~QDiffuseSpecularMaterial() |
| QColor | ambient() const |
| QVariant | diffuse() const |
| bool | isAlphaBlendingEnabled() const |
| QVariant | normal() const |
| float | shininess() const |
| QVariant | specular() const |
| float | textureScale() const |
Ranuras públicas
| void | setAlphaBlendingEnabled(bool enabled) |
| void | setAmbient(const QColor &ambient) |
| void | setDiffuse(const QVariant &diffuse) |
| void | setNormal(const QVariant &normal) |
| void | setShininess(float shininess) |
| void | setSpecular(const QVariant &specular) |
| void | setTextureScale(float textureScale) |
Señales
| void | alphaBlendingEnabledChanged(bool enabled) |
| void | ambientChanged(const QColor &ambient) |
| void | diffuseChanged(const QVariant &diffuse) |
| void | normalChanged(const QVariant &normal) |
| void | shininessChanged(float shininess) |
| void | specularChanged(const QVariant &specular) |
| void | textureScaleChanged(float textureScale) |
Descripción detallada
El efecto de iluminación Phong 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:
- El «Ambient» 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
alphaBlending : bool
Indica si se tendrá en cuenta la información alfa procedente de la propiedad «difusa» durante el renderizado. El valor predeterminado es «false».
Funciones de acceso:
| bool | isAlphaBlendingEnabled() const |
| void | setAlphaBlendingEnabled(bool enabled) |
Señal de notificación:
| void | alphaBlendingEnabledChanged(bool enabled) |
ambient : QColor
Contiene el color ambiental 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 : QVariant
Almacena el color difuso del material que se emite en los reflejos de superficies rugosas con las luces. Puede ser tanto un valor de color liso como una textura.
Funciones de acceso:
| QVariant | diffuse() const |
| void | setDiffuse(const QVariant &diffuse) |
Señal de notificación:
| void | diffuseChanged(const QVariant &diffuse) |
normal : QVariant
Almacena la textura del mapa normal actual del material. Solo puede ser una textura; de lo contrario, se ignora. Por defecto, este mapa no está configurado.
Funciones de acceso:
| QVariant | normal() const |
| void | setNormal(const QVariant &normal) |
Señal de notificación:
| void | normalChanged(const QVariant &normal) |
shininess : float
Almacena el exponente de brillo. Cuanto mayor sea el valor de brillo, más pequeño y brillante será el punto de luz.
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 : QVariant
Almacena el color especular del material que se emite para los reflejos de las superficies brillantes con las luces. Puede tratarse tanto de un valor de color liso como de una textura.
Funciones de acceso:
| QVariant | specular() const |
| void | setSpecular(const QVariant &specular) |
Señal de notificación:
| void | specularChanged(const QVariant &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 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] QDiffuseSpecularMaterial::QDiffuseSpecularMaterial(Qt3DCore::QNode *parent = nullptr)
Crea una nueva instancia de QDiffuseSpecularMaterial con el objeto padre « parent ».
[virtual noexcept] QDiffuseSpecularMaterial::~QDiffuseSpecularMaterial()
Destruye el « QDiffuseSpecularMaterial ».
© 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.