Version: 2023.1
言語: 日本語
スクリプタブルレンダーパイプラインに基づくカスタムレンダーパイプラインの作成
カスタムレンダーパイプラインでのシンプルなレンダーループの作成

カスタムレンダーパイプラインでのレンダーパイプラインアセットとレンダーパイプラインインスタンスの作成

スクリプタブルレンダーパイプライン (SRP) に基づいて独自のレンダーパイプラインを作成する場合、プロジェクトには以下が含まれていなければなりません。

  • RenderPipelineAsset を継承し、 CreatePipeline() メソッドをオーバーライドするスクリプト。このスクリプトはレンダーパイプラインアセットを定義します。
  • RenderPipeline を継承し、Render() メソッドをオーバーライドするスクリプト。このスクリプトにレンダーパイプラインインスタンスを定義します。ここに、カスタムのレンダリングコードを記述します。
  • RenderPipelineAsset スクリプトから作成したレンダーパイプラインアセット。このアセットはレンダーパイプラインインスタンスの Factory クラスとして機能します。

これらの要素は密接に関連しているため、同時に作成する必要があります。

基本的なレンダーパイプラインアセットとレンダーパイプラインインスタンスの作成

次の例は、レンダー パイプラインインスタンスをインスタンス化する基本的なカスタムのレンダーパイプライン アセットのスクリプト、レンダーパイプラインインスタンスを定義するスクリプト、そしてレンダーパイプラインアセット自体を作成する方法を示しています。

  1. ExampleRenderPipelineAsset.cs という C# スクリプトを作成します。

  2. 次のコードをコピーして新しいスクリプトに貼り付けます。

    using UnityEngine;
    using UnityEngine.Rendering;
    
    // CreateAssetMenu 属性によって Unity Editor にこのクラスのインスタンスの作成が可能になります。
    [CreateAssetMenu(menuName = "Rendering/ExampleRenderPipelineAsset")]
    public class ExampleRenderPipelineAsset : RenderPipelineAsset
    {
        // 最初のフレームをレンダリングする前に、Unity によってこのメソッドが呼び出されます。
        //レンダーパイプラインアセットの設定が変更された場合は、Unity は現在のレンダーパイプラインインスタンスを破棄し、次のフレームをレンダリングする前に再度、このメソッドを呼び出します。 
        protected override RenderPipeline CreatePipeline() {
            // このカスタムの SRP がレンダリングのために使うレンダーパイプラインをインスタンス化します。
            return new ExampleRenderPipelineInstance();
        }
    }
    
  3. ExampleRenderPipelineInstance.cs という C# スクリプトを作成します。

  4. 次のコードをコピーして新しいスクリプトに貼り付けます。

    using UnityEngine;
    using UnityEngine.Rendering;
    
    public class ExampleRenderPipelineInstance : RenderPipeline
    {
        public ExampleRenderPipelineInstance() {
        }
    
        protected override void Render (ScriptableRenderContext context, Camera[] cameras) {
            // ここにカスタムレンダリングコードを記述します。SPR をカスタマイズするために、このメソッドをカスタマイズします。
        }
    }
    
  5. Project ウィンドウで追加ボタン (+) をクリックするか、コンテキストメニューを開いて Create に移動し、Rendering > Example Render Pipeline Asset を選択します。Unity は、Project ウィンドウに新しいレンダーパイプラインアセットを作成します。

設定可能なレンダーパイプラインアセットとレンダーパイプラインインスタンスの作成

デフォルトでは、レンダーパイプラインアセットには、レンダリングにどのレンダーパイプラインインスタンスを使用するか、また、エディターで使用するデフォルトのマテリアルとシェーダーに関する情報が保存されています。RenderPipelineAsset スクリプトでは、レンダーパイプラインアセットを拡張して追加のデータを保存することができ、プロジェクト内に設定の異なる複数のレンダーパイプラインアセットを持つことができます。例えば、レンダーパイプラインアセットを使用して、異なるティアのハードウェアごとに設定データを保存できます。HD レンダーパイプライン (HDRP) とユニバーサルレンダーパイプライン (URP) などにこのような例が含まれます。

以下の例は、パブリックデータ (インスペクターを使用してインスタンスごとに設定できます) でレンダーパイプラインアセットを定義する RenderPipelineAsset スクリプトの作成方法と、レンダーパイプラインインスタンス (コンストラクターでレンダーパイプラインアセットを受け取り、そのレンダーパイプラインアセットのデータを使用します) の作成方法を示しています。

  1. ExampleRenderPipelineAsset.cs という C# スクリプトを作成します。

  2. 次のコードをコピーして新しいスクリプトに貼り付けます。

    using UnityEngine;
    using UnityEngine.Rendering;
    
    // The CreateAssetMenu attribute lets you create instances of this class in the Unity Editor.
    [CreateAssetMenu(menuName = "Rendering/ExampleRenderPipelineAsset")]
    public class ExampleRenderPipelineAsset : RenderPipelineAsset
    {
        // このデータは、レンダーパイプラインアセットごとにインスペクターで定義されます
        public Color exampleColor;
        public string exampleString;
    
            // Unity calls this method before rendering the first frame.
           // レンダーパイプラインアセットの設定が変わると、次のフレームをレンダリングする前に、Unity は現在のレンダーパイプラインインスタンスを破棄しこのメソッドを再度呼び出します。
        protected override RenderPipeline CreatePipeline() {
            // このカスタム SRP がレンダリングに使用するレンダリングパイプラインをインスタンス化し、このレンダーパイプラインアセットへの参照を渡します。
            // レンダーパイプラインインスタンスは、上記で定義された構成データにアクセスできます。
            return new ExampleRenderPipelineInstance(this);
        }
    }
    
  3. ExampleRenderPipelineInstance.cs という C# スクリプトを作成します。

  4. 次のコードをコピーして新しいスクリプトに貼り付けます。

    using UnityEngine;
    using UnityEngine.Rendering;
    
    public class ExampleRenderPipelineInstance : RenderPipeline
    {
        // Use this variable to a reference to the Render Pipeline Asset that was passed to the constructor
        private ExampleRenderPipelineAsset renderPipelineAsset;
    
        // The constructor has an instance of the ExampleRenderPipelineAsset class as its parameter.
        public ExampleRenderPipelineInstance(ExampleRenderPipelineAsset asset) {
            renderPipelineAsset = asset;
        }
    
        protected override void Render(ScriptableRenderContext context, Camera[] cameras) {
            // これは、レンダーパイプラインアセットからデータを使う例です。
            Debug.Log(renderPipelineAsset.exampleString);
            
            // ここにカスタムレンダリングコードを記述します。SPR をカスタマイズするために、このメソッドをカスタマイズします。
        }
    }
    
    
  5. Project ウィンドウで追加ボタン (+) をクリックするか、コンテキストメニューを開いて Create に移動し、Rendering > Example Render Pipeline Asset を選択します。Unity は、Project ウィンドウに新しいレンダーパイプラインアセットを作成します。

スクリプタブルレンダーパイプラインに基づくカスタムレンダーパイプラインの作成
カスタムレンダーパイプラインでのシンプルなレンダーループの作成