コンソール スレート デバッガ

アプリケーションのユーザー インターフェース (UI) の開発時に、スレートをデバッグする必要が生じる場合があります。このようなときに UI デベロッパーを支援するのが コンソール スレート デバッガ です。コンソール スレート デバッガでは、FSlateDebugging で利用可能なシステムに接続し、内部のスレート データをプリントします。さらに、デベロッパーは、UI フォーカスの変更 (またはその試行) に伴って、フォーカスの更新をどのシステムが処理しているかを知る必要があります。

コンソール スレート デバッガ

コンソール スレート デバッガの拡張機能に次のものが含まれています。

• 高負荷なフレームの原因となっているウィジェットを特定する際に役立つ GlobalInvalidation。
• 特定のフレームにペイントされたウィジェットを表示するペイント オプション。
• システムでどのようにウィジェットがイベント ハンドラとして選択されたかを示す、追加のルーティング オプション。
• 追加のフィルタとイベント コンソール コマンド。

このページのスクリーンショットは、Lyra Sample Game プロジェクトから引用しています。Lyra で SlateDebugger のコマンドをテストするには、デフォルトでは有効になっていないので、Slate.EnableGlobalInvalidation 1 コマンドを使って Global Invalidation を有効にしてください。

SlateDebugger

プロジェクトを PIE モードで実行しているときに、チルダ (~) キーを押して PIE コンソールを開き、「SlateDebugger」と入力します。

通常、SlateDebugger のログ内容は、「[ProjectName]/Saved/Logs」にある「[ProjectName].txt」ログ ファイルに記録されます。

Event (イベント) コマンド

スレート デバッガには、特定のログの有効化/無効化やイベントのフィルタリングなど、特定の情報を見つけるためのさまざまなコマンドが用意されています。さらに詳細が必要な場合は、CaptureStack を使って、トリガーされたイベントのコール スタックを取得することもできます。

Invalidate (無効化) コマンド

これらのコマンドでは、Invalidate コマンドを使って画面上の無効化されたウィジェットを示すことができます。無効化されたウィジェットは、無効のタイプに応じて、それぞれ別の色でハイライトされます。

SlateDebugger.Invalidate は、無効化処理中の各ウィジェットの状態を表示します。

Paint (ペイント) コマンド

このコマンドでは、各フレームにペイントされるウィジェットをハイライトします。変更がないにもかかわらずペイントされるウィジェットを特定する際に便利です。Volatile ウィジェットは各フレームにペイントされる点に注意してください。

SlateDebugger.Paint は、どのウィジェットが画面上に再描画されているかを表示します。

Update (更新) コマンド

このコマンドでは、必要以上に頻繁に更新されているウィジェットをハイライトします。Widget Update はブループリント内でオバーライドまたは実行可能であるため、ウィジェットのコードが正しく作成されていない場合に、低パフォーマンスの原因となることがよくあります。

SlateDebugger.Update は、どのウィジェットが更新されているかを色分けして表示します。この画像は、黄色を使用するリペイント イベントのみをフィルタリングするように設定されています。