En esta página

PrincipledMaterial QML Type

Te permite definir un material para elementos 3D mediante el flujo de trabajo «metal/rugosidad». Más...

Import Statement: import QtQuick3D
Inherits:

Material

Propiedades

Descripción detallada

Antes de que un modelo pueda renderizarse en una escena, debe tener al menos un material asociado que describa cómo debe sombrearse la malla. El PrincipledMaterial es un material PBR de metalicidad y rugosidad que pretende ser fácil de usar con un conjunto mínimo de parámetros. Además de tener pocos parámetros, todos los valores de entrada están estrictamente normalizados entre 0 y 1 y cuentan con valores por defecto razonables, lo que significa que, incluso sin modificar ningún valor, el material se puede utilizar para sombrear un modelo. Para obtener una introducción sobre cómo las diferentes propiedades del material Principled influyen en el sombreado de un modelo, consulta el ejemplo de Principled Material.

Flujo de trabajo de metal/rugosidad

El material «Principled» es lo que se conoce como un material de metalicidad/rugosidad; en esencia, esto significa que las características principales del material se controlan a través de las propiedades « metallness », « roughness » y « base color ».

Metalidad

Los materiales del mundo real se clasifican en dos categorías principales: metales y dieléctricos (no metales). En el material «Principled», la categoría a la que pertenece un material viene determinada por el valor de « metalness ». Establecer el valor de « metalness » en 0 significa que el material es un dieléctrico, mientras que cualquier valor superior a 0 se considera un metal. En la realidad, los metales tienen un valor de « metalness » de 1, pero son posibles valores entre 0 y 1, que suelen utilizarse para metales con una reflectancia reducida. Por ejemplo, para representar corrosión o efectos similares en un material, se debe reducir el valor de « metalness » del material para que las propiedades resultantes se asemejen más a las de un material dieléctrico. Dado que el valor de « metalness » afecta a la reflectancia del material, puede resultar tentador utilizar la «metalness» para ajustar el brillo, pero hay que tener en cuenta primero qué tipo de material se quiere representar. Aumentar el valor de « metalness » (textura) para dar a un material dieléctrico un aspecto más pulido introducirá propiedades que no son precisas para un material dieléctrico, por lo que debes plantearte si sería más adecuado ajustar, por ejemplo, el valor de « roughness » (textura) en su lugar.

Rugosidad

La « roughness » (textura) de un material describe el estado de la superficie de un objeto. Un valor bajo de « roughness » significa que el objeto tiene una superficie lisa y, por lo tanto, será más reflectante que un material con un valor más alto de « roughness ».

Color base

El base color de un material metálico o rugoso contiene tanto datos difusos como especulares; el valor metalness determina principalmente en qué medida el color base se interpreta como uno u otro. Por ejemplo, en un material con un valor de metalicidad (metalness) de 1, la mayor parte de su color base se interpretará como color especular, mientras que el color difuso será un tono negro. Lo contrario ocurriría en un material con un valor de metalicidad de 0. Por supuesto, esto es una explicación un poco simplificada, pero da una idea aproximada de cómo interactúan los valores de metalicidad ( base color ) y brillo ( metalness ). Para quienes estén más familiarizados con un flujo de trabajo de «Especular/Brillo», hay aquí una diferencia clara que merece la pena señalar, a saber, que los datos de color de los dos materiales no son directamente compatibles, ya que en un «Especular/Brillo» material, el color difuso y el especular provienen de entradas separadas.

Documentación de las propiedades

alphaCutoff : real

La propiedad `alphaCutoff` se puede utilizar para especificar el valor de umbral al utilizar el ` Mask alphaMode`. Los fragmentos en los que el valor alfa sea inferior al umbral se representarán totalmente transparentes (0.0 para todos los canales de color). Cuando el valor alfa sea igual o superior al valor de umbral, el color no se verá afectado en absoluto.

El valor por defecto es 0,5.

Véase también alphaMode.

alphaMode : enumeration

