このページでは

DebugSettings QML Type

デバッグ設定を行う。詳細...

Import Statement: import QtQuick3D
Inherits:

QtObject

プロパティ

詳細説明

レンダラーは、デバッグを容易にするために多くの異なるビューを出力するように設定することができます。このコンポーネントは、これらのデバッグ ビューを設定するために使用します。

プログラムによる制御だけでなく、materialOverridewireframeEnabled などのプロパティも、アプリケーションによってそのインスタンスがQt Quick シーンに追加された場合、DebugView アイテム経由でインタラクティブに制御できます。

プロパティのドキュメント

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

一定です。説明
DebugSettings.Noneマテリアルのオーバーライドはバイパスされ、レンダリングは通常どおり行われます。
DebugSettings.BaseColorマテリアルのベースカラーまたはディフューズカラーは、ライティングなしで通過します。
DebugSettings.RoughnessマテリアルのRoughnessはライティングなしのグレースケール値として渡されます。
DebugSettings.Metalnessマテリアルの Metalness はライティングされていないグレースケール値として渡されます。
DebugSettings.Diffuseすべてのライティング後のマテリアルのディフューズ寄与のみ。
DebugSettings.Specularすべてのライティング後のマテリアルのスペキュラ寄与のみ。
DebugSettings.ShadowOcclusionシャドウによるオクルージョンをグレースケール値として渡す。
DebugSettings.Emissionマテリアルの放射寄与のみ。
DebugSettings.AmbientOcclusionマテリアルのアンビエントオクルージョンのみ。
DebugSettings.NormalsRGBカラーにマッピングされたマテリアルの補間されたワールド空間の法線値。
DebugSettings.TangentsRGBカラーにマッピングされたマテリアルのワールド空間のタンジェント値。Tangent 値を使用した場合のみ表示されます。
DebugSettings.BinormalsRGBカラーにマッピングされたマテリアルの、補間されたワールド空間のBinormal値。Binormal値が使用されている場合のみ表示されます。
DebugSettings.F00 度でのフレネル反射率を表します。F0値を計算するマテリアルでのみ表示されます。

例として、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 で導入されました。

© 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.