Unified-Universal-Blur - GitLite

KO | EN

gitlite — search

#python #llm #machine-learning #deep-learning #linux #docker #nodejs #java #awesome #cli #awesome-list #vue #ios #openai

Unified-Universal-Blur

(★ 973)

UI blur (translucent) effect for Unity.

File Explorer

Download Latest Version (.zip)

- ShowAsPassDrawer.cs
- ShowAsPassDrawer.cs.meta
- Unified.Universal.Blur.Editor.asmdef
- Unified.Universal.Blur.Editor.asmdef.meta
- UniversalBlurUI.mat
- UniversalBlurUI.mat.meta
- - IWrappedCommandBuffer.cs
  - IWrappedCommandBuffer.cs.meta
  - WrappedCommandBuffer.cs
  - WrappedCommandBuffer.cs.meta
  - WrappedUnsafeCommandBuffer.cs
  - WrappedUnsafeCommandBuffer.cs.meta
- - IPassData.cs
  - IPassData.cs.meta
  - LegacyPassData.cs
  - LegacyPassData.cs.meta
  - RenderGraphPassData.cs
  - RenderGraphPassData.cs.meta
- BlurConfig.cs
- BlurConfig.cs.meta
- BlurPasses.cs
- BlurPasses.cs.meta
- BlurType.cs
- BlurType.cs.meta
- CommandBuffer.meta
- Constants.cs
- Constants.cs.meta
- PassData.meta
- ScaleBlurWith.cs
- ScaleBlurWith.cs.meta
- ShowAsPass.cs
- ShowAsPass.cs.meta
- Unified.UniversalBlur.Runtime.asmdef
- Unified.UniversalBlur.Runtime.asmdef.meta
- UniversalBlurFeature.cs
- UniversalBlurFeature.cs.meta
- UniversalBlurPass.cs
- UniversalBlurPass.cs.meta
- Blur.shader
- Blur.shader.meta
- Common.hlsl
- Common.hlsl.meta
- TintedBlurUI.shader
- TintedBlurUI.shader.meta
.gitignore
Editor.meta
LICENSE
LICENSE.meta
Materials.meta
package.json
package.json.meta
README.md
README.md.meta
Runtime.meta
Shaders.meta

# Installation Guide

1. Get the code

git clone https://github.com/lukakldiashvili/Unified-Universal-Blur

Downloads the entire project code from GitHub to your computer.

cd Unified-Universal-Blur

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img align="center" alt="Unified Blur Showcase" src="https://github.com/user-attachments/assets/f97043d5-ed16-45da-91e9-e1d4bdf20518"/>

<h1 align="center">
<strong>Unified Blur</strong>
</h1>

> A modern screen blur for Unity, built on Render Graph with performance and compatibility in mind.