Esta propiedad especifica cómo se utilizan el valor de color alfa de « baseColor » y el canal alfa de « base color map ».

Nota: La prueba de corte alfa solo tiene en cuenta el alfa del color base. En este caso, no se tienen en cuenta ni opacity ni Node::opacity.

Nota: Al muestrear un mapa de colores base, el valor alfa efectivo es el alfa muestreado multiplicado por el alfa de baseColor.

ConstanteDescripción
PrincipledMaterial.DefaultNo se aplica ninguna prueba; el valor alfa efectivo se transmite tal cual. Ten en cuenta que un alfa de « baseColor » o « baseColorMap » inferior a 1.0 no implica automáticamente una mezcla alfa; el objeto con ese material puede seguir tratándose como opaco si ninguna otra propiedad relevante (como una opacidad inferior a 1, la presencia de un mapa de opacidad o un valor de « blendMode » no predeterminado) hace que el objeto se trate como semitransparente. Para garantizar que se produzca la mezcla alfa independientemente de cualquier otra propiedad del objeto o del material, establece en su lugar « Blend ».
PrincipledMaterial.BlendNo se aplica ninguna prueba de corte, pero se garantiza que se produzca la mezcla alfa. Por lo tanto, el renderizador nunca tratará el objeto con este material como opaco.
PrincipledMaterial.OpaqueNo se aplica ninguna prueba de corte y se supone que el objeto renderizado es totalmente opaco, lo que significa que se ignoran los valores alfa del color de vértice, el color base y el mapa de color base, y se sustituyen por un valor de 1,0. Este modo no garantiza que no se produzca la mezcla alfa. Si las propiedades pertinentes (como una opacidad inferior a 1, un mapa de opacidad o un ` blendMode` no predeterminado) así lo indican, el objeto seguirá siendo tratado como semitransparente por el proceso de renderizado, al igual que con el `alphaMode` de ` Default `.
PrincipledMaterial.MaskSe aplica una prueba basada en alphaCutoff. Si el valor alfa efectivo cae por debajo de alphaCutoff, el fragmento pasa a ser totalmente transparente y se descarta (con todas las implicaciones que ello conlleva: no se escribe el búfer de profundidad para ese fragmento). De lo contrario, el alfa se cambia a 1,0, de modo que el fragmento se vuelve totalmente opaco. En lo que respecta a la mezcla alfa, el comportamiento de este modo es idéntico al de Opaque, independientemente del resultado de la prueba de corte. Esto significa que se cumplen las Notas de implementación sobre la cobertura alfa de la especificación glTF 2. Los objetos con pruebas de corte alfa también pueden proyectar sombras, ya que se comportan como objetos opacos por defecto, a menos que las propiedades relevantes (como una opacidad inferior a 1, un mapa de opacidad o un valor de « blendMode » distinto del predeterminado) indiquen lo contrario (en cuyo caso no será posible proyectar sombras).

Véase también alphaCutoff y blendMode.

attenuationColor : color

Esta propiedad define el color que adquieren las luces blancas debido a la absorción al alcanzar la distancia de atenuación. El valor por defecto es Qt.White

attenuationDistance : real

Esta propiedad define la densidad del medio, expresada como la distancia media que recorre la luz en el medio antes de interactuar con una partícula. El valor se expresa en el espacio mundial. El valor por defecto es +infinity.

baseColor : color

Esta propiedad establece el color base del material. Dependiendo del tipo de material especificado (metal o dieléctrico), los canales difuso y especular se configurarán adecuadamente. Por ejemplo, un material dieléctrico tendrá un color difuso igual al color base, mientras que su color especular, dependiendo de la intensidad especular, será un color especular brillante. En el caso de los metales, los canales difuso y especular se mezclarán a partir del color base y presentarán un canal difuso oscuro y un canal especular cercano al color base.

Véase también baseColorMap y alphaMode.

baseColorChannel : enumeration [since 6.8]

Esta propiedad define el canal de textura que se utiliza para leer el valor « baseColor » de « baseColorMap ». Para utilizar un único canal de textura como color, debes activar la opción « baseColorSingleChannelEnabled ». El valor por defecto es « Material.R ».

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

