Rendering Profiler モジュール

Rendering Profiler (レンダリングプロファイラー) は、シーンをレンダリングするために CPU と GPU が行う処理に関する統計や情報を表示します。これらの統計情報を利用して、シーンのさまざまな領域のリソース強度を測定し、最適化に役立てることができます。

チャートには、アプリケーションがレンダリングしたバッチ (Batches Count)、SetPass Calls、三角形の数 (Triangles Calls)、頂点数 (Vertices Counts) が表示されます。下のペインには、より多くのレンダリング統計 (ゲームビューの 統計ウィンドウ ウィンドウに表示されているものと同等) が表示されます。

Rendering Profiler モジュールのチャートは、以下の 4 つのカテゴリに分かれています。

モジュールの詳細ペイン

When you click on the Rendering Profiler module, the details pane in the lower half of the window displays detailed rendering statistics. These statistics are similar to the statistics shown in the Rendering Statistics window.

詳細ペインの左上の Open Frame Debugger を選択すると、フレームデバッガー が開き、フレームをレンダリングした個々のドローコールの情報が表示されます。

これらの統計情報は、ProfilerRecorder API や Profiler Module Editor でも入手可能で、カスタム製のProfiler モジュールに追加することができます。

プレイヤーの可用性

Rendering モジュールのプロファイラーカウンターは、プレイヤーでも利用可能です。プレイヤーで Rendering Profiler モジュールの情報にアクセスするには、ProfilerRecorder API を使用します。高レベルのカウンターは、Release Player でも利用できます。

以下の例は、“SetPass Calls Count”、 “Draw Calls Count”、 “Vertices Count” の指標を収集し、それらをテキストエリアとして表示する簡単なスクリプトです。

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);
    }
}

Rendering Profiler モジュールの情報は、ProfilerCategory.Render Profiler のカテゴリに属しています。

カスタムモジュールで選択したレンダリングカウンターを強調表示したい場合は、Module Editor を使用して、チャートと詳細表示を設定します。