自定义RenderFeature接口流程
URP内部ScriptableRenderPass分析
public、protected属性
- renderPassEvent :渲染事件发生的时刻
- colorAttachments :渲染的颜色纹理列表 m_ColorAttachments
- colorAttachment :m_ColorAttachments[0];
- depthAttachment :m_DepthAttachment
- colorStoreActions:
RenderBufferStoreAction[]
【Enum】这个 枚举 描述了当GPU完成渲染到渲染目标时应该在渲染目标上做什么。(与MSAA是否存储或解析有关) - depthStoreAction :
RenderBufferStoreAction
【Enum】 - input :
ScriptableRenderPassInput
【Enum】
- None = 0x0,
- Depth = 0x1,
- Normal = 0x2,
- Color = 0x4,
- Motion = 0x8
- clearFlag :
ClearFlag
【Enum】
- None = 0x0,
- Color = 0x1,
- Depth = 0x2,
- Stencil = 0x4,
- DepthStencil = 0x6,
- ColorStencil = 0x5,
- All = 0x7
- clearColor :Color m_ClearColor
private 属性
internal 属性(同一命名空间使用)
internal bool overrideCameraTarget { get; set; }
internal bool isBlitRenderPass { get; set; }
internal bool useNativeRenderPass { get; set; }
internal int renderTargetWidth { get; set; }
internal int renderTargetHeight { get; set; }
internal int renderTargetSampleCount { get; set; }
internal bool depthOnly { get; set; }
internal bool isLastPass { get; set; }//这个标志每帧更新,以跟踪哪一帧是当前相机的最后一帧
internal int renderPassQueueIndex { get; set; }//索引来跟踪当前帧中的位置
internal NativeArray<int> m_ColorAttachmentIndices;
internal NativeArray<int> m_InputAttachmentIndices;
internal GraphicsFormat[] renderTargetFormat { get; set; }
RenderTargetIdentifier[] m_ColorAttachments = new RenderTargetIdentifier[] { BuiltinRenderTextureType.CameraTarget };
internal RenderTargetIdentifier[] m_InputAttachments = new RenderTargetIdentifier[8];
internal bool[] m_InputAttachmentIsTransient = new bool[8];
RenderTargetIdentifier m_DepthAttachment = BuiltinRenderTextureType.CameraTarget;
ScriptableRenderPassInput m_Input = ScriptableRenderPassInput.None;
ClearFlag m_ClearFlag = ClearFlag.None;
Color m_ClearColor = Color.black;
URP内部ScriptableRenderer分析
ScriptableRenderer 管理所有的ScriptableRenderFeature以及ScriptableRenderPass
static数据
internal static ScriptableRenderer current = null;
private static bool m_UseOptimizedStoreActions = false;
static RenderTargetIdentifier[] m_ActiveColorAttachments = new RenderTargetIdentifier[] { 0, 0, 0, 0, 0, 0, 0, 0 };
static RenderTargetIdentifier m_ActiveDepthAttachment;
static RenderTargetIdentifier[][] m_TrimmedColorAttachmentCopies = new RenderTargetIdentifier[][]
private static Plane[] s_Planes = new Plane[6];
private static Vector4[] s_VectorPlanes = new Vector4[6];
核心数据
List<ScriptableRenderPass> m_ActiveRenderPassQueue = new List<ScriptableRenderPass>(32);
List<ScriptableRendererFeature> m_RendererFeatures = new List<ScriptableRendererFeature>(10);
RenderTargetIdentifier m_CameraColorTarget;//当前渲染管线上一帧结果的Color纹理
RenderTargetIdentifier m_CameraDepthTarget;
RenderTargetIdentifier m_CameraResolveTarget;
其他数据
private StoreActionsOptimization m_StoreActionsOptimizationSetting = StoreActionsOptimization.Auto;
const int k_RenderPassBlockCount = 4;
bool m_FirstTimeCameraColorTargetIsBound = true;
bool m_FirstTimeCameraDepthTargetIsBound = true;
bool m_IsPipelineExecuting = false;
internal bool isCameraColorTargetValid = false;
internal bool disableNativeRenderPassInFeatures = false;
internal bool useRenderPassEnabled = false;
internal bool useDepthPriming { get; set; } = false;
internal bool stripShadowsOffVariants { get; set; } = false;
internal bool stripAdditionalLightOffVariants { get; set; } = false;
首先,当创建实例Pass时调用父类构造函数
public ScriptableRenderPass()
{
renderPassEvent = RenderPassEvent.AfterRenderingOpaques;
m_ColorAttachments = new RenderTargetIdentifier[] { BuiltinRenderTextureType.CameraTarget, 0, 0, 0, 0, 0, 0, 0 };
m_InputAttachments = new RenderTargetIdentifier[] { -1, -1, -1, -1, -1, -1, -1, -1 };
m_InputAttachmentIsTransient = new bool[] { false, false, false, false, false, false, false, false };
m_DepthAttachment = BuiltinRenderTextureType.CameraTarget;
m_ColorStoreActions = new RenderBufferStoreAction[] { RenderBufferStoreAction.Store, 0, 0, 0, 0, 0, 0, 0 };
m_DepthStoreAction = RenderBufferStoreAction.Store;
m_OverriddenColorStoreActions = new bool[] { false, false, false, false, false, false, false, false };
m_OverriddenDepthStoreAction = false;
m_ClearFlag = ClearFlag.None;
m_ClearColor = Color.black;
overrideCameraTarget = false;
isBlitRenderPass = false;
profilingSampler = new ProfilingSampler($"Unnamed_{nameof(ScriptableRenderPass)}");
useNativeRenderPass = true;
renderTargetWidth = -1;
renderTargetHeight = -1;
renderTargetSampleCount = -1;
renderPassQueueIndex = -1;
renderTargetFormat = new GraphicsFormat[]
{
GraphicsFormat.None, GraphicsFormat.None, GraphicsFormat.None,
GraphicsFormat.None, GraphicsFormat.None, GraphicsFormat.None, GraphicsFormat.None, GraphicsFormat.None
};
depthOnly = false;
}
其次、调用AddRenderPasses时,将实例化Pass加入队列
使用函数
renderer.EnqueuePass(_scannerPass);
将该Pass加入到URP Renderer管线中
public void EnqueuePass(ScriptableRenderPass pass)
{
m_ActiveRenderPassQueue.Add(pass);
if (disableNativeRenderPassInFeatures)
pass.useNativeRenderPass = false;
}
之后、调用OnCameraSetup,设置当前Pass的目标纹理
public override void OnCameraSetup(CommandBuffer cmd, ref RenderingData renderingData)
{
// 将当前摄像机的cameraColorTarget作为该Pass渲染的目标纹理
ConfigureTarget(renderingData.cameraData.renderer.cameraColorTarget);
}
最后、调用Execute函数渲染
作为后处理,我们可以通过如下流程
1. 创建着色器属性名称唯一标识符
int tempRT = Shader.PropertyToID("标识符名称,可自定义");
2. 根据当前摄像机的目标纹理设置,创建新的临时纹理
cmd.GetTemporaryRT(tempRT, renderingData.cameraData.cameraTargetDescriptor);
RenderTextureDescriptor
这个结构体包含了创建RenderTexture所需的所有信息。即renderingData.cameraData.cameraTargetDescriptor
返回的值
3. 对一个纹理做后处理
后处理材质为_material,使用Pass 0;并保存到下一个纹理中。
cmd.Blit(colorAttachment, tempRT, _material, 0);
Blit意思为位块传送,即将colorAttachment的所有数据,复制到tempRT中。
而这里,Unity不仅仅做位块传输,而是 使用着色器 将纹理中的像素数据复制到渲染纹理中。
public void Blit(RenderTargetIdentifier source, RenderTargetIdentifier dest, Material mat, int pass)
{
// 设置描述如何执行命令缓冲区的意图的标志。
ValidateAgainstExecutionFlags(CommandBufferExecutionFlags.None, CommandBufferExecutionFlags.AsyncCompute);
// 位块传输 allSlices---所有位块
Blit_Identifier(ref source, ref dest, mat, pass, new Vector2(1f, 1f), new Vector2(0f, 0f), Texture2DArray.allSlices, 0);
}
内部代码被封装,不可见!
4. 将临时纹理复制给目标
如果不使用自己的material,则使用Unity默认的mat,即只复制结果。
cmd.Blit(tempRT, colorAttachment);
5. 提交命令,释放命令池
//上下文执行这个CommandBuffer
context.ExecuteCommandBuffer(cmd);
//释放这个临时纹理
cmd.ReleaseTemporaryRT(tempRT);
//CommandBuffer池释放这个cmd
CommandBufferPool.Release(cmd);
Shader中的数据
复制的数据将作为_MainTex录入。
Properties
{
_MainTex("MainTex",2D)= "white"{}
}
TEXTURE2D(_MainTex);
SAMPLER(sampler_MainTex);
深度图需要在UniversalRenderPipelineAsset中勾选Depth Texture。
但是如果未勾选,如果内部渲染有使用到DepthTexture,也可能会生成DepthTexture。
TEXTURE2D(_CameraDepthTexture);
SAMPLER(sampler_CameraDepthTexture);