Esta propiedad se introdujo en Qt 6.8.

baseColorMap : Texture

Esta propiedad define la textura que se utiliza para establecer el color base del material.

Véase también baseColor y alphaMode.

baseColorSingleChannelEnabled : bool [since 6.8]

Cuando esta propiedad está activada, el material utilizará el valor único de la propiedad « baseColorChannel » de la propiedad « baseColorMap » como valor RGB y utilizará 1,0 como valor alfa. El valor por defecto es «false».

Esta propiedad se introdujo en Qt 6.8.

blendMode : enumeration

Esta propiedad determina cómo se mezclan los colores del modelo renderizado con los que hay detrás.

ConstanteDescripción
PrincipledMaterial.SourceOverModo de mezcla predeterminado. Los objetos opacos ocultan los objetos que hay detrás de ellos. Este modo predeterminado no garantiza por sí solo la mezcla alfa en el proceso de renderizado para los modelos que utilizan este material, sino que hace que la decisión dependa de varios factores: si la opacidad total del objeto y del material es 1.0, no hay un mapa de opacidad en el material y alphaMode no está establecido en un valor que imponga la mezcla alfa, entonces el modelo se trata como opaco, lo que significa que se renderiza con las pruebas de profundidad y la escritura de profundidad habilitadas, junto con otros objetos opacos, con la mezcla deshabilitada. En caso contrario, el modelo se trata como semitransparente y se renderiza después de los objetos opacos, junto con otros objetos semitransparentes en un orden de atrás hacia delante basado en la distancia de su centro a la cámara, con la mezcla alfa activada.
PrincipledMaterial.ScreenLos colores se mezclan mediante una multiplicación invertida, lo que produce un resultado más claro. Este modo de mezcla es independiente del orden; si utilizas objetos semitransparentes y observas «efectos de salto» (popping) al ordenarse las caras o los modelos de forma diferente, utilizar la mezcla «Screen» es una forma de obtener resultados sin ese efecto.
PrincipledMaterial.MultiplyLos colores se mezclan mediante una multiplicación, lo que produce un resultado más oscuro. Este modo de fusión también es independiente del orden.

Véase también alphaMode y Qt Quick Arquitectura 3D.

clearcoatAmount : real

Esta propiedad define la intensidad de la capa de barniz transparente.

El valor por defecto es 0.0

clearcoatChannel : enumeration

Esta propiedad define el canal de textura utilizado para leer el valor de la cantidad de capa transparente de clearcoatMap. El valor por defecto es Material.R.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

clearcoatFresnelBias : real

Esta propiedad potencia los reflejos frontales (al mirar directamente a la superficie) al tiempo que mantiene los reflejos que se observan en ángulos rasantes. Para aplicar cambios al material, debes activar la opción « clearcoatFresnelScaleBiasEnabled ». El valor por defecto es « 0.0 ».

clearcoatFresnelPower : real

Esta propiedad reduce los reflejos frontales (al mirar directamente a la superficie) al tiempo que mantiene los reflejos que se observan en ángulos rasantes. El valor por defecto es « 5.0 ».

clearcoatFresnelScale : real

Esta propiedad escala los reflejos frontales (mirando directamente a la superficie) sin alterar los reflejos que se observan en ángulos rasantes. Para aplicar cambios al material, debes activar la opción « clearcoatFresnelScaleBiasEnabled ». El valor por defecto es « 1.0 ».

clearcoatFresnelScaleBiasEnabled : real

Al establecer el valor en «true», el material tendrá en cuenta los parámetros «Clearcoat Fresnel Scale» y «Clearcoat Fresnel Bias». El valor por defecto es « false ».

clearcoatMap : Texture

Esta propiedad define una textura que se utiliza para determinar la intensidad de la capa de barniz transparente. El valor de «clearcoatAmount » se multiplicará por el valor leído de esta textura.

clearcoatNormalMap : Texture

