DebugSettings QML Type
用于配置调试设置。更多
| Import Statement: | import QtQuick3D |
| Inherits: |
属性
- 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)
详细说明
可以将呈现器配置为输出许多不同的视图，以方便调试。该组件用于配置这些调试视图。
除了程序控制外，如果应用程序将materialOverride 和wireframeEnabled 的实例添加到Qt Quick 场景中，还可以通过DebugView 项目交互式地控制这些属性。
属性文档
disableShadowCameraUpdate : bool |
启用此属性后，阴影贴图的相机更新将被禁用。这意味着视图圆锥体将被锁定在空间中，仅用于阴影贴图计算。这只是一个调试工具，可以从不同角度查看摄像机和阴影贴图。
默认值为false 。
此属性在 Qt 6.8 中引入。
drawCascades : bool |
启用该属性后，将绘制一个带有分叉的 frustum，指示阴影贴图级联的开始和结束位置。
默认值为false 。
此属性在 Qt 6.8 中引入。
drawDirectionalLightShadowBoxes : bool |
启用该属性后，将为每个方向光的阴影贴图绘制一个边界框。
默认值为false 。
此属性在 Qt 6.8 中引入。
drawPointLightShadowBoxes : bool |
启用该属性后，将为每个点光源的阴影贴图绘制一个边界框。
默认值为false 。
此属性在 Qt 6.9 中引入。
drawSceneCascadeIntersection : bool |
启用此属性后，将绘制场景中阴影贴图级联与投射和接收对象的交点。
默认值为false 。
此属性在 Qt 6.8 中引入。
drawShadowCastingBounds : bool |
启用该属性后，将为阴影投射对象绘制一个边界框。
默认值为false 。
此属性在 Qt 6.8 中引入。
drawShadowReceivingBounds : bool |
启用此属性后，将为阴影接收对象绘制一个边界框。
默认值为false 。
此属性在 Qt 6.8 中引入。
materialOverride : enumeration |
该属性可更改所有材质的渲染方式，使其仅反映整个渲染过程的一个特定方面。该属性可用作调试工具，以便更好地了解材质外观的原因。
默认值为DebugSettings.None
| 常量 | 说明 |
|---|---|
DebugSettings.None | 绕过材质重载，按正常方式进行渲染。 |
DebugSettings.BaseColor | 材质的基色或漫反射颜色在没有任何光照的情况下通过。 |
DebugSettings.Roughness | 材质的粗糙度会以无光照灰度值的形式显示。 |
DebugSettings.Metalness | 材料的金属度以未照明灰度值的形式显示。 |
DebugSettings.Diffuse | 在所有照明后只显示材质的漫反射效果。 |
DebugSettings.Specular | 所有光照后只显示材质的镜面反射。 |
DebugSettings.ShadowOcclusion | 阴影造成的遮挡（灰度值）。 |
DebugSettings.Emission | 只显示材质的发射效果 |
DebugSettings.AmbientOcclusion | 仅材质的环境光遮挡 |
DebugSettings.Normals | 材质的世界空间法线内插值（映射为 RGB 颜色）。 |
DebugSettings.Tangents | 材质的世界空间切线内插值（映射为 RGB 颜色）。只有使用切线值时才会显示。 |
DebugSettings.Binormals | 映射为 RGB 颜色的材质的世界空间 Binormal 值。只有使用 Binormal 值时才会显示。 |
DebugSettings.F0 | 这表示 0 度时的菲涅尔反射率。只有计算 F0 值的材质才会显示。 |
下面以Sponza模型场景为例。该场景通过SceneEnvironment::lightProbe 使用基于图像的照明，同时还使用了定向光。
设置DebugSettings.BaseColor ：
设置DebugSettings.Roughness ：
设置DebugSettings.Metalness ：
设置DebugSettings.Diffuse ：
设置DebugSettings.Specular ：
设置DebugSettings.Normals ：
此属性在 Qt 6.5 中引入。
wireframeEnabled : bool |
该属性通过将多边形填充模式更改为线条而非填充，改变了所有材质的渲染方式。这将显示为线框，但阴影颜色仍将反映网格各自的材质。
默认值为false 。
此属性在 Qt 6.5 中引入。
© 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.
