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 se puede configurar para generar muchas vistas diferentes con el fin de facilitar la depuración. Este componente se utiliza para configurar estas vistas de depuración.
Además del control mediante programación, propiedades como « materialOverride » y « wireframeEnabled » también pueden controlarse de forma interactiva 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, se desactiva la actualización de la cámara para el mapa de sombras. Esto significa que el frustum de visión quedará fijado en el espacio únicamente para los cálculos del mapa de sombras. Se trata simplemente de una herramienta de depuración que permite visualizar 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 líneas de división que indican dónde comienzan y terminan las cascadas del mapa de sombras.
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 rectángulo delimitador para el mapa de sombras de cada 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 rectángulo delimitador para el mapa de sombras de cada luz puntual.
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 entre las cascadas del mapa de sombras 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 un rectángulo delimitador 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 un rectángulo delimitador para los objetos que reciben la sombra.
El valor por defecto es « false ».
Esta propiedad se introdujo en Qt 6.8.
materialOverride : enumeration [since 6.5]
Esta propiedad modifica la forma en que se representan todos los materiales para que solo reflejen un aspecto concreto del proceso de representación global. Se puede utilizar como herramienta de depuración para comprender mejor por qué un material tiene el aspecto que tiene.
El valor por defecto es DebugSettings.None
| Constante | Descripción |
|---|---|
DebugSettings.None | Se omite la anulación del material y el renderizado se realiza con normalidad. |
DebugSettings.BaseColor | El color base (BaseColor) o el color difuso de un material se transmite sin ningún tipo de iluminación. |
DebugSettings.Roughness | La rugosidad de un material se transmite como un valor en escala de grises sin iluminación. |
DebugSettings.Metalness | La metalicidad de un material se transmite como un valor en escala de grises sin iluminación. |
DebugSettings.Diffuse | Solo la contribución difusa del material tras toda la iluminación. |
DebugSettings.Specular | Solo la contribución especular del material tras toda la iluminación. |
DebugSettings.ShadowOcclusion | La oclusión causada por las sombras como valor en escala de grises. |
DebugSettings.Emission | Solo la contribución emisiva del material |
DebugSettings.AmbientOcclusion | Solo la oclusión ambiental del material |
DebugSettings.Normals | El valor normal del material en el espacio mundial interpolado, mapeado a un color RGB. |
DebugSettings.Tangents | El valor tangente interpolado en el espacio mundial del material, mapeado a un color RGB. Esto solo será visible si se utiliza el valor tangente. |
DebugSettings.Binormals | El valor binormal interpolado en el espacio mundial del material, mapeado a un color RGB. Solo será visible si se utiliza el valor binormal. |
DebugSettings.F0 | Esto representa la reflectancia de Fresnel a 0 grados. Solo será visible para los materiales que calculen un valor F0. |
A modo de 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 cuenta con una luz direccional.

Configuración de « DebugSettings.BaseColor »:

Configuración de « DebugSettings.Roughness »:

Configuración de « DebugSettings.Metalness »:

Configuración de « DebugSettings.Diffuse »:

Configuración de « DebugSettings.Specular »:

Configuración de DebugSettings.Normals:

Esta propiedad se introdujo en Qt 6.5.
wireframeEnabled : bool [since 6.5]
Esta propiedad modifica la forma en que se representan todos los materiales, cambiando el modo de relleno de los polígonos para que aparezcan como líneas en lugar de rellenos. El resultado es una representación de alambre, pero el color del sombreado seguirá reflejando los materiales respectivos 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.