DebugSettings QML Type
Permet de configurer les paramètres de débogage. En savoir 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 générer de nombreuses vues différentes afin de faciliter le débogage. Ce composant sert à configurer ces vues de débogage.
Outre le contrôle par programmation, des 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 cône de 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 cône de vue de la caméra et la carte d'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 cône de projection est tracé avec des lignes de division indiquant où commencent et où finissent les cascades de la carte d'ombres.
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, un cadre de délimitation est tracé 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, un rectangle de délimitation est tracé pour chaque carte d'ombres d'une source lumineuse 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 entre les cascades de shadowmap et les objets émetteurs et récepteurs 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, un cadre de délimitation est tracé autour des objets projetant une 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, un cadre de sélection est tracé autour des 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 la manière dont tous les matériaux sont rendus 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 pourquoi un matériau présente un aspect donné.
La valeur par défaut est DebugSettings.None
| Constante | Description |
|---|---|
DebugSettings.None | Le remplacement du matériau est ignoré, le rendu s'effectue normalement. |
DebugSettings.BaseColor | La couleur de base (BaseColor) ou la couleur diffuse d’un matériau est transmise sans aucun éclairage. |
DebugSettings.Roughness | La rugosité d’un matériau est transmise sous forme de valeur en niveaux de gris non éclairée. |
DebugSettings.Metalness | La métallicité d’un matériau est transmise sous forme de valeur en niveaux de gris non éclairée. |
DebugSettings.Diffuse | Seule la contribution diffuse du matériau après l'ensemble de l'éclairage. |
DebugSettings.Specular | Seule la contribution spéculaire du matériau après l'ensemble de l'éclairage. |
DebugSettings.ShadowOcclusion | L'occlusion provoquée par les ombres, exprimée sous forme de valeur en niveaux de gris. |
DebugSettings.Emission | Uniquement la contribution émissive du matériau |
DebugSettings.AmbientOcclusion | Uniquement 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 du matériau dans l'espace mondial, mappée sur une couleur RVB. Celle-ci ne sera visible que si la valeur tangente est utilisée. |
DebugSettings.Binormals | La valeur binormale interpolée du matériau dans l'espace mondial, mappée sur une couleur RVB. Elle ne sera visible que si la valeur binormale est utilisée. |
DebugSettings.F0 | Ceci représente la réflectance de Fresnel à 0 degré. Elle ne sera visible que pour les matériaux qui calculent une valeur F0. |
Prenons par exemple la scène suivante avec le modèle Sponza. La scène utilise un éclairage basé sur des images via SceneEnvironment::lightProbe et comporte également une lumière directionnelle.
Paramètres de l’ DebugSettings.BaseColor:
Configuration d’ DebugSettings.Roughness:
Paramètres d'DebugSettings.Metalness:
Paramètres d'DebugSettings.Diffuse:
Configuration d'DebugSettings.Specular:
DebugSettings.Normals s de configuration :
Cette propriété a été introduite dans Qt 6.5.
wireframeEnabled : bool [since 6.5]
Cette propriété modifie la façon dont tous les matériaux sont rendus en remplaçant le mode de remplissage des polygones par un tracé au lieu d'un remplissage. Le résultat s'apparente à un modèle filaire, mais la couleur d'ombrage continuera de refléter les matériaux respectifs des maillages.
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.
