DebugSettings QML Type
Se utiliza para configurar los ajustes de depuración. Más...
| Import Statement: | import QtQuick3D |
| Inherits: |
Propiedades
- disableShadowCameraUpdate : bool
(since 6.8) - drawCascades : bool
(since 6.8) - drawDirectionalLightShadowBoxes : bool
(since 6.8) - drawPointLightShadowBoxes : bool
(since 6.9) - drawSceneCascadeIntersection : bool
(since 6.8) - drawShadowCastingBounds : bool
(since 6.8) - drawShadowReceivingBounds : bool
(since 6.8) - materialOverride : enumeration
(since 6.5) - wireframeEnabled : bool
(since 6.5)
Descripción detallada
El renderizador puede ser configurado para mostrar diferentes vistas para facilitar la depuración. Este componente se utiliza para configurar estas vistas de depuración.
Además del control programático, propiedades como materialOverride y wireframeEnabled también pueden controlarse interactivamente a través del elemento DebugView si la aplicación añade una instancia del mismo a la escena Qt Quick.
Documentación de propiedades
disableShadowCameraUpdate : bool [since 6.8]
Cuando esta propiedad está activada, la actualización de la cámara se desactiva para el shadowmap. Esto significa que el frustum de la vista estará bloqueado en el espacio sólo para los cálculos del shadowmap. Esto es sólo una herramienta de depuración para poder ver el frustum de la cámara y el mapa de sombras desde diferentes ángulos.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.8.
drawCascades : bool [since 6.8]
Cuando esta propiedad está activada se dibuja un frustum con divisiones que indican dónde empiezan y terminan las cascadas del shadowmap.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.8.
drawDirectionalLightShadowBoxes : bool [since 6.8]
Cuando esta propiedad está activada, se dibuja un cuadro delimitador para cada mapa de sombra de luz direccional.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.8.
drawPointLightShadowBoxes : bool [since 6.9]
Cuando esta propiedad está activada, se dibuja un cuadro delimitador para el mapa de sombras de cada punto de luz.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.9.
drawSceneCascadeIntersection : bool [since 6.8]
Cuando esta propiedad está activada se dibuja la intersección de las cascadas del shadowmap y los objetos emisores y receptores de la escena.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.8.
drawShadowCastingBounds : bool [since 6.8]
Cuando esta propiedad está activada se dibuja una caja delimitadora para los objetos que proyectan sombra.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.8.
drawShadowReceivingBounds : bool [since 6.8]
Cuando esta propiedad está activada se dibuja una caja delimitadora para los objetos receptores de sombras.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.8.
materialOverride : enumeration [since 6.5]
Esta propiedad cambia cómo se renderizan todos los materiales para reflejar sólo un aspecto particular del proceso de renderizado global. Esto se puede utilizar como una herramienta de depuración para obtener una mejor comprensión de por qué un material se ve de la manera que lo hace.
El valor por defecto es DebugSettings.None
| Constante | Descripción |
|---|---|
DebugSettings.None | La sobreescritura del material es omitida, el renderizado ocurre normalmente. |
DebugSettings.BaseColor | El color BaseColor o Diffuse de un material se pasa sin ninguna iluminación. |
DebugSettings.Roughness | La Rugosidad de un material se transmite como un valor de escala de grises sin iluminación. |
DebugSettings.Metalness | El Metalness de un material se pasa como un valor de escala de grises sin iluminación. |
DebugSettings.Diffuse | Sólo la contribución difusa del material después de toda iluminación. |
DebugSettings.Specular | Sólo la contribución especular del material después de toda la iluminación. |
DebugSettings.ShadowOcclusion | La Oclusión causada por las sombras como un valor de escala de grises. |
DebugSettings.Emission | Sólo la contribución emisiva del material |
DebugSettings.AmbientOcclusion | Sólo la Oclusión Ambiental del material |
DebugSettings.Normals | El valor Normal interpolado en el espacio del mundo del material mapeado a un color RGB. |
DebugSettings.Tangents | El valor interpolado de la Tangente en el espacio global del material mapeado a un color RGB. Sólo será visible si se utiliza el valor Tangente. |
DebugSettings.Binormals | El valor Binormal interpolado en el espacio global del material asignado a un color RGB. Sólo será visible si se utiliza el valor Binormal. |
DebugSettings.F0 | Esto representa la Reflectancia Fresnel a 0 Grados. Sólo será visible para materiales que calculen un valor F0. |
Como ejemplo, tomemos la siguiente escena con el modelo Sponza. La escena utiliza iluminación basada en imágenes a través de SceneEnvironment::lightProbe y también tiene una luz direccional.
Ajuste DebugSettings.BaseColor:
Ajuste DebugSettings.Roughness:
Ajuste DebugSettings.Metalness:
Configuración DebugSettings.Diffuse:
Configuración DebugSettings.Specular:
Configuración DebugSettings.Normals:
Esta propiedad se introdujo en Qt 6.5.
wireframeEnabled : bool [since 6.5]
Esta propiedad cambia como se renderizan todos los materiales cambiando el modo de relleno de los polígonos a líneas en lugar de relleno. Esto aparece como un wireframe, pero el color sombreado seguirá reflejando los respectivos materiales de las mallas.
El valor por defecto es false.
Esta propiedad se introdujo en Qt 6.5.
© 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.
