ドキュメント

Unity Engine

Unity Engine

RenderDoc インテグレーション

RenderDoc デバッガーを使用して、フレーム単位でグラフィックスをデバッグします。
読み終わるまでの所要時間 8 分最終更新 6日前

エディターでは、詳細なフレームイントロスペクションとデバッグのために、RenderDoc グラフィックスデバッガの統合起動とキャプチャをサポートしています。
インテグレーションは RenderDoc 0.26 以降のバージョンでのみサポートされているため、 以前のバージョンが現在インストールされている場合は、 0.26 以上に更新する必要があります 。
注
インテグレーションはエディターでのみ可能ですが、スタンドアロンプレイヤービルドで余分な設定なしで RenderDoc を法線として使用できます。
注
フレームは、RenderDoc がサポートするプラットフォームと API で Unity が実行されている場合にのみキャプチャできます。別の API が使用されている場合、サポートされている API が有効になるまで RenderDoc インテグレーションは一時的に無効になります。サポートされているプラットフォームと API の詳細については、RenderDoc ドキュメント を参照してください。

RenderDoc の読み込み

RenderDoc のインストールが検出された場合は、エディターのロード後いつでも、ゲームビューまたはシーンビューのタブを右クリックし、「RenderDoc のロード」オプションをクリックします。これによりグラフィックスデバイスがリロードされるため、変更を保存する必要がありますが、その後 RenderDoc はエディターを再起動起動したり、スタンドアロンプレイヤーをビルドすることなくキャプチャする準備ができます。
注
また、法線に従って RenderDoc 経由でエディターを起動したり、 -load-renderdoc コマンドラインオプションを渡して RenderDoc をスタートアップからロードすることもできます。

RenderDoc によるフレームのキャプチャ

互換性のあるバージョンの RenderDoc がエディターにロードされていることが検出されると、ゲームビューとシーンビューのツールバーの右側に新しいボタンが表示されます。

Capturing a frame with RenderDoc

このボタンを押すと、ビューのレンダリングの次のフレームのキャプチャがトリガーされます。RenderDoc ツールの UI を開いていない場合は、キャプチャを表示するために新しいインスタンスが起動し、すでに実行している場合は、最新のキャプチャが自動的にそこに表示されます。そこからキャプチャを開き、ツールを使用してデバッグできます。

List of frame captures in RenderDoc

シェーダーデバッグ情報を含む

デフォルトでは、DirectX11 シェーダーのサイズを最適化するために、デバッグ情報は削除されます。つまり、定数とリソースには名前がなく、シェーダーソースは使用できません。このデバッグ情報をシェーダーに含めるには、シェーダーの
HLSLPROGRAM
ブロックに**# pragma enable_d3d11_debug_symbolsを**含めます。

代替グラフィックススデバッグ技術

D3D11 を使用してスタンドアロンプレイヤーをビルドする場合は、フレームをキャプチャし、Visual Studio グラフィックスデバッガを使用してデバッグできます。

RenderDoc での Android SDK の設定

RenderDoc を使用して Android アプリケーションを開発する場合は、以下のいずれかの方法で Android SDK を正しく設定してください。

Unity と同じ SDK を使用するように RenderDoc を設定します (推奨)

  1. RenderDoc ウィンドウで、[Tools]> [Settings]> Android を選択します。
  2. Android SDK ルート パスに、Unity が Android SDK に使用するパスを入力します。このパスは、Unity エディターの編集> Preferences> Android SDK Tools Installed with Unity にあります。

RenderDoc と Unity 間で ADB のバージョンとパスを調整する

RenderDoc 設定の Android SDK ルート パスが設定されていない場合、RenderDoc は
PATH
環境変数の ADB に設定されたパスを使用します。
  1. PATH
    変数で設定された ADB パスを検索します。
    • 2 - Windows PowerShell
    • Windows コマンド プロンプト:
      where adb
  2. Windows 端末
    C:\[adb path from command output]\adb.exe version
    で ADB のバージョンを確認します。
  3. Unity が使用する ADB パスを検索します。Unity エディターで、編集> Preferences> Android SDK Tools Installed with Unity の順に選択します。
  4. Windows 端末の
    C:\[path to Android sdk platform-tools]\adb.exe version
    で対応する ADB バージョンを確認します。
  5. RenderDoc と Unity が使用する ADB のバージョンを比較します。これらが異なる場合は、ADB の場所の 1 つを選択し、両方のツールが同じパスを使用するように設定します。
注
Android Studio の Android SDK マネージャーを使用して、選択した SDK のプラットフォームツールが 最新 であることを確認します。