RenderPipelineGlobalSettings

描述

一个 ScriptableObject，用于与 RenderPipeline 关联，并为该 Pipeline 存储项目范围的设置。

可以通过 GraphicsSettings.RegisterRenderPipelineSettings 将单个 RenderPipelineGlobalSettings 实例注册到 GraphicsSettings。我们建议使用此 ScriptableObject 来保存您在 GraphicsSettings 中找到的 RenderPipeline 设置。

using System;
using System.Collections.Generic;

using UnityEngine;
using UnityEngine.Rendering;

#if UNITY_EDITOR
using UnityEditor.Rendering;
#endif

public class ExampleRenderPipelineAsset : RenderPipelineAsset
{
    protected override RenderPipeline CreatePipeline()
    {
        return new ExampleRenderPipeline();
    }
}

public class ExampleRenderPipeline : RenderPipeline
{
    public virtual RenderPipelineGlobalSettings globalSettings => ExampleRPGlobalSettings.instance;

    protected override void Render(ScriptableRenderContext renderContext, Camera[] cameras)
    {
#if UNITY_EDITOR
	// On Editor we must make sure the Global Settings Asset is registered into the GraphicsSettings
	// Graphics Settings will make sure the asset is available on player builds
        	if (globalSettings == null)
	{
 	       var mySettings = ExampleRPGlobalSettings.Create();
 	       ExampleRPGlobalSettings.RegisterToGraphicsSettings(mySettings);
	}
#endif

        // Do something
    }
}

[SupportedOnRenderPipeline(typeof(ExampleRenderPipelineAsset))]
public class ExampleRPGlobalSettings : RenderPipelineGlobalSettings
{
    private static ExampleRPGlobalSettings cachedInstance = null;
    public static ExampleRPGlobalSettings instance
    {
        get
        {
            if (cachedInstance == null)
                cachedInstance = GraphicsSettings.GetSettingsForRenderPipeline<ExampleRenderPipeline>() as ExampleRPGlobalSettings;
            return cachedInstance;
        }
    }

    /*   Use this pattern if you want to enable your global settings to use IRenderPipelineGraphicsSettings

	[SerializeReference] private List<IRenderPipelineGraphicsSettings> m_SettingsList = new();
 	protected override List<IRenderPipelineGraphicsSettings> settingsList => m_Settings;

    */

#if UNITY_EDITOR
    public static void RegisterToGraphicsSettings(ExampleRPGlobalSettings newSettings)
    {
        EditorGraphicsSettings.SetRenderPipelineGlobalSettingsAsset<ExampleRenderPipeline>(newSettings as RenderPipelineGlobalSettings);
        cachedInstance = null;
    }

    public static void UnregisterToGraphicsSettings()
    {
        EditorGraphicsSettings.SetRenderPipelineGlobalSettingsAsset<ExampleRenderPipeline>(null);
        cachedInstance = null;
    }

    static public ExampleRPGlobalSettings Create()
    {
        ExampleRPGlobalSettings assetCreated = ScriptableObject.CreateInstance<ExampleRPGlobalSettings>();
        return assetCreated;
    }
#endif
}

属性

公共方法

受保护的方法

继承的成员