Unity URP custom grab pass

readme.md

Render Feature Setup

Get Global Texture in Blackboard

Sample Texture in Graph

Example Shader Graph to distort image

GrabScreenFeature.cs

using System;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Rendering;
using UnityEngine.Rendering.Universal;

public class GrabScreenFeature : ScriptableRendererFeature
{
    [System.Serializable]
    public class Settings
    {
        public string TextureName = "_GrabPassTransparent";
        public LayerMask LayerMask;
    }

    class GrabPass : ScriptableRenderPass
    {
        RenderTargetHandle tempColorTarget;
        Settings settings;

        RenderTargetIdentifier cameraTarget;

        public GrabPass(Settings s)
        {
            settings = s;
            renderPassEvent = RenderPassEvent.AfterRenderingTransparents;
            tempColorTarget.Init(settings.TextureName);
        }

        public void Setup(RenderTargetIdentifier cameraTarget)
        {
            this.cameraTarget = cameraTarget;
        }

        public override void Configure(CommandBuffer cmd, RenderTextureDescriptor cameraTextureDescriptor)
        {
            cmd.GetTemporaryRT(tempColorTarget.id, cameraTextureDescriptor);
            cmd.SetGlobalTexture(settings.TextureName, tempColorTarget.Identifier());
        }

        public override void Execute(ScriptableRenderContext context, ref RenderingData renderingData)
        {
            CommandBuffer cmd = CommandBufferPool.Get();
            context.ExecuteCommandBuffer(cmd);
            cmd.Clear();

            Blit(cmd, cameraTarget, tempColorTarget.Identifier());

            context.ExecuteCommandBuffer(cmd);
            CommandBufferPool.Release(cmd);
        }

        public override void FrameCleanup(CommandBuffer cmd)
        {
            cmd.ReleaseTemporaryRT(tempColorTarget.id);
        }
    }

    class RenderPass : ScriptableRenderPass
    {
        Settings settings;
        List<ShaderTagId> m_ShaderTagIdList = new List<ShaderTagId>();

        FilteringSettings m_FilteringSettings;
        RenderStateBlock m_RenderStateBlock;

        public RenderPass(Settings settings)
        {
            this.settings = settings;
            renderPassEvent = RenderPassEvent.AfterRenderingTransparents + 1;

            m_ShaderTagIdList.Add(new ShaderTagId("SRPDefaultUnlit"));
            m_ShaderTagIdList.Add(new ShaderTagId("UniversalForward"));
            m_ShaderTagIdList.Add(new ShaderTagId("LightweightForward"));

            m_FilteringSettings = new FilteringSettings(RenderQueueRange.all, settings.LayerMask);
            m_RenderStateBlock = new RenderStateBlock(RenderStateMask.Nothing);
        }

        public override void Execute(ScriptableRenderContext context, ref RenderingData renderingData)
        {
            CommandBuffer cmd = CommandBufferPool.Get();

            context.ExecuteCommandBuffer(cmd);
            cmd.Clear();

            DrawingSettings drawSettings;
            drawSettings = CreateDrawingSettings(m_ShaderTagIdList, ref renderingData, SortingCriteria.CommonTransparent);
            context.DrawRenderers(renderingData.cullResults, ref drawSettings, ref m_FilteringSettings, ref m_RenderStateBlock);

            context.ExecuteCommandBuffer(cmd);
            CommandBufferPool.Release(cmd);
        }
    }

    GrabPass grabPass;
    RenderPass renderPass;
    [SerializeField] Settings settings;

    public override void Create()
    {
        grabPass = new GrabPass(settings);
        renderPass = new RenderPass(settings);
    }

    public override void AddRenderPasses(ScriptableRenderer renderer, ref RenderingData renderingData)
    {
        grabPass.Setup(renderer.cameraColorTarget);

        renderer.EnqueuePass(grabPass);
        renderer.EnqueuePass(renderPass);
    }
}

LICENSE

MIT License

Copyright (c) 2020 Refsa

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Hi @Refsa,

I have two questions:

1. Is this still working or should I be looking for another solution?
2. Do I have to create a texture2d myself in my assets folder and assign it to the shader? For now I can't get it to work even with following all the steps and double checking the layers. I want to render a transparent sphere with some distortion from the transparent objects behind it, but the texture just stays white and no distortion to be seen.

