URP UI Blur Pro

Real-time frosted glass and background blur for Unity 6 (URP 17+), built natively on the RenderGraph API. Create modern blurred UI panels, world-space interfaces, and dynamic glass surfaces without camera stacking, GrabPass, or custom render textures. Supports six blur algorithms, multiple simultaneous presets, and runtime control. Each of the six blur algorithms writes a global BlurredBackground* texture that is sampled directly by the included frosted-glass shaders.

Feature Highlights

• 6 real-time blur algorithms
• Multiple simultaneous presets
• Screen Space Overlay / Camera / World Space support
• Dynamic 3D glass refraction
• Native RenderGraph implementation
• Setup Wizard for one-click installation
• Runtime API support
• Resolution-independent blur scaling

Requirements

• Unity 6000.0 or later
• Universal Render Pipeline 17.0.0 or later
• RenderGraph enabled (Project Settings → Graphics → URP Global Settings)

Quick Start

1. Open the Setup Wizard via Tools → URPUIBlur → Setup Wizard (it also opens automatically the first time the package is imported)
2. Tick the URP Renderer assets you want to add the feature to and click Add Blur Feature
3. A default Screen Space Overlay preset is assigned automatically
4. Add a UI Image and assign the included UI_Blur_Universal material
5. Set the material’s Canvas Mode to match your Canvas render mode

Canvas Space Types

Duplicate rule: If two presets share the same Space Type, only the first active one executes. A warning is shown in the Inspector and a runtime guard skips duplicates.

Blur Methods

Parameters

All methods

Dual Kawase

Custom Kawase / Poisson Disk

Gaussian Separable / Tent Hex

Radial

Performance tip

Each active preset runs its full pass chain every frame, regardless of whether any UI is currently visible. Only add presets for the space types you actually use — if your project only uses Screen Space Overlay, there is no reason to keep a World Space preset in the list.

UI_Blur_Universal Shader

For use with UI Image components and Canvas panels.

WorldObject Shader

For 3D world-space glass meshes (windows, floors, panels). Requires a preset with Space Type set to World Objects.

Runtime API

Toggle presets

// Enable or disable all presets targeting a space type
Blur.SetPresetsActive(CanvasSpaceType.ScreenSpaceCamera, false);
Blur.SetPresetsActive(CanvasSpaceType.OverlayBeforePostProcessing, true);

// Subscribe to the event fired when a preset's active state changes
Blur.OnPresetActiveChanged += preset =>
    Debug.Log($"{preset.name} is now {(preset.isActive ? "active" : "inactive")}");

Individual presets can also be toggled directly via BlurPreset.isActive.

Read and modify presets

// Get the first preset for a given space type (returns null if not found)
BlurPreset overlay = Blur.GetPreset(CanvasSpaceType.OverlayBeforePostProcessing);
if (overlay != null) overlay.blurOffset = 2.5f;

// Get all presets as a snapshot list
List<BlurPreset> all = Blur.GetAllPresets();
foreach (var p in all)
    Debug.Log($"{p.name}: {p.blurMethod}, active={p.isActive}");

Intensity — smooth fade without pop-in

SetIntensity scales all continuous parameters (blurOffset, gaussianRadius, radialRadius) by a multiplier each frame. Unlike toggling isActive, intensity 0 keeps the pass alive so there is no one-frame black flash when the blur returns.

// Instant set
Blur.SetIntensity(CanvasSpaceType.OverlayBeforePostProcessing, 0.5f);

// Read current value
float current = Blur.GetIntensity(CanvasSpaceType.OverlayBeforePostProcessing);

// Smooth fade in Update or a coroutine
void Update()
{
    float target = _menuOpen ? 1f : 0f;
    float current = Blur.GetIntensity(CanvasSpaceType.OverlayBeforePostProcessing);
    Blur.SetIntensity(
        CanvasSpaceType.OverlayBeforePostProcessing,
        Mathf.MoveTowards(current, target, Time.deltaTime * 3f));
}

Note: Intensity affects only continuous spatial parameters. Discrete values (iterations, taps, radialTaps) are never fractional and are not scaled.

Folder Structure

Assets/URPUIBlur/
├── Runtime/
│   ├── Scripts/            Blur.cs, BlurPreset.cs, *BlurPass.cs
│   ├── Shaders/            All .shader files
│   └── URPUIBlur.Runtime.asmdef
├── Materials/
│   ├── UI_Blur_Universal.mat
│   └── Blur_WorldSurface.mat
├── Editor/
│   ├── BlurEditor.cs       Custom Inspector for Blur (Renderer Feature)
│   ├── BlurScriptable.cs   Custom Inspector for BlurPreset
│   ├── BlurSetupWizard.cs  Setup Wizard window
│   └── URPUIBlur.Editor.asmdef
├── Presets/
│   └── UI-Overlay.asset    Default preset (auto-assigned by Setup Wizard)
├── Samples~/
│   └── Demo/               Interactive comparison scene
└── Documentation~/
    ├── CHANGELOG.md
    └── README.md

Troubleshooting

UI panel is black / shows no blur

• Confirm the Blur Renderer Feature is added and enabled on the active URP Renderer asset
• Check that the preset’s Space Type matches the Canvas render mode
• Check that the material’s Canvas Mode dropdown matches the Canvas render mode

Two presets on the same Space Type — only one works

• This is by design. Each Space Type writes to one global texture; duplicates are skipped at runtime (first active preset wins). Assign different Space Types if you need multiple simultaneous blur effects.

Blur is stretched horizontally

• This is fixed in Gaussian and Tent/Hex passes via _TargetTexelSize. If you see stretching, confirm you are using the included shader files and not an older version.

Performance is poor on mobile

• Switch to Dual Kawase (lowest cost per quality)
• Increase Downsample to 4
• Reduce Iterations to 2

Setup Wizard does not appear

• Open it manually via Tools → URPUIBlur → Setup Wizard
• If the wizard shows no renderers, create a URP Universal Renderer asset first: Assets → Create → Rendering → URP Universal Renderer

License

See LICENSE included with this package.