ドキュメント

Unity Engine

Unity Engine

レンダリングプロファイラーモジュールリファレンス

レンダリングプロファイラーモジュールのリファレンス。シーンをレンダリングするために CPU と GPU が行う処理に関するレンダリング統計と情報を表示します。
読み終わるまでの所要時間 13 分最終更新 6日前

レンダリングプロファイラーは、シーンをレンダリングするために CPU と GPU が行う処理に関するレンダリング統計と情報を表示します。これらの統計を使用して、シーンのさまざまな領域のリソース強度を測定でき、最適化に役立ちます。
プロファイラー ウィンドウを開くには、メニュー (メニュー) に移動します。ウィンドウ> 分析> プロファイラー。
チャートには、アプリケーションがレンダリングしたバッチ、セットパス呼び出し、三角形、および頂点の数が表示されます。下方のペインには、レンダリング統計がさらに表示されます。これらの統計は、ゲームビューのレンダリング統計ウィンドウに表示されているものと一致します。

The Rendering Profiler module

レンダリングプロファイラーモジュールのチャートは、以下のカテゴリに分かれています。

グラフ

説明

バッチ数フレーム中に Unity が処理したバッチの数。
SetPass Calls CountUnity がフレーム中にGameObjectsオブジェクトのレンダリングするに使用するシェーダーを切り替えた回数。シェーダーには複数のシェーダーパスが含まれている場合があり、パスごとにシーン内の GameObjects のレンダリングが異なります。
Triangles Countフレーム中に Unity が処理した三角形の数。
Vertices Count (頂点数)フレーム中に Unity が処理した頂点の数。

モジュール詳細ペイン

レンダリングプロファイラーモジュールをクリックすると、ウィンドウの下半分にある詳細ペインに詳細なレンダリング統計が表示されます。これらの統計は、レンダリング統計ウィンドウに表示される統計に似ています。
詳細ペインの左上で、「フレームデバッガーを開く」を選択してフレームデバッガーを開きます。フレームをレンダリングした個々のドローコールに関する情報が表示されます。
これらの統計は、ProfilerRecorder API とプロファイラーモジュールエディタでも取得できるため、カスタムプロファイラーモジュールに追加できます。

統計

説明

リリースプレイヤーでアクセス可能

