DebugSettings QML Type

用于配置调试设置。更多...

• 所有成员的列表，包括继承的成员

属性

• 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)

详细说明

渲染器可配置为输出多种不同的视图，以方便调试。此组件用于配置这些调试视图。

除了通过编程方式控制外，如果应用程序将该组件的实例添加到Qt Quick 场景中，还可以通过“DebugView ”项交互式地控制materialOverride 和wireframeEnabled 等属性。

属性文档

disableShadowCameraUpdate : bool [since 6.8]

启用此属性后，将禁用阴影贴图的相机更新。这意味着仅在进行阴影贴图计算时，视锥体将在空间中被锁定。这仅是一个调试工具，用于从不同角度查看相机视锥体和阴影贴图。

默认值为false 。

该属性于 Qt 6.8 中引入。

drawCascades : bool [since 6.8]

启用此属性后，将绘制一个锥体，其中包含标明阴影贴图级联起始和结束位置的分割线。

默认值为false 。

该属性在 Qt 6.8 中引入。

drawDirectionalLightShadowBoxes : bool [since 6.8]

启用此属性后，将为每个定向光的阴影贴图绘制一个边界框。

默认值为false 。

该属性自 Qt 6.8 起引入。

drawPointLightShadowBoxes : bool [since 6.9]

启用此属性后，系统会为每个点光源的阴影贴图绘制一个边界框。

默认值为false 。

该属性在 Qt 6.9 中引入。

drawSceneCascadeIntersection : bool [since 6.8]

启用此属性后，将绘制阴影贴图级联与场景中投射对象和接收对象之间的交集。

默认值为false 。

该属性在 Qt 6.8 中引入。

drawShadowCastingBounds : bool [since 6.8]

启用此属性后，系统会为投射阴影的对象绘制一个边界框。

默认值为false 。

该属性自 Qt 6.8 起引入。

drawShadowReceivingBounds : bool [since 6.8]

启用此属性后，系统会为接收阴影的对象绘制一个边界框。

默认值为false 。

该属性自 Qt 6.8 起引入。

materialOverride : enumeration [since 6.5]

此属性会更改所有材质的渲染方式，使其仅反映整体渲染过程中的某个特定方面。这可作为调试工具，帮助您更好地理解材质为何呈现出当前的外观。

默认值为DebugSettings.None

以包含Sponza模型的以下场景为例。该场景通过“SceneEnvironment::lightProbe ”使用基于图像的照明，并包含一盏定向光。

设置“DebugSettings.BaseColor ”：

DebugSettings.Roughness 的设置：

DebugSettings.Metalness 的设置：

DebugSettings.Diffuse 的设置：

DebugSettings.Specular 的设置：

DebugSettings.Normals 的设置：

该属性在 Qt 6.5 中引入。

wireframeEnabled : bool [since 6.5]

此属性通过将多边形填充模式从“填充”改为“线条”来改变所有材质的渲染方式。这会呈现为线框效果，但阴影颜色仍会反映网格各自的材质。

默认值为false 。

该属性自 Qt 6.5 起引入。