Esta propiedad define una textura que se utiliza para determinar el mapeado de normales que se aplica a la capa de barniz transparente.

clearcoatNormalStrength : real

Esta propiedad controla la magnitud del desplazamiento simulado para el « clearcoatNormalMap ».

clearcoatRoughnessAmount : real

Esta propiedad define la rugosidad de la capa de barniz transparente. El valor por defecto es 0.0

clearcoatRoughnessChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el nivel de rugosidad de la capa transparente a partir de clearcoatRoughnessMap. El valor por defecto es Material.G.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

clearcoatRoughnessMap : Texture

Esta propiedad define una textura que se utiliza para determinar la rugosidad de la capa de barniz transparente. El valor de «clearcoatRoughnessAmount » se multiplicará por el valor que se lea de esta textura.

emissiveChannel : enumeration [since 6.8]

Esta propiedad define el canal de textura que se utiliza para leer el valor emisivo de emissiveMap. Para utilizar un único canal de textura como color, debes activar la opción « emissiveSingleChannelEnabled ». El valor por defecto es Material.R.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

Esta propiedad se introdujo en Qt 6.8.

emissiveFactor : vector3d

Esta propiedad determina el color de la autoiluminación de este material. Si se establece un mapa emisivo, los componentes x, y y z se utilizan como factores (multiplicadores) para los canales R, G y B de la textura, respectivamente. El valor por defecto es (0, 0, 0), lo que significa que no hay ninguna contribución emisiva.

Nota: Si se establece lightingMode en DefaultMaterial.NoLighting, el factor de emisión no tiene ningún efecto en la escena.

emissiveMap : Texture

Esta propiedad establece una textura RGB que se utilizará para especificar la intensidad del color emisivo.

emissiveSingleChannelEnabled : bool [since 6.8]

Cuando esta propiedad está activada, el material utilizará el valor único de « emissiveChannel » de « emissiveMap » como valor RGB. El valor por defecto es «false».

Esta propiedad se introdujo en Qt 6.8.

fresnelBias : real

Esta propiedad potencia los reflejos frontales (mirando directamente a la superficie) al tiempo que mantiene los reflejos que se observan en ángulos rasantes. Para aplicar cambios al material, debes activar la opción « fresnelScaleBiasEnabled ». El valor por defecto es « 0.0 ».

fresnelPower : real

Esta propiedad reduce los reflejos frontales (al mirar directamente a la superficie) y, al mismo tiempo, mantiene los reflejos que se observan en ángulos rasantes. El valor por defecto es « 5.0 ».

fresnelScale : real

Esta propiedad escala los reflejos frontales (mirando directamente a la superficie) sin alterar los reflejos que se observan en ángulos rasantes. Para poder modificar el material, debes activar la opción « fresnelScaleBiasEnabled ». El valor por defecto es « 1.0 ».

fresnelScaleBiasEnabled : real

Al establecer el valor en «true», el material tendrá en cuenta la escala de Fresnel y el sesgo de Fresnel. El valor predeterminado es « false ».

heightAmount : real

Esta propiedad contiene el factor que se utiliza para modificar los valores de la textura « heightMap ». El valor debe estar comprendido entre 0,0 y 1,0. El valor por defecto es 0,0, lo que significa que el desplazamiento de altura estará desactivado, incluso si se ha establecido un mapa de altura.

heightChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el valor de altura de « heightMap ». El valor por defecto es « Material.R ».

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

heightMap : Texture

Esta propiedad define una textura que se utiliza para determinar la altura a la que se desplazará la textura al renderizarse mediante el mapeado de paralaje. Los valores deben ser lineales, comprendidos entre 0,0 y 1,0, donde 0,0 significa que no hay desplazamiento y 1,0 significa el desplazamiento máximo.

indexOfRefraction : real

Esta propiedad define el índice de refracción del material. El valor por defecto de « 1.5 » será el valor ideal para materiales como los plásticos o el cristal, pero otros materiales como el agua, el asfalto, el zafiro o el diamante requerirían un valor ajustado para que el resultado fuera más realista. Para materiales realistas, el índice de refracción (indexOfRefraction) debería situarse normalmente entre « 1.0 » y 3.0

