DebugSettings.EnableFrameRateCounter プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フレーム レートとフレームごとの CPU 使用率情報を表示するかどうかを示す値を取得または設定します。 これらは、アプリの実行中にウィンドウ クロムのカウンターのオーバーレイとして表示されます。
public:
property bool EnableFrameRateCounter { bool get(); void set(bool value); };
bool EnableFrameRateCounter();
void EnableFrameRateCounter(bool value);
public bool EnableFrameRateCounter { get; set; }
var boolean = debugSettings.enableFrameRateCounter;
debugSettings.enableFrameRateCounter = boolean;
Public Property EnableFrameRateCounter As Boolean
プロパティ値
bool
オーバーレイ デバッグ カウンターを表示する場合は true。それ以外の場合は false。
注釈
オーバーレイ デバッグ カウンターには、2 つの数値セットがあります。 画面の左上に表示されるセットは、アプリのみに適用されます。 右上に表示されるセットはシステム全体に適用され、複合デスクトップに描画されている他のアプリも対象となります。 右側のカウンターは、一般的に Microsoft Windows の合成を処理している Microsoft DirectComposition コンポーネントから取得されます。 基本的に EnableFrameRateCounter を true に設定すると、基になるコンポーネントの IDCompositionDeviceDebug.EnableDebugCounters も呼び出されます。 その結果、XAML を使用するアプリに固有のカウンターと、すべてのアプリの Microsoft DirectComposition カウンターの両方が、UWP アプリをデバッグするときに表示されます。
ウィンドウ クロムに表示されるフレーム レート カウンターの形式は次のとおりです。
アプリの fps | アプリの CPU | … | … | Sys fps | Sys CPU |
---|---|---|---|---|---|
000 | 000 | … | … | 000 | 000 |
アプリの UI スレッド フレーム レート (1 秒あたりのフレーム数)。 | フレームあたりのアプリの UI スレッドの CPU 使用率 (ミリ秒単位)。 | … | … | システム全体のコンポジション エンジンのフレーム レート (1 秒あたりのフレーム数)。 通常、これは 60 にペギングされます。 | フレームあたりのコンポジション スレッドのシステム全体の CPU 使用率 (ミリ秒単位)。 |
App fps の値は、特に UI スレッドでレポートされます。 アプリでは、コンポジション スレッドに関連する明らかなリフレッシュレートがはるかに高くなる可能性がありますが、UI スレッドには関連しません。 各スレッドの役割の詳細については、「 パフォーマンスのベスト プラクティス 」を参照してください。
OnLaunched は、 DebugSettings 値を変更するのに適した場所です。 もう 1 つの可能性は、 App()
コンストラクターです。
以前のバージョンの注意事項
Windows 8 Windows 8では、カウンターは別の形式を使用し、Microsoft DirectComposition カウンターを組み込んでいませんでした。 その形式は次のとおりです。
000 | 000 | 000000 | 000 | 000 | 000 |
*Comp fps* | *UI fps* | *メモリ* | *バッチ* | *Comp ms* | *UI ms* |
- Comp fps: コンポジション スレッドのフレーム レート
- UI fps: UI スレッドのフレーム レート
- メモリ: テクスチャのメモリ使用率
- バッチ: グラフィックス処理装置 (GPU) に送信されるサーフェスの数
- Comp ms: コンポジション スレッドに費やされたフレームあたりの時間 (ミリ秒)
- UI ms: UI スレッドに費やされたフレームあたりの時間 (ミリ秒単位)