Material QML Type
Tipo base abstracto que proporciona funcionalidades comunes a los materiales. Más...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: | CustomMaterial, DefaultMaterial, PrincipledMaterial, and SpecularGlossyMaterial |
Propiedades
- cullMode : enumeration
- depthDrawMode : enumeration
- lightProbe : Texture
Descripción detallada
Documentación de la propiedad
cullMode : enumeration
Esta propiedad define si está activada la eliminación de primitivas y, cuando está activada, qué primitivas se descartan.
El valor por defecto es Material.BackFaceCulling.
Se considera que un triángulo está orientado hacia delante si tiene un enrollamiento en sentido antihorario, lo que significa que sus vértices, en coordenadas del búfer de fotogramas, están ordenados en sentido antihorario.
| Constante | Descripción |
|---|---|
Material.BackFaceCulling | Se descartan los triángulos orientados hacia atrás. |
Material.FrontFaceCulling | Se descartan los triángulos orientados hacia delante. |
Material.NoCulling | No se descarta ningún triángulo. Nota: A partir de Qt 6.12, esta propiedad también afecta a la selección: un triángulo que se descarta al renderizar tampoco se puede seleccionar. Con Material.NoCulling, ambos lados de un triángulo son seleccionables. |
Véase también ` View3D.pick()`.
depthDrawMode : enumeration
Esta propiedad determina si se lleva a cabo el renderizado de profundidad para este material y en qué momento. El comportamiento predeterminado cuando la opción « SceneEnvironment::depthTestEnabled » está configurada en « true » es que, durante la pasada de renderizado principal, solo los materiales opacos escribirán en el búfer de profundidad. Esta propiedad permite modificar este comportamiento para ajustar con precisión el renderizado de un material.
El valor por defecto es Material.OpaqueOnlyDepthDraw
| Constante | Descripción |
|---|---|
Material.OpaqueOnlyDepthDraw | El renderizado de profundidad solo se realiza si el material es opaco. |
Material.AlwaysDepthDraw | El renderizado de profundidad se realiza siempre, independientemente del tipo de material. |
Material.NeverDepthDraw | Nunca se realiza el renderizado de profundidad. |
Material.OpaquePrePassDepthDraw | El renderizado de profundidad se realiza en una pasada de profundidad independiente, pero solo se escriben los valores opacos. Este modo también permite utilizar materiales transparentes en combinación con sombras. Nota: Si la opción « SceneEnvironment::depthPrePassEnabled » está configurada en « |
lightProbe : Texture
Esta propiedad define una textura para anular o establecer una textura de iluminación basada en una imagen, que se utilizará únicamente con este material.
Nota: Si se configura una sonda de luz en el material, se anulará el « scene's light probe » (Sonda de reflexión) para los modelos que utilicen este material.
Nota: Esta propiedad se ignora cuando se utiliza «Reflection Probe» para mostrar reflejos en el modelo que utiliza este material, ya que «Reflection Probe» utiliza la « scene's light probe ».
Véase también « SceneEnvironment::lightProbe ».
© 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.