Algunos ejemplos del índice de refracción de materiales comunes son:

MaterialÍndice de refracción
Aire1,0
Agua1,33
Vidrio1,55
Zafiro1,76
Diamante2,42

Nota: No se conoceningún material en el mundo que tenga un índice de refracción mucho mayor que el de 3.0.

invertOpacityMapValue : real [since 6.8]

Esta propiedad invierte el valor de opacidad de la propiedad « opacityMap ». El valor por defecto es « false ».

Esta propiedad se introdujo en Qt 6.8.

lighting : enumeration

Esta propiedad define qué método de iluminación se utiliza al generar este material.

El valor por defecto es PrincipledMaterial.FragmentLighting

Al utilizar « PrincipledMaterial.FragmentLighting », se calculan la iluminación difusa y la especular para cada píxel renderizado. Ciertos efectos (como el efecto Fresnel o el mapa de normales) requieren que se utilice « PrincipledMaterial.FragmentLighting » para funcionar.

Al utilizar « PrincipledMaterial.NoLighting », no se calcula ninguna iluminación. Este modo es (como cabe esperar) muy rápido y resulta bastante eficaz cuando se utilizan mapas de imagen que no necesitan ser sombreados por la iluminación. Se ignorarán todas las demás propiedades de sombreado, excepto los valores de « baseColor », los valores alfa y los colores de vértice.

ConstanteValor
PrincipledMaterial.NoLighting
PrincipledMaterial.FragmentLighting

lineWidth : real

Esta propiedad determina el ancho de las líneas representadas, cuando la geometría utiliza un tipo primitivo de líneas o tiras de líneas. El valor por defecto es 1,0. Esta propiedad no es relevante al representar otros tipos de geometría, como, por ejemplo, mallas triangulares.

Advertencia: Es posible que los anchosde línea distintos de 1 no sean compatibles en tiempo de ejecución, dependiendo de la API gráfica subyacente. En tal caso, se ignora la solicitud de cambiar el ancho. Por ejemplo, no cabe esperar que ninguna de las siguientes API admita líneas anchas: Direct3D, Metal y OpenGL con contextos de perfil básico.

maxHeightMapSamples : int

Esta propiedad define el número máximo de muestras que se utilizan para realizar el mapeado de oclusión paralela (Parallex Occlusion Mapping) mediante el mapa de altura de la superficie ( heightMap). El valor de «maxHeightMapSamples» corresponde al número de muestras del mapa de altura de la superficie ( heightMap ) que se utilizan cuando se mira en paralelo a una superficie. El valor por defecto es 32.

El número real de muestras utilizadas para cada fragmento estará comprendido entre minHeightMapSamples y maxHeightMapSamples, dependiendo del ángulo de la cámara con respecto a la superficie que se está renderizando.

Nota: Este valor solo debe ajustarse para perfeccionar los materiales que utilicen un mapa de altura interno ( heightMap ) en caso de que aparezcan artefactos no deseados.

metalness : real

La propiedad «metalness» define el grado de metalicidad del material. El valor está normalizado: 0,0 significa que el material es dieléctrico (no metálico) y un valor de 1,0 significa que el material es metálico.

Nota: En principio, los materiales son o bien dieléctricos con una metalidad de 0, o bien metales con una metalidad de 1. Se siguen admitiendo valores de metalidad entre 0 y 1, lo que dará lugar a un material que es una mezcla entre los diferentes modelos.

El rango es [0,0; 1,0]. El valor por defecto es 0.

metalnessChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el valor de metalicidad de « metalnessMap ». El valor por defecto es « Material.B ».

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

metalnessMap : Texture

Esta propiedad establece una textura que se utilizará para definir el grado de metalicidad de las diferentes partes del material.

minHeightMapSamples : int