[![Latest release](https://img.shields.io/github/v/release/lukakldiashvili/Unified-Universal-Blur?label=Latest%20release&style=flat-round)](https://github.com/lukakldiashvili/Unified-Universal-Blur/releases)
<img align="right" alt="URP" src="https://img.shields.io/badge/URP-Yes-green?style=flat-round" style="margin-left: 4px;"/>
<img align="right" alt="HDRP" src="https://img.shields.io/badge/HDRP-No-red?style=flat-round" style="margin-left: 4px;"/>
<img align="right" alt="BIRP" src="https://img.shields.io/badge/BIRP-No-red?style=flat-round" style="margin-left: 4px;"/>

<img align="left" alt="Supported" src="https://img.shields.io/badge/Compatible With-_2022.3 & Up-yellow?style=flat-round" style="margin-right: 4px;"/>
<img align="left" alt="Tested with Unity 2022.3.62, 6000.0.72, 6000.3.11, 6000.4.2, 6000.6.0" src="https://img.shields.io/badge/Tested%20with-2022.3.62%20%7C%206000.0.72%20%7C%206000.3.11%20%7C%206000.4.2%20%7C%206000.6.0-green?style=flat-round" style="margin-right: 4px;"/>

<br>

---
## Introduction

**Unified Blur** is a performant and flexible screen blur effect for Unity, built using the new Render Graph API.

It supports both modern Unity 6 projects and some of the older versions through a legacy compatibility path.

Designed to be easy to use, efficient, and highly customizable, Unified Blur is perfect for creating clean translucent effects for your games and applications.

---

<p align="center">
<a href="#installation">Installation</a> · <a href="#setup">Setup</a> · <a href="#use-cases">Use Cases</a> · <a href="#how-it-works">How It Works</a> · <a href="#troubleshooting">Troubleshooting</a> · <a href="#limitations">Limitations</a>
</p>

## 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**<br>
   Add `Unified Blur Render Feature` to the renderer data asset used by your project. Step by step:
   1. Open `Project Settings → Graphics` and locate the `Scriptable Render Pipeline Settings` field (this is your URP Asset). Alternatively, open `Project Settings → Quality` and read the URP Asset assigned to the currently active quality level.
   2. Select the URP Asset in the Project window and look at the `Renderer List` in its inspector. Each entry points to a renderer data asset (e.g. `PC_Renderer`, `Mobile_Renderer`).
   3. Select the renderer data asset you want to extend in the Project window.
   4. In the inspector, scroll down to the `Renderer Features` section and click `Add Renderer Feature → Universal Blur Feature`.

A project can have multiple renderer assets (one per platform/quality level - PC, Mobile, WebGL, etc.). The feature must be added to the renderer asset used by the active quality preset, otherwise the blur will not appear at runtime. If you target multiple platforms, add the feature to each renderer asset that needs the effect (see [Troubleshooting](#troubleshooting)).
2. **Assign Blur Material to UI Image Component**<br>
    Assign `UniversalBlurUI` material to any UI Image component that you want to display the blurred screen on.
3. **Play with Settings**<br>
   Adjust settings in the `Unified Blur Render Feature` settings to get the desired blur effect.

## Use Cases

**Unified Blur** works best with UI components that are part of the `Screen Space - Overlay` canvas. Other canvas types are supported as well, although with some limitations (see the [limitations](#limitations) section).

- Option 1: **UI Image Component with Blur Material**<br>
  Display a blurred version of the screen on a UI Image component. This is useful for creating translucent UI effects.
<br><br>
- Option 2: **Custom Shader with Unified Blur**<br>
  Use the global texture generated by `Unified Blur Render Feature` in your custom shader to create unique effects.

## How It Works

**Unified Blur** works by inserting a custom render pass into the render graph, at a configurable injection point, which copies the back buffer and applies a blur effect to it. Once the pass completes, the blurred result is exposed as a global texture for downstream shaders to sample.

## Troubleshooting

### Blur material shows but no blur effect

- Confirm the `Universal Blur Feature` is added to the renderer data asset used by the **active quality level**. Open `Project Settings → Quality`, check which URP Asset is assigned to the active level, then verify the renderer asset it references is the one carrying the feature. A common pitfall is adding the feature to a desktop renderer while the active quality level points at a mobile renderer (or vice versa).
- Verify post-processing is enabled on the main camera: select the camera, then in the inspector under `Rendering` make sure `Post Processing` is checked. Without it, the blur pass output may not reach the screen as expected.
- If the camera renders to a custom render target, make sure the target format is compatible with the blur pass. A mismatched format (e.g. no alpha, unexpected color space) can produce a transparent or blank result.

### WebGL build shows no blur

WebGL builds typically fall back to the **Mobile renderer data**, not the desktop renderer. If you only added `Universal Blur Feature` to the PC renderer, the WebGL build will run without it.

- Open the URP Asset assigned to the WebGL/Mobile quality level, locate its renderer data asset, and add `Universal Blur Feature` to that asset as well.
- After adding it, rebuild the WebGL player so the updated renderer asset is included.

### Can I configure the blur per-platform?

Yes. Each Quality Level can reference a different URP Asset, and each URP Asset can reference a different renderer data asset. By adding `Universal Blur Feature` to multiple renderer assets, you can tune blur settings (intensity, downsample, iterations) independently per platform or quality preset.

## Limitations

- Limited support for world space or screen space camera canvases.<br>
*To enable this, change the injection point in the Render Feature's settings panel to `BeforeRenderingTransparents`. Note: transparent objects and other canvases will not be visible in this scenario.*