En esta página

SpecularGlossyMaterial QML Type

Te permite definir un material para elementos 3D mediante el flujo de trabajo de especularidad/brillo. Más información...

Import Statement: import QtQuick3D
Inherits:

Material

Propiedades

Descripción detallada

Antes de que un modelo pueda renderizarse en una escena, debe tener asignado al menos un material que describa cómo debe sombrearse la malla. El SpecularGlossyMaterial es un material PBR de especularidad y brillo diseñado para ser fácil de usar, con un conjunto mínimo de parámetros. Además de contar con pocos parámetros, todos los valores de entrada están estrictamente normalizados entre 0 y 1 y tienen valores por defecto razonables, lo que significa que, incluso sin modificar ningún valor, el material puede utilizarse para sombrear un modelo. Para obtener una introducción sobre cómo las diferentes propiedades del SpecularGlossyMaterial afectan al sombreado de un modelo, consulta el ejemplo «Principled Material », que ofrece un modo para utilizar el flujo de trabajo «Specular/Glossy».

Como alternativa, para utilizar el flujo de trabajo «metálico/rugosidad», utilice PrincipledMaterial.

Flujo de trabajo «Specular/Glossiness»

El SpecularGlossyMaterial ofrece una forma de crear materiales utilizando un flujo de trabajo de tipo especular/brillo. Las propiedades principales del material se controlan a través de las propiedades « specular », « glossiness » y « albedo ».

Especular

La propiedad « specularColor » describe la intensidad y el color especulares de la superficie de un objeto. En el caso de los materiales reflectantes, la principal contribución al color proviene de esta propiedad.

Brillo

El « glossiness » de un material describe el estado de la superficie de un objeto. Un valor alto de « glossiness » significa que el objeto tiene una superficie lisa y, por lo tanto, es más reflectante que un material con un valor más bajo de « glossiness ».

Albedo

La propiedad « albedoColor » describe el color difuso del material y, a diferencia del color base de « PrincipledMaterial », el albedo no contiene ninguna información sobre la reflectancia del material. Esto significa que, en el caso de las superficies reflectantes, el valor de color del albedo debe establecerse en un tono negro, ya que así se permitirá que el color especular contribuya.

Documentación de la propiedad

albedoChannel : enumeration [since 6.8]

Esta propiedad define el canal de textura que se utiliza para leer el valor del color de albedo de albedoMap. Para utilizar un único canal de textura como color, debes activar la opción « albedoSingleChannelEnabled ». 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.

albedoColor : color

Esta propiedad establece el color del albedo del material. Si se establece el color difuso en un tono negro, se creará un material puramente especular (por ejemplo, metales o espejos).

Véase también albedoMap y alphaMode.

albedoMap : Texture

Esta propiedad define la textura utilizada para establecer el color de albedo del material.

Véase también albedo y alphaMode.

albedoSingleChannelEnabled : bool [since 6.8]

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

Esta propiedad se introdujo en Qt 6.8.

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 renderizará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 albedoColor y el canal alfa de albedo map.

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

Nota: Al muestrear un mapa de color de albedo, el valor alfa efectivo es el alfa muestreado multiplicado por el alfa de albedoColor.