Esta propiedad define el número mínimo de muestras que se utilizan para realizar el mapeado de oclusión paralela mediante el mapa de altura de la superficie ( heightMap). El valor de `minHeightMapSamples` corresponde al número de muestras del mapa de altura de la superficie ( heightMap ) que se utilizan al mirar directamente hacia una superficie (cuando la vista de la cámara es perpendicular al fragmento). El valor por defecto es 8.

El número real de muestras utilizadas para cada fragmento estará comprendido entre minHeightMapSamples y maxHeightMapSamples, dependiendo del ángulo de la cámara con respecto a la superficie que se está renderizando.

Nota: Este valor solo debe ajustarse para perfeccionar los materiales que utilicen un mapa de altura mínimo ( heightMap ) en caso de que aparezcan artefactos no deseados.

normalMap : Texture

Esta propiedad define una imagen RGB que se utiliza para simular un desplazamiento geométrico preciso en toda la superficie del material. Los canales RGB indican las desviaciones normales en los ejes X, Y y Z.

Nota: Los mapasde normales no afectan a la silueta de un modelo.

normalStrength : real

Esta propiedad controla la magnitud del desplazamiento simulado para el « normalMap ».

occlusionAmount : real

Esta propiedad contiene el factor que se utiliza para modificar los valores de la textura « occlusionMap ». El valor debe estar comprendido entre 0,0 y 1,0. El valor por defecto es 1,0.

occlusionChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el valor de oclusión de occlusionMap. El valor por defecto es Material.R.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

occlusionMap : Texture

Esta propiedad define una textura que se utiliza para determinar la cantidad de luz que deben recibir las diferentes zonas del material. Se espera que los valores sean lineales, comprendidos entre 0,0 y 1,0, donde 0,0 significa que no hay iluminación y 1,0 significa que el efecto de la iluminación no se modifica.

Véase también occlusionAmount.

opacity : real

Esta propiedad reduce la opacidad únicamente de este material, independientemente del modelo.

opacityChannel : enumeration

Esta propiedad define el canal de textura utilizado para leer el valor de opacidad de « opacityMap ». El valor por defecto es « Material.A ».

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

opacityMap : Texture

Esta propiedad define una textura que se utiliza para controlar la opacidad de forma diferente en las distintas partes del material.

pointSize : real

Esta propiedad determina el tamaño de los puntos representados cuando la geometría utiliza un tipo de primitiva de puntos. El valor por defecto es 1,0. Esta propiedad no es relevante al representar otros tipos de geometría, como, por ejemplo, las mallas triangulares.

Advertencia: Es posible que los tamañosde punto distintos de 1 no sean compatibles en tiempo de ejecución, dependiendo de la API gráfica subyacente. Por ejemplo, establecer un tamaño distinto de 1 no tiene ningún efecto con Direct 3D.

roughness : real

Esta propiedad controla el tamaño del reflejo especular generado por las luces y la nitidez de los reflejos en general. Los valores más altos aumentan la rugosidad, suavizando los reflejos especulares y difuminando los reflejos. El rango es [0,0; 1,0]. El valor por defecto es 0.

roughnessChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el valor de rugosidad de roughnessMap. El valor por defecto es Material.G.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

roughnessMap : Texture

Esta propiedad define una textura para controlar la rugosidad especular del material.

specularAmount : real

Esta propiedad controla la intensidad de la especularidad (reflejos y brillos).

El rango es [0,0; 1,0]. El valor por defecto es 1.0.

Nota: En el caso de los materiales no dieléctricos (metales), esta propiedad no tiene ningún efecto.

Nota: Esta propiedad no afecta a la « specularReflectionMap », pero sí influye en la cantidad de reflejos procedentes de un « SceneEnvironment::lightProbe » de la escena.

specularChannel : enumeration [since 6.8]

Esta propiedad define el canal de textura que se utiliza para leer el valor del color especular de specularMap. Para utilizar un único canal de textura como color, debes activar la opción « specularSingleChannelEnabled ». El valor por defecto es Material.R.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

Esta propiedad se introdujo en Qt 6.8.

