PIX でシェーダーをデバッグ

PIX は、Windows 開発者向けに Microsoft によって作られたパフォーマンスチューニングとデバッグのツールです。これには、アプリケーションのパフォーマンスを分析するためのさまざまなモードを提供し、デバッグのためにアプリケーションから DirectX プロジェクトのフレームをキャプチャする機能が含まれています。

PIX を使用して、Windows 64 ビット (x86_64) スタンドアロンやユニバーサル Windowsプラットフォームのアプリケーションに関する問題を調査します。

PIX をインストールするには、Microsoft PIX インストーラーをダウンロードして実行し、指示に従ってください。

PIX の詳細については、Microsoft の PIX 概要と PIX ドキュメントを参照してください。

PIX を使った DirectX シェーダーのデバッグ

Unity エディターで実行しているバージョンではなく、Unity アプリケーションのビルドバージョンを使用して、フレームをキャプチャする必要があります。理由は、GPU フレームをキャプチャするには PIX から対象のアプリケーションを起動する必要があるためです。

開発ビルドを使用すると PIX に追加情報が加えられ、シーンのキャプチャをより簡単に操作できます。

デバッグが可能なシェーダーでプロジェクトを作成

PIX のソースコードでシェーダーをデバッグするには、シェーダーコードに次のプラグマを挿入する必要があります。#pragma enable_d3d11_debug_symbols

例

以下は基本的な例を使用してプロセス全体を紹介します。

基本的なプロジェクトを作成

新しい Unity プロジェクトを作成します (Hub のドキュメントProjects を参照)。
上部のメニューで、Assets > Create > Shader > Standard Surface Shader の順に選択します。これにより、Project フォルダー内に新しいシェーダーファイルが作成されます。
シェーダーファイルを選択し、Inspector ウィンドウで Open をクリックします。スクリプトエディターでシェーダーファイルを開きます。他の #pragma 行以下のシェーダーコードに #pragma enable_d3d11_debug_symbols を挿入します。
新しいマテリアルを作成します (メニューで Assets > Create > Material を選択します)。
マテリアルの Inspector ウィンドウで Shader ドロップダウンを選択して Custom に移動し、作成したシェーダーを選択します。
3D キューブゲームオブジェクトを作成します (メニューで GameObject > 3D Object > Cube を選択します)。
新しいマテリアルを新しいゲームオブジェクトに割り当てます。これを行うには、マテリアルを Project ウィンドウから 3D キューブにドラッグします。

Windows スタンドアロンアプリケーションからフレームをキャプチャ

File > Build Settings に移動し、Platform で Windows, Mac, Linux を選択します。Target Platform を Windows に、Architecture を Intel 64-bit に設定し、Development Build チェックボックスをオンにします。
Build をクリックします。
PIX. を起動します。
Home をクリックし、Connect をクリックします。
自分の PC をキャプチャに使用するには、PC の localhost __ を選択して、connect__ をクリックします。
Select Target Process ボックスで Launch Win32 タブを選択し、Browse ボタンを使用してアプリケーションの実行ファイルを選択します。ここで、“Win32” は非 UWP アプリケーションを意味します。使用するアプリケーションファイルは 64 ビットのバイナリファイルである必要があります。
Launch for GPU Capture を有効にし、Launch ボタンを押してアプリケーションを開始します。
フレームをキャプチャする準備が整うまで、アプリケーションを通常どおりに使用します。フレームをキャプチャするには、キーボードの Print Screen を押すか、GPU Capture パネルのカメラアイコンをクリックします。キャプチャのサムネイルがパネルに表示されます。キャプチャを開くには、サムネイルをクリックします。
キャプチャの分析を開始するには、強調表示されたテキストか、メニューバーの小さな Play アイコンをクリックします。
Pipeline タブを選択し、Events ウィンドウを使用して、興味のあるドローコールを選択します。
Pipeline タブの下方で OM (Output Merger) リストからレンダーターゲットを選択し、ドローコールの出力を表示します。デバッグしたいオブジェクト上のピクセルを選択します。興味のあるドローコールを見つけるのと同様の方法で、ピクセルを右クリックすると、ドローコールの履歴を見ることができます。
Pixel Details パネルで Debug Pixel を選択します。
デバッグパネルの Shader Options を使用して、デバッグするシェーダーステージを選択します。
ツールバーまたはキーボードショートカットを使用して、コードを 1 つずつ移動します。