En esta página

Qt3DExtras::QMetalRoughMaterial Class

class Qt3DExtras::QMetalRoughMaterial

El QMetalRoughMaterial proporciona una implementación por defecto de la iluminación PBR. Más...

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

Propiedades

Funciones públicas

QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QMetalRoughMaterial()
QVariant ambientOcclusion() const
QVariant baseColor() const
QVariant metalness() const
QVariant normal() const
QVariant roughness() const
float textureScale() const

Ranuras públicas

void setAmbientOcclusion(const QVariant &ambientOcclusion)
void setBaseColor(const QVariant &baseColor)
void setMetalness(const QVariant &metalness)
void setNormal(const QVariant &normal)
void setRoughness(const QVariant &roughness)
void setTextureScale(float textureScale)

Señales

void ambientOcclusionChanged(const QVariant &ambientOcclusion)
void baseColorChanged(const QVariant &baseColor)
void metalnessChanged(const QVariant &metalness)
void normalChanged(const QVariant &normal)
void roughnessChanged(const QVariant &roughness)
void textureScaleChanged(float textureScale)

Descripción Detallada

Este material utiliza un efecto con un enfoque de una sola pasada de renderizado y realiza una iluminación por fragmento. Se proporcionan técnicas para OpenGL 3 y OpenGL ES 3.

Documentación de propiedades

ambientOcclusion : QVariant

Contiene la textura actual del mapa de oclusión ambiental del material. Sólo puede ser una textura, de lo contrario se ignora. Por defecto este mapa no está definido.

Funciones de acceso:

QVariant ambientOcclusion() const
void setAmbientOcclusion(const QVariant &ambientOcclusion)

Señal notificadora:

void ambientOcclusionChanged(const QVariant &ambientOcclusion)

baseColor : QVariant

Contiene el color base actual del material. Puede ser un valor de color plano o una textura. Por defecto el valor de esta propiedad es "gris".

Funciones de acceso:

QVariant baseColor() const
void setBaseColor(const QVariant &baseColor)

Señal del notificador:

void baseColorChanged(const QVariant &baseColor)

metalness : QVariant

Contiene el nivel de metalización actual del material, como un valor entre 0 (puramente dieléctrico, por defecto) y 1 (puramente metálico). Puede ser un valor uniforme o una textura. Por defecto el valor de esta propiedad es 0.

Funciones de acceso:

QVariant metalness() const
void setMetalness(const QVariant &metalness)

Señal del notificador:

void metalnessChanged(const QVariant &metalness)

normal : QVariant

Contiene la textura actual del mapa de normales del material. Esto sólo puede ser una textura, de lo contrario se ignora. Por defecto este mapa no está definido.

Funciones de acceso:

QVariant normal() const
void setNormal(const QVariant &normal)

Señal notificadora:

void normalChanged(const QVariant &normal)

roughness : QVariant

Mantiene el nivel de rugosidad actual del material. Puede ser un valor uniforme o una textura. Por defecto el valor de esta propiedad es 0.

Funciones de acceso:

QVariant roughness() const
void setRoughness(const QVariant &roughness)

Señal notificadora:

void roughnessChanged(const QVariant &roughness)

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] QMetalRoughMaterial::QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)

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

[virtual noexcept] QMetalRoughMaterial::~QMetalRoughMaterial()

Destruye la instancia QMetalRoughMaterial.

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