specularMap : Texture

Esta propiedad define una textura RGB para modular la intensidad y el color del brillo especular en toda la superficie del material. Estos valores se multiplican por el « specularAmount ».

Nota: El mapa especular se ignorará a menos que el material sea dieléctrico.

specularReflectionMap : Texture

Esta propiedad establece una textura que se utiliza para los reflejos especulares del material.

Normalmente se utiliza para realizar mapeado de entorno: a medida que se gira el modelo, el mapa parecerá reflejarse a partir del entorno. Para que esto funcione como se espera, la propiedad « mappingMode » de la textura debe establecerse en «Texture.Environment». Los mapas de reflexión especular son una forma sencilla de añadir un aspecto de alta calidad con un coste relativamente bajo.

Nota: Asociar un « light probe » con « SceneEnvironment », y por tanto recurrir a la iluminación basada en imágenes, permite conseguir efectos de reflexión ambiental similares. Sin embargo, las sondas de luz son una solución conceptualmente diferente y, en lo que respecta al rendimiento, potencialmente más costosa. Cada enfoque tiene sus propios usos específicos, y hay que decidir cuál utilizar caso por caso. En lo que respecta a la propiedad «Texture», «specularReflectionMap» tiene una ventaja, ya que no presenta limitaciones y admite todo tipo de texturas, incluidas aquellas que obtienen sus datos de una subescena « Qt Quick » a través de « sourceItem ».

Nota: Las imágenesnítidas hacen que el material tenga un aspecto muy brillante; cuanto más desenfocada esté la imagen, más suave parecerá el material.

Véase también Texture::mappingMode.

specularSingleChannelEnabled : bool [since 6.8]

Cuando esta propiedad está activada, el material utilizará el valor único de la propiedad « specularChannel » de la propiedad « specularMap » como valor RGB. El valor por defecto es «false».

Esta propiedad se introdujo en Qt 6.8.

specularTint : real

Esta propiedad define en qué medida el color base contribuye a los reflejos especulares.

Nota: Esta propiedad solo se aplica a los materiales dieléctricos.

thicknessChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el valor de grosor de transmissionMap. El valor por defecto es Material.G.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

thicknessFactor : real

Esta propiedad define el espesor del volumen situado debajo de la superficie. A diferencia de muchas otras propiedades de PrincipledMaterial, el valor definido en «thicknessFactor» es un valor comprendido entre 0,0 y +∞ para el espesor en el espacio de coordenadas del modelo. Un valor de 0,0 significa que el material tiene paredes delgadas. El valor por defecto es 0.0

thicknessMap : Texture

Esta propiedad define una textura que se utiliza para determinar el grosor del volumen de un material. El valor de « thicknessFactor » se multiplicará por el valor que se lea de esta textura.

transmissionChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el porcentaje de transmisión de transmissionMap. El valor por defecto es Material.R.

ConstanteDescripción
Material.RLee el valor del canal R de la textura.
Material.GLee el valor del canal G de la textura.
Material.BLee el valor del canal B de la textura.
Material.ALee el valor del canal A de la textura.

transmissionFactor : real

Esta propiedad define el porcentaje de luz que se transmite a través de la superficie del material. El valor por defecto es 0.0

transmissionMap : Texture

Esta propiedad define una textura que se utiliza para determinar el porcentaje de luz que se transmite a través de la superficie. El valor de « transmissionFactor » se multiplicará por el valor leído de esta textura.

vertexColorAlphaMask : enumeration [since 6.8]

Esta propiedad define el canal alfa del color de los vértices que se utiliza como máscara especificada. El valor es una combinación bit a bit de indicadores. El valor por defecto es PrincipledMaterial.NoMask.

