PSO キャッシュのビルド

PSO キャッシングに必要な「stablepc.csv」ファイルの生成方法について説明します。

Windows
MacOS
Linux
コンテンツ

Pipeline State Object (PSO) キャッシング システムが正常に機能するためには、マテリアルから要求された シェーダ を、要求元の マテリアル にマップする必要があります。[ShaderPipelineCacheTools] コマンドレットを使用してマッピング情報を含めたファイルをビルドすることで実現します。 この操作ガイドでは、[ShaderPipelineCacheTools] コマンドレットを使用して必要なファイルをビルドする方法について説明します。

手順

  1. 最初に、C ドライブのルートに「PSOCaching」という名前で新規フォルダを作成します。

  2. 次に、UE4 プロジェクト フォルダの以下の場所を開いて、「scl.csv」ファイルを探します。
    ProjectName\Saved\Cooked\PlatfourmYouCookedFor\ProjectName\Metadata\PipelineCaches

    クリックしてフルサイズで表示。

    Android を使用する場合、以下を AndroidEngine.ini に追加する必要があります。

    [DevOptions.Shaders]
    NeedsShaderStableKeys=true

    NeedsShaderStableKeys を有効にしないと、後に stable.csv を生成するために必要となる「scl.csv」が作成されません。

  3. Pipeline Caches フォルダにある両方の「scl.csv」ファイルを、C ドライブのルートに作成した「PSOCaching」フォルダにコピーします。

  4. 次に、プロジェクトを作成したドライブで起動したときに生成された「rec.upipelinecache」ファイルを C ドライブに作成した「PSOCaching」フォルダにコピーします。
    Build_PSO_Needed_Files.png

  5. 必要なファイルを生成するには、UE4 のコマンドレット関数を使用してください。コマンドレット機能を使用するため、「Engine\Binaries\Win64」フォルダを開き、「 UE4Editor-Cmd.exe」ファイルを探します。
    Locate_UE4Editor_CMD_EXE.png

  6. UE4Editor-Cmd.exe」ファイルを右クリックして、表示されたリストから [Create Shortcut] オプションを選択します。

  7. 新規に作成されたショートカットを C ドライブのルートに作成された「PSOCaching」フォルダに移動します。

  8. UE4Editor-Cmd.exe のショートカットを右クリックして、表示されたメニューから [Properties] オプションを選択します。

  9. Target 入力で、UE4Editor-Cmd.exe に続けて以下のコマンドライン パラメータを追加します。

    ActionRPG -run=ShaderPipelineCacheTools expand C:/PSOCaching/*.rec.upipelinecache C:/PSOCaching/*.scl.csv ActionRPG_GLSL_ES3_1_ANDROID.stablepc.csv
  10. [OK] をクリックして、ショートカット プロパティのダイアログ ボックスを閉じ、「UE4Editor-Cmd.exe - Shortcut」をダブルクリックしてコマンドレットを実行します。

  11. コマンドレットの実行が完了すると、C ドライブのルートに作成した「PSOCaching」フォルダに「stablepc.csv」という名前のファイルが新規作成されます。
    Stable_PC_File.png

ファイルが見つからなければ、「Engine\Binaries\Win64」フォルダを確認してみてください。

最終結果

「scl.csv」と「rec.upipelinecache」ファイルを結合して「stablepc.csv」ファイルを作成したら、UE4 プロジェクトのビルド時に使用する場所へ「stablepc.csv」ファイルを移動する必要があります。

「stablepc.csv」の配置場所についての詳細については、「PSO キャッシングを使用した UE4 プロジェクトのビルド」を参照してください。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
閉じる