ConstanteDescripción
SpecularGlossyMaterial.DefaultNo se aplica ninguna prueba; el valor alfa efectivo se transmite tal cual. Ten en cuenta que un alfa de albedoColor o albedoMap inferior a 1.0 no implica automáticamente una mezcla alfa; el objeto con el 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 » distinto del 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, configura « Blend » en su lugar.
SpecularGlossyMaterial.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.
SpecularGlossyMaterial.OpaqueNo se aplica ninguna prueba de corte y se asume que el objeto renderizado es totalmente opaco, lo que significa que se ignoran los valores alfa del color de vértice, el color de albedo y el mapa de color de albedo, 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 valor de « blendMode » distinto del predeterminado) así lo indican, el objeto seguirá siendo tratado como semitransparente por el proceso de renderizado, al igual que con el modo alfa « Default ».
SpecularGlossyMaterial.MaskSe aplica una prueba basada en alphaCutoff. Si el valor alfa efectivo es inferior a alphaCutoff, el fragmento pasa a ser totalmente transparente y se descarta (con todas las implicaciones que ello conlleva: no se escribe en 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 adquiere la luz blanca 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.

blendMode : enumeration

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

ConstanteDescripción
SpecularGlossyMaterial.SourceOverModo de mezcla predeterminado. Los objetos opacos ocultan a los que se encuentran 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 la comprobación 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.
SpecularGlossyMaterial.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.
SpecularGlossyMaterial.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 3D Architecture».

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 que se utiliza 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 (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 « clearcoatFresnelScaleBiasEnabled ». El valor por defecto es « 0.0 ».

clearcoatFresnelPower : real

Esta propiedad reduce los reflejos frontales (al mirar directamente a la superficie) sin afectar a 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) 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 « 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.

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 utilizado para leer el valor del color 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 el parámetro 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 la propiedad « emissiveChannel » del objeto « 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 aplicar cambios al 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 por defecto es « false ».

glossiness : real

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

glossinessChannel : enumeration

Esta propiedad define el canal de textura que se utiliza para leer el valor de brillo de glossinessMap. 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.

glossinessMap : Texture

Esta propiedad define una textura para controlar el brillo del material.

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 que el desplazamiento es máximo.

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 SpecularGlossyMaterial.FragmentLighting

ConstanteDescripción
SpecularGlossyMaterial.FragmentLightingLa iluminación difusa y especular se calcula para cada píxel renderizado. Ciertos efectos (como el mapa de Fresnel o el mapa de normales) requieren que « SpecularGlossyMaterial.FragmentLighting » esté activado para funcionar.
SpecularGlossyMaterial.NoLightingNo se calcula la iluminación. Este modo es (como es de 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 albedo, los valores alfa y los colores de vértice.

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 ignorará 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 al mirar 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 utilizan un mapa de altura ( heightMap ) en caso de que aparezcan artefactos no deseados.

minHeightMapSamples : int

Esta propiedad define el número mínimo de muestras que se utilizan para realizar el mapeado de oclusión paralela (Parallex Occlusion Mapping) mediante el mapa de altura mínimo ( heightMap). El valor de `minHeightMapSamples` corresponde al número de muestras del mapa de altura mínimo ( 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 de fragmento ( 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 la función « normalMap ».

occlusionAmount : real

Esta propiedad contiene el factor utilizado 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 cuánta luz indirecta 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 indirecta y 1,0 significa que el efecto de la iluminación indirecta 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 que se utiliza 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, 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.

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.

specularColor : color

Esta propiedad define el color RGB especular. Si se especifica un valor alfa, se ignorará.

El valor por defecto es Qt.White

specularMap : Texture

Esta propiedad establece una textura que se utilizará para definir el color especular de las diferentes partes del material. Solo se utilizan los canales RGB.

specularSingleChannelEnabled : bool [since 6.8]

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

Esta propiedad se introdujo en Qt 6.8.

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 SpecularGlossyMaterial, 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 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 « SpecularGlossyMaterial.NoMask ».

ConstanteDescripción
SpecularGlossyMaterial.NoMask.
SpecularGlossyMaterial.GlossinessMask.
SpecularGlossyMaterial.NormalStrengthMask.
SpecularGlossyMaterial.ClearcoatAmountMask.
SpecularGlossyMaterial.ClearcoatRoughnessAmountMask.
SpecularGlossyMaterial.ClearcoatNormalStrengthMask.
SpecularGlossyMaterial.HeightAmountMask.
SpecularGlossyMaterial.OcclusionAmountMask.
SpecularGlossyMaterial.ThicknessFactorMask.
SpecularGlossyMaterial.TransmissionFactorMask.

Esta propiedad se introdujo en Qt 6.8.

vertexColorBlueMask : enumeration [since 6.8]

Esta propiedad define el canal azul 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 SpecularGlossyMaterial.NoMask.

ConstanteDescripción
SpecularGlossyMaterial.NoMask.
SpecularGlossyMaterial.GlossinessMask.
SpecularGlossyMaterial.NormalStrengthMask.
SpecularGlossyMaterial.ClearcoatAmountMask.
SpecularGlossyMaterial.ClearcoatRoughnessAmountMask.
SpecularGlossyMaterial.ClearcoatNormalStrengthMask.
SpecularGlossyMaterial.HeightAmountMask.
SpecularGlossyMaterial.OcclusionAmountMask.
SpecularGlossyMaterial.ThicknessFactorMask.
SpecularGlossyMaterial.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 SpecularGlossyMaterial.NoMask.

ConstanteDescripción
SpecularGlossyMaterial.NoMask.
SpecularGlossyMaterial.GlossinessMask.
SpecularGlossyMaterial.NormalStrengthMask.
SpecularGlossyMaterial.ClearcoatAmountMask.
SpecularGlossyMaterial.ClearcoatRoughnessAmountMask.
SpecularGlossyMaterial.ClearcoatNormalStrengthMask.
SpecularGlossyMaterial.HeightAmountMask.
SpecularGlossyMaterial.OcclusionAmountMask.
SpecularGlossyMaterial.ThicknessFactorMask.
SpecularGlossyMaterial.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 ` SpecularGlossyMaterial.NoMask`.

ConstanteDescripción
SpecularGlossyMaterial.NoMask.
SpecularGlossyMaterial.GlossinessMask.
SpecularGlossyMaterial.NormalStrengthMask.
SpecularGlossyMaterial.ClearcoatAmountMask.
SpecularGlossyMaterial.ClearcoatRoughnessAmountMask.
SpecularGlossyMaterial.ClearcoatNormalStrengthMask.
SpecularGlossyMaterial.HeightAmountMask.
SpecularGlossyMaterial.OcclusionAmountMask.
SpecularGlossyMaterial.ThicknessFactorMask.
SpecularGlossyMaterial.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, como, por ejemplo, «Glossiness», «OcclusionAmount», 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.