ConstanteDescripción
PrincipledMaterial.NoMask.
PrincipledMaterial.ClearcoatAmountMask.
PrincipledMaterial.ClearcoatRoughnessAmountMask.
PrincipledMaterial.ClearcoatNormalStrengthMask.
PrincipledMaterial.HeightAmountMask.
PrincipledMaterial.MetalnessMask.
PrincipledMaterial.RoughnessMask.
PrincipledMaterial.NormalStrengthMask.
PrincipledMaterial.OcclusionAmountMask.
PrincipledMaterial.SpecularAmountMask.
PrincipledMaterial.ThicknessFactorMask.
PrincipledMaterial.TransmissionFactorMask.

Esta propiedad se introdujo en Qt 6.8.

vertexColorBlueMask : enumeration [since 6.8]

Esta propiedad define el canal azul del color del vértice que se utiliza como máscara especificada. El valor es una combinación bit a bit de indicadores. El valor por defecto es « PrincipledMaterial.NoMask ».

ConstanteDescripción
PrincipledMaterial.NoMask.
PrincipledMaterial.ClearcoatAmountMask.
PrincipledMaterial.ClearcoatRoughnessAmountMask.
PrincipledMaterial.ClearcoatNormalStrengthMask.
PrincipledMaterial.HeightAmountMask.
PrincipledMaterial.MetalnessMask.
PrincipledMaterial.RoughnessMask.
PrincipledMaterial.NormalStrengthMask.
PrincipledMaterial.OcclusionAmountMask.
PrincipledMaterial.SpecularAmountMask.
PrincipledMaterial.ThicknessFactorMask.
PrincipledMaterial.TransmissionFactorMask.

Esta propiedad se introdujo en Qt 6.8.

vertexColorGreenMask : enumeration [since 6.8]

Esta propiedad define el canal verde del color de vértice que se utiliza como máscara especificada. El valor es una combinación bit a bit de indicadores. El valor por defecto es PrincipledMaterial.NoMask.

ConstanteDescripción
PrincipledMaterial.NoMask.
PrincipledMaterial.ClearcoatAmountMask.
PrincipledMaterial.ClearcoatRoughnessAmountMask.
PrincipledMaterial.ClearcoatNormalStrengthMask.
PrincipledMaterial.HeightAmountMask.
PrincipledMaterial.MetalnessMask.
PrincipledMaterial.RoughnessMask.
PrincipledMaterial.NormalStrengthMask.
PrincipledMaterial.OcclusionAmountMask.
PrincipledMaterial.SpecularAmountMask.
PrincipledMaterial.ThicknessFactorMask.
PrincipledMaterial.TransmissionFactorMask.

Esta propiedad se introdujo en Qt 6.8.

vertexColorRedMask : enumeration [since 6.8]

Esta propiedad define el canal rojo del color de vértice que se utiliza como máscara especificada. El valor es una combinación bit a bit de indicadores. El valor por defecto es PrincipledMaterial.NoMask.

ConstanteDescripción
PrincipledMaterial.NoMask.
PrincipledMaterial.ClearcoatAmountMask.
PrincipledMaterial.ClearcoatRoughnessAmountMask.
PrincipledMaterial.ClearcoatNormalStrengthMask.
PrincipledMaterial.HeightAmountMask.
PrincipledMaterial.MetalnessMask.
PrincipledMaterial.RoughnessMask.
PrincipledMaterial.NormalStrengthMask.
PrincipledMaterial.OcclusionAmountMask.
PrincipledMaterial.SpecularAmountMask.
PrincipledMaterial.ThicknessFactorMask.
PrincipledMaterial.TransmissionFactorMask.

Esta propiedad se introdujo en Qt 6.8.

vertexColorsEnabled : bool [since 6.5]

Cuando esta propiedad está activada, el material utilizará los colores de vértice de la malla. Estos se multiplicarán por cualquier otro color especificado para el material. El valor por defecto es «true».

Esta propiedad se introdujo en Qt 6.5.

vertexColorsMaskEnabled : bool [since 6.8]

Cuando esta propiedad está activada, el material utilizará los colores de vértice de la malla como máscara para diversas propiedades, por ejemplo, RoughnessAmount, SpecularAmount, etc. El valor por defecto es «false».

Esta propiedad se introdujo en Qt 6.8.

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