DebugSettings QML Type
Utilisé pour configurer les paramètres de débogage. Plus...
| Import Statement: | import QtQuick3D |
| Inherits: |
Propriétés
- 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)
Description détaillée
Le moteur de rendu peut être configuré pour produire de nombreuses vues différentes afin de faciliter le débogage. Ce composant est utilisé pour configurer ces vues de débogage.
Outre le contrôle programmatique, les propriétés telles que materialOverride et wireframeEnabled peuvent également être contrôlées de manière interactive via l'élément DebugView si une instance de celui-ci est ajoutée à la scène Qt Quick par l'application.
Documentation sur les propriétés
disableShadowCameraUpdate : bool [since 6.8]
Lorsque cette propriété est activée, la mise à jour de la caméra est désactivée pour la carte d'ombres. Cela signifie que le frustum de la vue sera verrouillé dans l'espace uniquement pour les calculs de la carte d'ombres. Il s'agit simplement d'un outil de débogage permettant de visualiser le frustum de la caméra et la carte des ombres sous différents angles.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.8.
drawCascades : bool [since 6.8]
Lorsque cette propriété est activée, un tronc commun est dessiné avec des divisions indiquant où les cascades de la carte d'ombres commencent et se terminent.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.8.
drawDirectionalLightShadowBoxes : bool [since 6.8]
Lorsque cette propriété est activée, une boîte de délimitation est dessinée pour chaque shadowmap de lumière directionnelle.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.8.
drawPointLightShadowBoxes : bool [since 6.9]
Lorsque cette propriété est activée, une boîte de délimitation est dessinée pour la carte d'ombres de chaque lumière ponctuelle.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.9.
drawSceneCascadeIntersection : bool [since 6.8]
Lorsque cette propriété est activée, l'intersection des cascades de la carte d'ombres et des objets de projection et de réception de la scène est dessinée.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.8.
drawShadowCastingBounds : bool [since 6.8]
Lorsque cette propriété est activée, une boîte de délimitation est dessinée pour les objets qui projettent l'ombre.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.8.
drawShadowReceivingBounds : bool [since 6.8]
Lorsque cette propriété est activée, une boîte de délimitation est dessinée pour les objets recevant l'ombre.
La valeur par défaut est false.
Cette propriété a été introduite dans Qt 6.8.
materialOverride : enumeration [since 6.5]
Cette propriété modifie le rendu de tous les matériaux afin de ne refléter qu'un aspect particulier du processus de rendu global. Elle peut être utilisée comme outil de débogage pour mieux comprendre l'aspect d'un matériau.
La valeur par défaut est DebugSettings.None
| Constante | Description |
|---|---|
DebugSettings.None | La surcharge du matériau est contournée, le rendu s'effectue normalement. |
DebugSettings.BaseColor | La couleur de base ou la couleur diffuse d'un matériau est transmise sans éclairage. |
DebugSettings.Roughness | La rugosité d'un matériau est transmise sous la forme d'une valeur en niveaux de gris non éclairée. |
DebugSettings.Metalness | L'aspect métallique d'un matériau est transmis sous la forme d'une valeur en niveaux de gris non éclairée. |
DebugSettings.Diffuse | Seule la contribution diffuse du matériau après tout éclairage. |
DebugSettings.Specular | Seule la contribution spéculaire du matériau après tous les éclairages. |
DebugSettings.ShadowOcclusion | L'occlusion causée par les ombres est transmise sous la forme d'une valeur en niveaux de gris. |
DebugSettings.Emission | Uniquement la contribution émissive du matériau |
DebugSettings.AmbientOcclusion | Seulement l'occlusion ambiante du matériau. |
DebugSettings.Normals | La valeur normale interpolée du matériau dans l'espace mondial, mappée sur une couleur RVB. |
DebugSettings.Tangents | La valeur tangente interpolée de l'espace mondial du matériau, associée à une couleur RVB. Cette valeur ne sera visible que si la valeur de tangente est utilisée. |
DebugSettings.Binormals | La valeur binormale interpolée dans l'espace mondial du matériau correspondant à une couleur RVB. Cette valeur ne sera visible que si la valeur Binormale est utilisée. |
DebugSettings.F0 | Cette valeur représente la réflectance de Fresnel à 0 degré. Elle ne sera visible que pour les matériaux qui calculent une valeur F0. |
Prenons l'exemple de la scène suivante avec le modèle Sponza. La scène utilise un éclairage basé sur l'image via SceneEnvironment::lightProbe et dispose également d'une lumière directionnelle.
Paramètre DebugSettings.BaseColor:
Réglage DebugSettings.Roughness:
Réglage DebugSettings.Metalness:
Réglage DebugSettings.Diffuse:
Réglage DebugSettings.Specular:
Paramétrage DebugSettings.Normals:
Cette propriété a été introduite dans Qt 6.5.
wireframeEnabled : bool [since 6.5]
Cette propriété modifie le rendu de tous les matériaux en changeant le mode de remplissage des polygones pour qu'ils soient des lignes au lieu d'être remplis. Cela se traduit par une image filaire, mais les couleurs ombrées reflètent toujours les matériaux respectifs des mailles.
La valeur par défaut est false.
Cette propriété a été introduite dans 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.
