Unity URP 17+自定义贴图实现与Render Graph解析

1. 问题背景与核心需求

在Unity 6000.0.3版本中使用URP渲染管线时，开发者经常需要实现自定义的渲染效果。一个典型需求是：如何在ScriptableRendererFeature中创建一张自定义贴图，并使其能够像内置的_CameraDepthTexture一样，在Shader中直接通过TEXTURE2D宏进行访问。

这个需求看似简单，但在URP 17+版本中却变得复杂，主要原因在于Unity引入了全新的Render Graph系统。传统的通过CommandBuffer.SetGlobalTexture配合Execute方法的方式已经不再适用，而官方文档和社区教程尚未完全跟进这一重大架构变更。

2. URP渲染管线演进与关键变更

2.1 从传统渲染到Render Graph

Unity 6000系列中的URP 17+版本最大的变革就是全面转向了Render Graph架构。这个架构带来了几个重要变化：

1. 显式资源管理：所有渲染资源（包括纹理、缓冲区等）必须显式声明生命周期
2. 自动内存管理：Render Graph会自动处理资源的创建和释放
3. 优化渲染流程：系统可以静态分析整个渲染流程，进行更高效的调度

2.2 新旧API对比

传统URP（12-16版本）中，我们可以这样设置全局纹理：

csharp复制cmd.SetGlobalTexture("_MyCustomTex", customTexture);

但在URP 17+中，这种方式会直接报错，因为：

1. CommandBuffer的许多方法已被标记为过时
2. 资源管理方式发生了根本性改变
3. 执行时机和资源可用性需要显式声明

3. 解决方案实现

3.1 方案A：Render Graph原生方式（推荐）

这是Unity 6+官方推荐的做法，完全遵循新的架构设计：

csharp复制using UnityEngine.Rendering;
using UnityEngine.Rendering.Universal;

public class CustomTextureFeature : ScriptableRendererFeature
{
    class CustomTexturePass : ScriptableRenderPass
    {
        private RTHandle m_CustomTexture;
        
        public override void OnCameraSetup(CommandBuffer cmd, ref RenderingData renderingData)
        {
            // 创建纹理描述
            var desc = new RenderTextureDescriptor(
                renderingData.cameraData.cameraTargetDescriptor.width,
                renderingData.cameraData.cameraTargetDescriptor.height,
                RenderTextureFormat.DefaultHDR, 0);
            
            // 通过RTHandleSystem分配纹理
            m_CustomTexture = RTHandles.Alloc(
                desc, 
                name: "_MyCustomTex",
                wrapMode: TextureWrapMode.Clamp);
            
            // 配置渲染目标
            ConfigureTarget(m_CustomTexture);
        }
        
        public override void Execute(ScriptableRenderContext context, ref RenderingData renderingData)
        {
            // 获取命令缓冲区
            var cmd = CommandBufferPool.Get("Custom Texture Pass");
            
            // 清除纹理
            CoreUtils.SetRenderTarget(cmd, m_CustomTexture);
            cmd.ClearRenderTarget(true, true, Color.clear);
            
            // 在这里实现你的自定义渲染逻辑
            // ...
            
            // 将纹理设置为全局属性
            cmd.SetGlobalTexture("_MyCustomTex", m_CustomTexture);
            
            context.ExecuteCommandBuffer(cmd);
            CommandBufferPool.Release(cmd);
        }
        
        public override void OnCameraCleanup(CommandBuffer cmd)
        {
            // 释放纹理资源
            m_CustomTexture?.Release();
        }
    }
    
    CustomTexturePass m_CustomTexturePass;
    
    public override void Create()
    {
        m_CustomTexturePass = new CustomTexturePass();
        m_CustomTexturePass.renderPassEvent = RenderPassEvent.AfterRenderingOpaques;
    }
    
    public override void AddRenderPasses(ScriptableRenderer renderer, ref RenderingData renderingData)
    {
        renderer.EnqueuePass(m_CustomTexturePass);
    }
}

关键点说明：

1. 使用RTHandle系统管理纹理生命周期
2. 在OnCameraSetup中创建纹理
3. 在Execute中实现具体渲染逻辑
4. 在OnCameraCleanup中释放资源
5. 通过SetGlobalTexture将纹理设为全局属性

3.2 方案B：兼容旧Execute + Render Graph（迁移方案）

对于需要从旧项目迁移的情况，可以采用这种过渡方案：

