Unified Blur

*Enhance your project quality with a clean and performant screen blur effect, built for Unity 6 and beyond using Render Graph.* [![Latest release](https://camo.githubusercontent.com/051f1614cb12721e4b7cffea6b725869c5e3bb51782d4799875e5c8bd723803e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c756b616b6c646961736876696c692f556e69666965642d556e6976657273616c2d426c75723f6c6162656c3d4c617465737425323072656c65617365267374796c653d666c61742d737175617265)](https://github.com/lukakldiashvili/Unified-Universal-Blur/releases) [![Stars](https://camo.githubusercontent.com/4ce8c4b44855ac4a89f9620709e42a9a9051a23d6c8ab13353615a8d40751ce5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6c756b616b6c646961736876696c692f556e69666965642d556e6976657273616c2d426c75723f7374796c653d666c61742d737175617265)](https://github.com/lukakldiashvili/Unified-Universal-Blur/stargazers) [![Fork](https://camo.githubusercontent.com/a34aa9a4b051c3f872260707945ff0ba82d828b4b211d8805451828b717e1804/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6c756b616b6c646961736876696c692f556e69666965642d556e6976657273616c2d426c75723f7374796c653d666c61742d737175617265)](https://github.com/lukakldiashvili/Unified-Universal-Blur/network/members) [![Watchers](https://camo.githubusercontent.com/ebf1b52aa4628469cb80b7c402bfbe5d0d87e5cb103507b27794d6a1b941ccf6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f77617463686572732f6c756b616b6c646961736876696c692f556e69666965642d556e6976657273616c2d426c75723f7374796c653d666c61742d737175617265)](https://github.com/lukakldiashvili/Unified-Universal-Blur/watchers) Unsupported

--- ## Introduction **Unified Blur** is a powerful and flexible screen blur effect for Unity, built using the new Render Graph API. It is designed to be easy to use, efficient, and highly customizable. Unified Blur is perfect for creating clean translucent effect for you application. > **Note:** Since Unified Blur is built on top of new Render Graph API, it is not compatible with older versions of Unity.
> To access last version of Unified Blur that supports older versions of Unity, please visit [Latest Legacy Branch](https://github.com/lukakldiashvili/Unified-Universal-Blur/tree/legacy/0.4.1). --- Showcase

## Behind the Scenes **Unified Blur** works by inserting a custom render pass into the render graph, at a specific point that is configurable, which copies back buffer and applies a blur effect to it. After the render pass is complete, blurred image is available via global texture for future objects rendered to use. ## Use Cases **Unified Blur** is best used with UI components that are part of the `Screen Space - Overlay` canvas. But, it does support other canvas types as well, although with some limitations (check out [limitations](https://github.com/lukakldiashvili/Unified-Universal-Blur/raw/main/#limitations) section). - Option 1: **UI Image Component with Blur Material**
Display a blurred version of the screen on a UI Image component. This is useful for creating translucent UI effects.

- Option 2: **Custom Shader with Unified Blur**
Use global texture generated by Unified Blur Render Feature in your custom shader to create unique effects. ## Installation - **Unity Package Manager** - Copy git url and add it via package manager's `Add package from git URL...` (for a specific version visit [releases](https://github.com/lukakldiashvili/Unified-Universal-Blur/releases)). - **Open UPM** - For more information, visit [OpenUPM Page](https://openupm.com/packages/com.unify.unified-universal-blur/). - **Manual** - Download zip, extract and put its content anywhere in the project (preferably in Plugins folder). ## Setup 1. **Add Unified Blur Render Feature**
Add `Unified Blur Render Feature` to the renderer data that is being used by the project. This can be done by selecting the renderer data asset and adding the feature in the inspector. 2. **Assign Blur Material To UI Image Component**
Assign `UniversalBlurUI` material to any UI Image component that you want to display the blurred screen on. 3. **Play with Settings**
Adjust settings in the `Unified Blur Render Feature` settings to get the desired blur effect. ## Limitations - Limited support for world space or screen space camera canvases.
*To enable this kind of support, change injection point in Render Feature's settings panel to `BeforeRenderingTransparents`. Note that, transparent objects and other canvases will not be visible in this scenario.*