En esta página

Qt3DExtras::QMetalRoughMaterial Class

class Qt3DExtras::QMetalRoughMaterial

El material QMetalRoughMaterial ofrece una implementación predeterminada de la iluminación PBR. Más información...

Encabezado: #include <qmetalroughmaterial.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
En QML: MetalRoughMaterial
Heredado de: Qt3DRender::QMaterial
Estado: Obsoleto

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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 la iluminación por fragmento. Se proporcionan técnicas para OpenGL 3 y OpenGL ES 3.

Documentación de propiedades

ambientOcclusion : QVariant

Almacena la textura actual del mapa de oclusión ambiental del material. Solo puede ser una textura; de lo contrario, se ignora. Por defecto, este mapa no está configurado.

Funciones de acceso:

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

Señal de notificación:

void ambientOcclusionChanged(const QVariant &ambientOcclusion)

baseColor : QVariant

Almacena el color base actual del material. Puede ser tanto un valor de color liso como una textura. Por defecto, el valor de esta propiedad es «gris».

Funciones de acceso:

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

Señal de notificación:

void baseColorChanged(const QVariant &baseColor)

metalness : QVariant

Almacena el nivel actual de metalicidad del material, como un valor comprendido entre 0 (puramente dieléctrico, por defecto) y 1 (puramente metálico). Puede tratarse de un valor uniforme simple o de una textura. Por defecto, el valor de esta propiedad es 0.

Funciones de acceso:

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

Señal de notificación:

void metalnessChanged(const QVariant &metalness)

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)

roughness : QVariant

Almacena el nivel de rugosidad actual del material. Puede tratarse de un valor uniforme simple o de una textura. Por defecto, el valor de esta propiedad es 0.

Funciones de acceso:

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

Señal de notificación:

void roughnessChanged(const QVariant &roughness)

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

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

[virtual noexcept] QMetalRoughMaterial::~QMetalRoughMaterial()

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