@jornvdmaat17 I missed your post, not sure if you found your solution.

As for the first question, it's hard to say depending on the version of URP used. I know that the more updated version here should work on URP 11 depending on which stage of the pipeline it's ran at.

For the second one you dont need to assign any textures as it is created and set to the material in the render feature. Since you get a white output it sounds like you might forgot to uncheck the "exposed" toggle on the texture you added to the graph blackboard. It should not have a green dot next to it.

Hope this helps

For some reason it works only when I set "Intermediate Texture" in the renderer to: Always. It doesn't work with the default value: Auto. Not sure what that option does but doc says "Using this option might have a significant performance impact on some platforms". Any suggestion?

@YvesAlbuquerque this render feature is from before the introduction of that setting. As such it probably wont work properly anymore. If you tell me the version of URP version you are using I can take a look at it later.

As for the performance impact of the option it probably has something to do with memory usage and composition. Rendering to an intermediate texture requires additional video memory and it later has to be composed with the backbuffer to be displayed. If you're targeting platforms with very little video memory, such as older phones and gpus, then this option might impact the performance. It would also depend on how many other render features are active that relies on an intermediate texture as well as the resolution that the game is rendering at.

Thanks for the reply. Indeed, It will be awesome to know a way to avoid this extra memory overhead if possible. I'm using URP 12.1.6 in 2021.3.2f1.

Is there a way to make a object that uses the script to apear on another object that uses the script?


I want to make the red portal apear when I'm looking through the blue one

Hello, It was working perfectly but stopped working after I updated the project to Unity 2022.3.5f1

The console endlessly keeps printing:

" You can only call cameraColorTarget inside the scope of a ScriptableRenderPass. Otherwise the pipeline camera target texture might have not been created or might have already been disposed.
UnityEngine.Rendering.Universal.ScriptableRenderer:get_cameraColorTarget ()
GrabScreenFeature:AddRenderPasses (UnityEngine.Rendering.Universal.ScriptableRenderer,UnityEngine.Rendering.Universal.RenderingData&) (at Assets/FireGameStudios/VFX/Post-Processing/GrabScreenFeature.cs:108)
UnityEngine.GUIUtility:ProcessEvent (int,intptr,bool&) "

If anyone had a problem in the newer versions of Unity try changing this :
public void Setup(RenderTargetIdentifier cameraTarget) { this.cameraTarget = cameraTarget; }
to this :
public override void OnCameraSetup(CommandBuffer cmd, ref RenderingData renderingData) { cameraTarget = renderingData.cameraData.renderer.cameraColorTarget; }
it worked for me

If anyone had a problem in the newer versions of Unity try changing this : public void Setup(RenderTargetIdentifier cameraTarget) { this.cameraTarget = cameraTarget; } to this : public override void OnCameraSetup(CommandBuffer cmd, ref RenderingData renderingData) { cameraTarget = renderingData.cameraData.renderer.cameraColorTarget; } it worked for me

Thanks, that didn't do It for me for some reason though

Was anyone able to fix this? I also ran into this issue ^

Was anyone able to fix this? I also ran into this issue ^

Found this related updated API code. It seems it changed the Camera Setup to be only allowed on a new function scope (SetupRenderPasses).
https://docs.unity3d.com/Packages/[email protected]/manual/upgrade-guide-2022-1.html

Changed FROM:

public override void AddRenderPasses(ScriptableRenderer renderer, ref RenderingData renderingData)
{
grabPass.Setup(renderer.cameraColorTarget);

    renderer.EnqueuePass(grabPass);
    renderer.EnqueuePass(renderPass);
}

---

TO:

public override void AddRenderPasses(ScriptableRenderer renderer, ref RenderingData renderingData)
{
renderer.EnqueuePass(grabPass);
renderer.EnqueuePass(renderPass);
}
public override void SetupRenderPasses(ScriptableRenderer renderer,
in RenderingData renderingData)
{
// The target is used after allocation
grabPass.Setup(renderer.cameraColorTarget);
}

Would it work with Unity 6?