DefaultMaterial QML Type
Te permite definir un material para elementos 3D utilizando el flujo de trabajo de especularidad/brillo. Más información...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Status: | Deprecated since 6.4 |
Este tipo está obsoleto desde QtQuick3D 6.4. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- blendMode : enumeration
- bumpAmount : real
- bumpMap : Texture
- diffuseColor : color
- diffuseLightWrap : real
- diffuseMap : Texture
- emissiveFactor : vector3d
- emissiveMap : Texture
- fresnelPower : real
- indexOfRefraction : real
- lighting : enumeration
- lineWidth : real
- normalMap : Texture
- opacity : real
- opacityChannel : enumeration
- opacityMap : Texture
- pointSize : real
- roughnessChannel : enumeration
- roughnessMap : Texture
- specularAmount : real
- specularMap : Texture
- specularModel : enumeration
- specularReflectionMap : Texture
- specularRoughness : real
- specularTint : color
- translucencyChannel : enumeration
- translucencyMap : Texture
- translucentFalloff : real
- vertexColorsEnabled : bool
Descripción detallada
Se recomienda utilizar en su lugar el PrincipledMaterial o SpecularGlossyMaterial.
Advertencia: Este material solo se proporciona por motivos de compatibilidad y no debe utilizarse en código nuevo. Es preferible utilizar el SpecularGlossyMaterial para crear materiales mediante el flujo de trabajo de especularidad/brillo o el PrincipledMaterial para crear materiales mediante el flujo de trabajo de metalicidad/rugosidad.
Antes de que un modelo pueda renderizarse en una escena, debe tener asociado al menos un material que describa cómo debe sombrearse la malla. El DefaultMaterial es un material fácil de usar que te permite describir tu material mediante un flujo de trabajo de tipo «especular/brillo». El material tiene unos valores predeterminados razonables y puede utilizarse para sombrear un modelo sin cambiar ninguna propiedad.
Flujo de trabajo de especular/brillo
El material «Default» ofrece una forma de crear materiales mediante un flujo de trabajo de tipo «especular/brillo». Las propiedades principales del material se controlan a través de las propiedades « specular », « roughness » y « diffuse color ».
Especular
La propiedad « specular reflectivity » 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 (Rugosidad)
El brillo de una superficie depende de lo lisa o irregular que sea. Una superficie lisa tendrá un reflejo de luz más intenso que una superficie rugosa, en la que el reflejo de la luz se dispersará más. En el material por defecto, el brillo del material se controla mediante la propiedad « roughness ».
Color difuso
La propiedad « diffuse color » describe el color básico del material y, a diferencia del color base de « PrincipledMaterial », el color difuso no contiene ninguna información sobre la reflectancia del material. Sin embargo, en el caso de las superficies reflectantes, el color difuso debe establecerse en un tono negro, ya que así se permite que el color especular contribuya al resultado.
Documentación de la propiedad
blendMode : enumeration
Esta propiedad determina cómo se mezclan los colores del modelo renderizado con los que hay detrás.
| Constante | Descripción |
|---|---|
DefaultMaterial.SourceOver | Modo 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 de 1.0 y no hay mapas de textura en el material que contengan píxeles semitransparentes, entonces el modelo se trata como opaco, lo que significa que se renderiza con las pruebas de profundidad y la escritura de profundidad activadas, junto con otros objetos opacos, y con la mezcla desactivada. De lo 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. |
DefaultMaterial.Screen | Los 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 semiopacos y observas efectos de «popping» debido a que las caras o los modelos se ordenan de forma diferente, utilizar la mezcla «Screen» es una forma de obtener resultados sin «popping». |
DefaultMaterial.Multiply | Los colores se mezclan mediante una multiplicación, lo que produce un resultado más oscuro. Este modo de mezcla tampoco depende del orden. |
Véase también Arquitectura 3D de «Qt Quick ».
bumpAmount : real
Esta propiedad controla la magnitud del desplazamiento simulado para bumpMap o normalMap. El valor por defecto es 0, lo que desactiva el efecto de relieve. El rango es [0, 1].
bumpMap : Texture
Esta propiedad define una textura en escala de grises para simular un desplazamiento geométrico sutil en toda la superficie del material. Los píxeles más claros indican zonas elevadas. La intensidad del efecto se controla mediante la propiedad « bumpAmount ».
Nota: los mapasde relieve no afectan a la silueta de un modelo.
diffuseColor : color
Esta propiedad determina el color difuso (albedo) del material. Si se establece el color difuso en un tono negro, se creará un material puramente especular (por ejemplo, metales o espejos).
diffuseLightWrap : real
Esta propiedad determina el grado de envoltura de la luz en el mapa de translucidez. Un valor de 0 hace que la luz no se envuelva en absoluto, mientras que un valor de 1 hace que la luz se envuelva por todo el objeto.
diffuseMap : Texture
Esta propiedad define una textura que se aplicará al material. Si se utiliza una textura con transparencia, también se aplicará el canal alfa como mapa de opacidad.
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 modo de iluminación (lightingMode) en « DefaultMaterial.NoLighting», el factor emisivo 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.
Véase también emissiveFactor.
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 « 0 », lo que desactiva el efecto Fresnel.
indexOfRefraction : real
Esta propiedad controla qué ángulos de reflexión se ven afectados por el « fresnelPower ». El valor por defecto es « 1.45 ». El valor debe ser mayor o igual a « 1.0 ».
Nota: No se conoceningún material en el mundo cuyo índice de refracción sea muy superior a 3.0.
lighting : enumeration
Esta propiedad define qué método de iluminación se utiliza al generar este material.
El valor por defecto es DefaultMaterial.FragmentLighting
Al utilizar « DefaultMaterial.FragmentLighting », se calculan la iluminación difusa y la especular para cada píxel renderizado. Ciertos efectos (como un mapa de Fresnel o un mapa de relieve) requieren « DefaultMaterial.FragmentLighting » para funcionar.
Al utilizar « DefaultMaterial.NoLighting », no se calcula ninguna iluminación. Este modo es (como es de esperar) muy rápido y bastante eficaz cuando se utilizan mapas de imagen que no necesitan ser sombreados por la iluminación.
| Constante | Descripción |
|---|---|
DefaultMaterial.NoLighting | No se calcula la iluminación. |
DefaultMaterial.FragmentLighting | Se calcula la iluminación por fragmento. |
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, OpenGL con contextos de perfil básico.
Nota: A diferencia de la mayoría de las demás propiedades de los materiales, el ancho de línea está integrado internamente en un objeto de canalización gráfica, de forma similar a blendMode. Por lo tanto, un valor diferente implica tener que crear un nuevo objeto de canalización, lo que con el tiempo puede resultar costoso (en términos de rendimiento y uso de recursos) si la propiedad se cambia con frecuencia a muchos valores diferentes. Por ejemplo, es posible animar esta propiedad, pero debe evitarse.
normalMap : Texture
Esta propiedad define una imagen RGB que se utiliza para simular un desplazamiento geométrico fino en toda la superficie del material. Los canales RGB indican las desviaciones normales en los ejes X, Y e Z. La intensidad del efecto se controla mediante la propiedad « bumpAmount ».
Nota: Los mapasde normales no afectan a la silueta de un modelo.
opacity : real
Esta propiedad reduce la opacidad únicamente de este material, independientemente del modelo. El valor por defecto es « 1.0 ». El rango es [0,0; 1,0].
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 ».
| Constante | Descripción |
|---|---|
Material.R | Lee el valor del canal R de la textura. |
Material.G | Lee el valor del canal G de la textura. |
Material.B | Lee el valor del canal B de la textura. |
Material.A | Lee 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.
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.R.
| Constante | Descripción |
|---|---|
Material.R | Lee el valor del canal R de la textura. |
Material.G | Lee el valor del canal G de la textura. |
Material.B | Lee el valor del canal B de la textura. |
Material.A | Lee el valor del canal A de la textura. |
roughnessMap : Texture
Esta propiedad define una textura para controlar la rugosidad especular del material. Si la textura contiene varios canales (RGBA), se puede seleccionar el canal correcto mediante la propiedad « roughnessChannel ».
specularAmount : real
Esta propiedad controla la intensidad de la especularidad (reflejos y destellos). El valor por defecto es 0, lo que desactiva la especularidad. El rango es [0,0; 1,0].
Nota: Esta propiedad no afecta a la opción « specularReflectionMap », pero sí influye en la cantidad de reflejos procedentes de la « SceneEnvironment::lightProbe » de una escena.
Nota: A menos que tu malla sea de alta resolución, es posible que tengas que utilizar « DefaultMaterial.FragmentLighting » para obtener buenos reflejos especulares de las luces de la escena.
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 ».
specularModel : enumeration
Esta propiedad determina qué funciones se utilizan para calcular los reflejos especulares de las luces de la escena.
| Constante | Descripción |
|---|---|
DefaultMaterial.Default | La iluminación especular utiliza el modelo de iluminación predeterminado. |
DefaultMaterial.KGGX | La iluminación especular utiliza el modelo de iluminación GGX. |
specularReflectionMap : Texture
Esta propiedad establece una textura que se utiliza para los reflejos especulares del material.
Normalmente se utiliza para realizar el mapeado del entorno: a medida que se gira el modelo, el mapa parecerá reflejarse a partir del entorno. Para que esto funcione como se espera, el « 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 lo tanto, basarse en la iluminación basada en imágenes, puede lograr 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 textura asignada a la propiedad, «specularReflectionMap» tiene una ventaja, ya que no presenta limitaciones y admite todo tipo de texturas, incluidas aquellas cuyos datos proceden de una subescena de « Qt Quick » a través de « sourceItem ».
Nota: Las imágenesnítidas hacen que el material tenga un aspecto muy brillante; cuanto más desenfocas la imagen, más suave parecerá el material.
Véase también Texture::mappingMode.
specularRoughness : 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.
specularTint : color
Esta propiedad define un color que se utiliza para ajustar los reflejos especulares. Utiliza el blanco si no quieres que se aplique ningún efecto.
translucencyChannel : enumeration
Esta propiedad define el canal de textura que se utiliza para leer el valor de translucidez de translucencyMap. El valor por defecto es Material.A.
| Constante | Descripción |
|---|---|
Material.R | Lee el valor del canal R de la textura. |
Material.G | Lee el valor del canal G de la textura. |
Material.B | Lee el valor del canal B de la textura. |
Material.A | Lee el valor del canal A de la textura. |
translucencyMap : Texture
Esta propiedad define una textura en escala de grises que controla la cantidad de luz que puede atravesar el material desde atrás.
translucentFalloff : real
Esta propiedad define el grado de atenuación de la translucidez en función del ángulo que forman las normales del objeto con respecto a la fuente de luz.
vertexColorsEnabled : bool
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.
© 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.