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) - 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.
Eigenschaft Dokumentation
disableShadowCameraUpdate : bool |
Wenn diese Eigenschaft aktiviert ist, ist die Kameraaktualisierung für die Shadowmap deaktiviert. Dies bedeutet, dass der Ansichtskegel im Raum nur für die Shadowmap-Berechnungen gesperrt 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 |
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 |
Wenn diese Eigenschaft aktiviert ist, wird ein Begrenzungsrahmen für jede Schattenkarte eines gerichteten Lichts gezeichnet.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawSceneCascadeIntersection : bool |
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 |
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 |
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 |
Diese Eigenschaft ändert die Art und Weise, wie alle Materialien gerendert werden, um nur einen bestimmten Aspekt des gesamten Rendering-Prozesses zu reflektieren. 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 |
Diese Eigenschaft ändert die Art und Weise, wie alle Materialien gerendert werden, indem sie den Polygon-Füllmodus auf Linien anstelle von Füllungen ändert. Dies erscheint als Drahtgitter, aber die schattierte Farbe spiegelt immer noch die jeweiligen Materialien der Meshes wider.
Der Standardwert ist false.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
© 2025 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.
