En esta página

DebugSettings QML Type

Se utiliza para configurar los ajustes de depuración. Más...

Import Statement: import QtQuick3D
Inherits:

QtObject

Propiedades

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

ConstanteDescripción
DebugSettings.NoneSe omite la anulación del material y el renderizado se realiza con normalidad.
DebugSettings.BaseColorEl color base (BaseColor) o el color difuso de un material se transmite sin ningún tipo de iluminación.
DebugSettings.RoughnessLa rugosidad de un material se transmite como un valor en escala de grises sin iluminación.
DebugSettings.MetalnessLa metalicidad de un material se transmite como un valor en escala de grises sin iluminación.
DebugSettings.DiffuseSolo la contribución difusa del material tras toda la iluminación.
DebugSettings.SpecularSolo la contribución especular del material tras toda la iluminación.
DebugSettings.ShadowOcclusionLa oclusión causada por las sombras como valor en escala de grises.
DebugSettings.EmissionSolo la contribución emisiva del material
DebugSettings.AmbientOcclusionSolo la oclusión ambiental del material
DebugSettings.NormalsEl valor normal del material en el espacio mundial interpolado, mapeado a un color RGB.
DebugSettings.TangentsEl 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.BinormalsEl valor binormal interpolado en el espacio mundial del material, mapeado a un color RGB. Solo será visible si se utiliza el valor binormal.
DebugSettings.F0Esto 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.

Escena con la configuración de depuración predeterminada

Configuración de « DebugSettings.BaseColor »:

Escena en la que se muestran los colores de base sin iluminación

Configuración de « DebugSettings.Roughness »:

Escena en la que se muestran los valores de rugosidad

Configuración de « DebugSettings.Metalness »:

Escena en la que se resaltan los valores de «metalness»

Configuración de « DebugSettings.Diffuse »:

Escena en la que solo hay iluminación difusa

Configuración de « DebugSettings.Specular »:

Escena en la que solo se muestra la iluminación especular

Configuración de DebugSettings.Normals:

Escena en la que los vectores normales se representan con colores

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 ».

Escena que muestra un renderizado de estructura alámbrica

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.