SetPass コールUnity がフレーム中にGameObjectsオブジェクトのレンダリングするに使用するシェーダーを切り替えた回数。シェーダーには複数のシェーダーパスが含まれている場合があり、パスごとにシーン内の GameObjects のレンダリングが異なります。はい
描画呼び出しUnity がフレーム中に発行した描画コールの総数。Unity はGameObjectsオブジェクトを画面にレンダリングするときにドローコールを描画します。この数には、バッチ処理されていない描画呼び出し、動的および静的バッチ処理描画呼び出しが含まれます。はい
バッチフレーム中に Unity が処理したバッチの総数。この数には静的バッチと動的バッチの両方が含まれます。はい
三角形フレーム中に Unity が処理した三角形の数。はい
頂点Unity がフレーム中に処理した頂点の数。はい
(動的バッチ処理)このセクションでは、動的バッチ処理に関する統計を示します。いいえ
バッチ描画呼び出しUnity が動的バッチにまとめた描画呼び出しの数。いいえ
バッチUnity がフレーム中に処理した動的バッチの数。いいえ
三角形動的バッチに含まれる GameObjects の三角形の数。いいえ
頂点動的バッチに含まれる GameObjects の頂点数。いいえ
Time (期間)Unity が動的バッチ処理構造の作成に費やした時間。いいえ
(静的バッチ処理)このセクションでは、静的バッチ処理に関する統計を示します。いいえ
バッチ描画呼び出しUnity が静的バッチにまとめた描画呼び出しの数。いいえ
バッチUnity がフレーム中に処理した静的バッチの数。いいえ
三角形静的バッチに含まれる GameObjects の三角形の数。いいえ
頂点静的バッチに含まれる GameObjects の頂点数。いいえ
(インスタンス)このセクションでは、GPUインスタンシングに関する統計を示します。いいえ
バッチ描画呼び出しUnity がインスタンスのバッチに組み合わせた描画呼び出しの数。いいえ
バッチ1 フレーム中にインスタンス化された GameObjects をレンダリングするために Unity が処理したバッチの数。いいえ
三角形インスタンス化された GameObjects の三角形の数。いいえ
頂点インスタンス化された GameObjects の頂点数。いいえ
Used Textures (使用テクスチャ)Unity がフレーム中に使用したテクスチャの数と、テクスチャが使用したメモリ量。いいえ
レンダリングするテクスチャUnity がフレーム中に使用したレンダーテクスチャの数と、レンダーテクスチャが使用したメモリ量。はい
テクスチャの変更をレンダリングするUnity がフレーム中に 1 つまたは複数のレンダーテクスチャをレンダリングするターゲットとして設定した回数。はい
Used Buffers (使用済みバッファ)GPU バッファとそれらが使用したメモリの合計数。これには、頂点、インデックス、演算バッファ、およびレンダリングに必要なすべての内部バッファが含まれます。はい
フレームでの頂点バッファアップロードCPU がフレーム内で GPU にアップロードしたジオメトリの量。これは頂点/法線/テク座標データを表します。GPU にすでにジオメトリがある場合があります。この統計には、Unity がフレーム内で転送するジオメトリのみが含まれます。はい
インデックス バッファ アップロードのフレーム数CPU がフレーム内で GPU にアップロードしたジオメトリの量。これは三角形形のインデックデータを表します。GPU にすでにジオメトリがある場合があります。この統計には、Unity がフレーム内で転送するジオメトリのみが含まれます。はい
影落としの数フレーム内で影を落とす GameObjects の数。ゲームオブジェクトが複数の影を投影する場合 (複数のライトがライトを照らすため)、投影する影ごとに 1 エントリーを持ちます。はい

プレイヤーでの可用性

レンダリングモジュールのプロファイラーカウンターは、Players でも使用可能です。ProfilerRecorder API を使用して、プレイヤーでレンダリングするプロファイラーモジュール情報にアクセスします。高レベルのカウンタはリリースプレイヤーでも使用できます。
以下の例には、
SetPass Calls Count
、
Draw Calls Count
、
Vertices Count
メトリクスを収集し、それらを TextArea として表示する簡単なスクリプトが含まれています。
using System.Text;using Unity.Profiling;using UnityEngine; public class RenderStatsScript :MonoBehaviour{ string statsText; ProfilerRecorder setPassCallsRecorder; ProfilerRecorder drawCallsRecorder; ProfilerRecorder verticesRecorder; void OnEnable() { setPassCallsRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Render, "SetPass Calls Count"); drawCallsRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Render, "Draw Calls Count"); verticesRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Render, "Vertices Count"); } void OnDisable() { setPassCallsRecorder.Dispose(); drawCallsRecorder.Dispose(); verticesRecorder.Dispose(); } void Update() { var sb = new StringBuilder(500); if (setPassCallsRecorder.Valid) sb.AppendLine($"SetPass Calls: {setPassCallsRecorder.LastValue}"); if (drawCallsRecorder.Valid) sb.AppendLine($"Draw Calls: {drawCallsRecorder.LastValue}"); if (verticesRecorder.Valid) sb.AppendLine($"Vertices: {verticesRecorder.LastValue}"); statsText = sb.ToString(); } void OnGUI() { GUI.TextArea(new Rect(10, 30, 250, 50), statsText); }}
レンダリングプロファイラーモジュールの情報は、ProfilerCategory.レンダリングするプロファイラーカテゴリに属します。
カスタムモジュールで選択したレンダリングカウンターを強調表示する場合は、モジュールエディタを使用してチャートと詳細ビューを設定します。

追加リソース