En esta página

Material QML Type

Tipo base abstracto que proporciona funcionalidades comunes a los materiales. Más...

Import Statement: import QtQuick3D
Inherits:

Object3D

Inherited By:

CustomMaterial, DefaultMaterial, PrincipledMaterial, and SpecularGlossyMaterial

Propiedades

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.

ConstanteDescripción
Material.BackFaceCullingSe descartan los triángulos orientados hacia atrás.
Material.FrontFaceCullingSe descartan los triángulos orientados hacia delante.
Material.NoCullingNo 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

ConstanteDescripción
Material.OpaqueOnlyDepthDrawEl renderizado de profundidad solo se realiza si el material es opaco.
Material.AlwaysDepthDrawEl renderizado de profundidad se realiza siempre, independientemente del tipo de material.
Material.NeverDepthDrawNunca se realiza el renderizado de profundidad.
Material.OpaquePrePassDepthDrawEl 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 « true », todas las escrituras de profundidad se realizarán como resultado del paso previo de profundidad, pero sigue siendo necesario establecer explícitamente « Material.OpaquePrePassDepthDraw » para que solo se escriban los fragmentos opacos en los pases de profundidad y de sombras.

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.