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 dient zur Konfiguration dieser Debug-Ansichten.
Zusätzlich zur programmatischen Steuerung können Eigenschaften wie „ materialOverride “ und „ wireframeEnabled “ auch interaktiv über das Element „ DebugView “ gesteuert werden, sofern eine Instanz davon von der Anwendung zur Szene „ Qt Quick “ hinzugefügt wurde.
Dokumentation zu den Eigenschaften
disableShadowCameraUpdate : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird die Kameraaktualisierung für die Schattenkarte deaktiviert. Das bedeutet, dass der Sichtkegel ausschließlich für die Berechnungen der Schattenkarte im Raum fixiert wird. Hierbei handelt es sich lediglich um ein Debugging-Tool, mit dem sich der Kamerasichtkegel und die Schattenkarte aus verschiedenen Blickwinkeln betrachten lassen.
Der Standardwert lautet „ false “.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawCascades : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird ein Sichtkegel gezeichnet, dessen Unterteilungen anzeigen, wo die Schattenkartenkaskaden beginnen und enden.
Der Standardwert lautet „ false “.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawDirectionalLightShadowBoxes : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird für die Schattenkarte jedes Richtungslichts ein Begrenzungsrahmen gezeichnet.
Der Standardwert lautet „ 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 jeder Punktlichtquelle ein Begrenzungsrahmen gezeichnet.
Der Standardwert lautet „ false “.
Diese Eigenschaft wurde in Qt 6.9 eingeführt.
drawSceneCascadeIntersection : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird die Schnittmenge der Shadowmap-Kaskaden mit den Schatten werfenden und empfangenden Objekten 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 für die Objekte, die Schatten werfen, ein Begrenzungsrahmen gezeichnet.
Der Standardwert lautet „ false “.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
drawShadowReceivingBounds : bool [since 6.8]
Wenn diese Eigenschaft aktiviert ist, wird für die Objekte, auf die der Schatten fällt, ein Begrenzungsrahmen gezeichnet.
Der Standardwert ist „ false “.
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
materialOverride : enumeration [since 6.5]
Diese Eigenschaft verändert die Darstellung aller Materialien, sodass nur ein bestimmter Aspekt des gesamten Rendering-Prozesses widergespiegelt wird. Dies kann als Debugging-Tool genutzt werden, um besser zu verstehen, warum ein Material so aussieht, wie es aussieht.
Der Standardwert lautet DebugSettings.None
| Konstant | Beschreibung |
|---|---|
DebugSettings.None | Die Materialüberschreibung wird umgangen, das Rendering erfolgt wie gewohnt. |
DebugSettings.BaseColor | Die BaseColor oder die Diffuse-Farbe eines Materials wird ohne jegliche Beleuchtung weitergeleitet. |
DebugSettings.Roughness | Die Rauheit eines Materials wird als nicht beleuchteter Graustufenwert durchgelassen. |
DebugSettings.Metalness | Die „Metalness“ eines Materials wird als unbeleuchteter Graustufenwert durchgelassen. |
DebugSettings.Diffuse | Nur der diffuse Beitrag des Materials nach der gesamten Beleuchtung. |
DebugSettings.Specular | Nur der spiegelnde Beitrag des Materials nach der gesamten Beleuchtung. |
DebugSettings.ShadowOcclusion | Die durch Schatten verursachte Okklusion als Graustufenwert. |
DebugSettings.Emission | Nur der emissive Beitrag des Materials |
DebugSettings.AmbientOcclusion | Nur die Umgebungsokklusion des Materials |
DebugSettings.Normals | Der interpolierte Normalwert des Materials im Weltraum, abgebildet auf eine RGB-Farbe. |
DebugSettings.Tangents | Der interpolierte Welt-Tangentenwert des Materials, abgebildet auf eine RGB-Farbe. Dieser ist nur sichtbar, wenn der Tangentenwert verwendet wird. |
DebugSettings.Binormals | Der interpolierte Binormalwert des Materials im Weltraum, abgebildet auf eine RGB-Farbe. Dies ist nur sichtbar, wenn der Binormalwert verwendet wird. |
DebugSettings.F0 | Dies stellt die Fresnel-Reflexion bei 0 Grad dar. Dies 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 verfügt außerdem über ein gerichtetes Licht.
Einstellung von „ DebugSettings.BaseColor “:
Einstellung von „ DebugSettings.Roughness “:
Einstellung von „ DebugSettings.Metalness “:
Einstellung von „ DebugSettings.Diffuse “:
Einstellung von „ DebugSettings.Specular “:
Einstellung „ DebugSettings.Normals “:
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
wireframeEnabled : bool [since 6.5]
Diese Eigenschaft verändert die Darstellung aller Materialien, indem der Polygon-Füllmodus von „gefüllt“ auf „Linien“ umgestellt wird. Dies erscheint als Drahtgitterdarstellung, wobei die Schattierungsfarbe jedoch weiterhin die jeweiligen Materialien der Meshes widerspiegelt.
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.
