DebugSettings QML Type
Dient zur Konfiguration der Debug-Einstellungen. Mehr...
| Import Statement: | import QtQuick3D |
| Inherits: |
Eigenschaften
- 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)
Ausführliche Beschreibung
Der Renderer kann so konfiguriert werden, dass er viele verschiedene Ansichten ausgibt, um die Fehlersuche zu erleichtern. Diese Komponente wird verwendet, um diese Debug-Ansichten zu konfigurieren.
Neben der programmatischen Steuerung können Eigenschaften wie materialOverride und wireframeEnabled auch interaktiv über das Element DebugView gesteuert werden, wenn eine Instanz davon von der Anwendung zur Szene Qt Quick hinzugefügt wird.
Dokumentation der Eigenschaften
disableShadowCameraUpdate : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird die Kameraaktualisierung für die Shadowmap deaktiviert. Das bedeutet, dass der Ansichts-Sternpunkt nur für die Shadowmap-Berechnungen im Raum fixiert wird. Dies ist nur ein Debug-Tool, um den Kamerastumpf und die Shadowmap aus verschiedenen Blickwinkeln betrachten zu können.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawCascades : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird ein Kegelstumpf mit Unterteilungen gezeichnet, die anzeigen, wo die Shadowmap-Kaskaden beginnen und enden.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawDirectionalLightShadowBoxes : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird ein Begrenzungsrahmen für die Schattenkarte jedes Richtungslichts gezeichnet.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawPointLightShadowBoxes : bool [since 6.9]
Wenn diese Eigenschaft aktiviert ist, wird für die Shadowmap jedes Punktlichts ein Begrenzungsrahmen gezeichnet.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.9 eingeführt.
drawSceneCascadeIntersection : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird der Schnittpunkt der Shadowmap-Kaskaden und der sendenden und empfangenden Objekte der Szene gezeichnet.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawShadowCastingBounds : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird ein Begrenzungsrahmen für die schattenwerfenden Objekte gezeichnet.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawShadowReceivingBounds : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird ein Begrenzungsrahmen für die schattenempfangenden Objekte gezeichnet.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
materialOverride : enumeration [since 6.5]
Mit dieser Eigenschaft wird das Rendering aller Materialien so verändert, dass nur ein bestimmter Aspekt des gesamten Rendering-Prozesses wiedergegeben wird. Dies kann als Debugging-Tool verwendet werden, um ein besseres Verständnis dafür zu bekommen, warum ein Material so aussieht, wie es aussieht.
Der Standardwert ist DebugSettings.None
| Konstante | Beschreibung |
|---|---|
DebugSettings.None | Das Material-Overriding wird umgangen, das Rendering erfolgt wie gewohnt. |
DebugSettings.BaseColor | Die BaseColor oder Diffuse Farbe eines Materials wird ohne Beleuchtung durchgereicht. |
DebugSettings.Roughness | Die Roughness eines Materials wird als unbeleuchteter Graustufenwert durchgereicht. |
DebugSettings.Metalness | Die Metalness eines Materials wird als unbeleuchteter Graustufenwert durchgereicht. |
DebugSettings.Diffuse | Nur der diffuse Beitrag des Materials nach aller Beleuchtung. |
DebugSettings.Specular | Nur der spiegelnde Beitrag des Materials nach allen Beleuchtungen. |
DebugSettings.ShadowOcclusion | Die durch Schatten verursachte Okklusion als Graustufenwert. |
DebugSettings.Emission | Nur der emittierende Beitrag des Materials |
DebugSettings.AmbientOcclusion | Nur die Ambient Occlusion des Materials |
DebugSettings.Normals | Der interpolierte Weltraum-Normalwert des Materials, der auf eine RGB-Farbe abgebildet wird. |
DebugSettings.Tangents | Der interpolierte Weltraum-Tangentenwert des Materials, der auf eine RGB-Farbe abgebildet wird. Dies ist nur sichtbar, wenn der Tangentenwert verwendet wird. |
DebugSettings.Binormals | Der interpolierte Weltraum-Binormalwert des Materials, der auf eine RGB-Farbe abgebildet wird. Dieser Wert ist nur sichtbar, wenn der Binormal-Wert verwendet wird. |
DebugSettings.F0 | Dies stellt den Fresnel-Reflexionsgrad bei 0 Grad dar. Dieser Wert ist nur bei Materialien sichtbar, die einen F0-Wert berechnen. |
Nehmen wir als Beispiel die folgende Szene mit dem Sponza-Modell. Die Szene verwendet bildbasierte Beleuchtung über SceneEnvironment::lightProbe und hat auch ein gerichtetes Licht.
Einstellung DebugSettings.BaseColor:
Einstellung DebugSettings.Roughness:
Einstellung DebugSettings.Metalness:
Einstellung DebugSettings.Diffuse:
Einstellung DebugSettings.Specular:
Einstellung DebugSettings.Normals:
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
wireframeEnabled : bool [since 6.5]
Diese Eigenschaft ändert die Art und Weise, wie alle Materialien gerendert werden, indem der Polygonfüllmodus auf Linien statt auf Füllungen umgestellt wird. Dies erscheint wie ein Drahtgitter, aber die schattierte Farbe spiegelt immer noch die jeweiligen Materialien der Maschen wider.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
© 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.
