- Notifications
You must be signed in to change notification settings - Fork25
A library for progressive blurs in SwiftUI.
License
joogps/Glur
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
A SwiftUI library that uses Metal to display efficient progressive blurs, just like the ones used by Apple. Try it todayon the App Store.
This repository is a Swift package, so just include it in your Xcode project and target underFile > Add package dependencies. Then,import Glur to the Swift files where you'll be using it.
Note
While Glur is supported on older platforms, it will only utilize the Metal implementation of the blur effect oniOS 17.0 and later, macOS 14.0 and later, and tvOS 17.0 and later. Otherwise, it will present a worse, compatibility effect that should be tested by the developer before being used in production.
The Metal implementation is not available on watchOS, and therefore the compatibility effect will be presented on this platform by default.
You can add a glur effect with the following modifier:
.glur()
Here are all optional parameters:
.glur(radius:8.0, // The total radius of the blur effect when fully applied. offset:0.3, // The distance from the view's edge to where the effect begins, relative to the view's size. interpolation:0.4, // The distance from the offset to where the effect is fully applied, relative to the view's size. direction:.down // The direction in which the effect is applied.)
Warning
When being used in the iOS simulator, SwiftUI shader effects may not be displayed if the view exceeds 545 points in either dimension. Please note that, on a physical device, the effect should work as intented.
This project builds on aproof of concept developed in June of 2023, right after WWDC.
It makes use of Apple's new simplifiedShader API for SwiftUI. First, I coded a Metal shader that produced a gaussian blur for the modified view with the correct gaussian weights distribution, efficiently. Then, I modified it slightly to vary the blur radius over the vertical or horizontal axis given the offset, interpolation and direction values.
Warning
Given that the shader is applied through Apple's own Shader API for SwiftUI, it is restricted by the limitations imposed by that API. This means that Glurcan only be applied to pure SwiftUI views, excluding UIKit-backed views, such asScrollView.
Tip
If you want to learn how to write your first Metal shader with SwiftUI, check outthis tutorial that I wrote for theCindori blog.
You can run a demo of Glur in your device or simulator through theGlurDemo project in this repository.
About
A library for progressive blurs in SwiftUI.