csharp复制public class LegacyCompatibleFeature : ScriptableRendererFeature
{
    class CompatiblePass : ScriptableRenderPass
    {
        private RenderTargetHandle m_CustomTexture;
        
        public override void Configure(CommandBuffer cmd, RenderTextureDescriptor cameraTextureDescriptor)
        {
            m_CustomTexture.Init("_MyCustomTex");
            
            var desc = cameraTextureDescriptor;
            cmd.GetTemporaryRT(m_CustomTexture.id, desc);
            
            ConfigureTarget(m_CustomTexture.Identifier());
        }
        
        public override void Execute(ScriptableRenderContext context, ref RenderingData renderingData)
        {
            var cmd = CommandBufferPool.Get();
            
            // 实现你的渲染逻辑
            // ...
            
            cmd.SetGlobalTexture("_MyCustomTex", m_CustomTexture.Identifier());
            
            context.ExecuteCommandBuffer(cmd);
            CommandBufferPool.Release(cmd);
        }
        
        public override void FrameCleanup(CommandBuffer cmd)
        {
            cmd.ReleaseTemporaryRT(m_CustomTexture.id);
        }
    }
    
    // ...其余部分与方案A类似
}

这种方案的优缺点：

• 优点：与旧代码更兼容，迁移成本低
• 缺点：不是完全符合Render Graph理念，可能存在性能隐患

3.3 方案C：通过Volume + Custom Post Process（无Feature方案）

这是一种完全不同的思路，不需要使用ScriptableRendererFeature：

csharp复制[Serializable, VolumeComponentMenu("Custom/CustomTextureEffect")]
public class CustomTextureEffect : VolumeComponent
{
    public TextureParameter customTexture = new TextureParameter(null);
}

public class CustomTextureRenderer : PostProcessEffectRenderer<CustomTextureEffect>
{
    public override void Render(PostProcessRenderContext context)
    {
        var sheet = context.propertySheets.Get(Shader.Find("Hidden/CustomTextureShader"));
        
        if (settings.customTexture.value != null)
        {
            sheet.properties.SetTexture("_MyCustomTex", settings.customTexture.value);
        }
        
        context.command.BlitFullscreenTriangle(context.source, context.destination, sheet, 0);
    }
}

这种方案的特点：

1. 通过Volume系统管理效果
2. 纹理可以在编辑器内直接设置
3. 不需要手动管理资源生命周期
4. 更适合后期处理类效果

4. Shader中的使用方式

无论采用哪种方案，在Shader中的使用方式都是一致的：

hlsl复制TEXTURE2D(_MyCustomTex);
SAMPLER(sampler_MyCustomTex);

half4 frag (v2f i) : SV_Target
{
    half4 col = SAMPLE_TEXTURE2D(_MyCustomTex, sampler_MyCustomTex, i.uv);
    // 使用采样结果...
    return col;
}

5. 常见问题与解决方案

5.1 纹理显示为粉色/紫色

这通常意味着Shader无法找到纹理：

1. 检查全局纹理名称是否一致
2. 确认纹理确实被正确设置
3. 验证RenderPass的执行顺序是否正确

5.2 内存泄漏

在Render Graph系统中常见的内存泄漏原因：

1. 忘记调用RTHandle的Release方法
2. 没有正确实现OnCameraCleanup
3. 临时RT没有释放

5.3 纹理内容不正确

可能的原因和解决方案：

1. 清除操作被跳过 - 确保调用了ClearRenderTarget
2. 渲染目标配置错误 - 检查ConfigureTarget调用
3. 视口设置问题 - 确认渲染区域正确

6. 性能优化建议

1. 纹理复用：对于多帧使用的纹理，考虑使用RTHandleSystem的全局纹理
2. 分辨率控制：根据实际需要调整纹理分辨率，不必总是使用屏幕分辨率
3. 格式选择：选择合适的RenderTextureFormat以减少内存占用
4. 执行时机：合理安排RenderPassEvent以最小化性能影响

7. 实际项目中的经验分享

在大型项目中实现这类功能时，有几个实用技巧：

1. 调试工具：创建一个简单的调试Shader，专门用于显示自定义纹理内容
2. 编辑器扩展：为你的Feature添加编辑器UI，便于调整参数
3. 多相机支持：如果需要支持多相机，确保每个相机都有独立的纹理实例
4. 平台差异：注意不同平台对纹理格式的支持差异

我在一个地形渲染项目中使用了方案A，发现相比传统方式，Render Graph确实能更好地管理资源，特别是在频繁切换场景时，内存使用更加稳定。不过需要注意的是，由于API较新，某些情况下可能需要查阅Unity的源代码来理解内部工作机制。