A lightweight, App Store-safe library for adding dynamic, GPU-accelerated blurs and masks to your SwiftUI views.

AemiSDR is designed to work seamlessly with ScrollView and other dynamic content, providing high-performance effects with a simple, modifier-based API.

• Variable Blur: Apply blurs as a gradient.
• Alpha Masks: Fade view content with alpha masks.
• Advanced Shapes: Use standard rounded rectangles or iOS-style superellipses (squircles).
• Optimized: Effects are powered by pre-compiled Metal shaders and cache their results to ensure smooth performance.

• iOS 14+
• Swift 6.2 Toolchain
• SwiftUI

Add the package in Xcode (File → Add Package Dependencies…) using the repository URL, or add it to your Package.swift:

.dependencies = [
    .package(url: "https://github.com/Aemi-Studio/AemiSDR.git", branch: "main")
]

Apply blurs and masks directly to your views. The library is perfect for fading the edges of a ScrollView, as shown in the project's preview:

import SwiftUI
import AemiSDR

struct AemiSDRPreview: View {
    var body: some View {
        ScrollView(showsIndicators: false) {
            LazyVStack(spacing: 16) {
                ForEach(1 ... 6, id: \.self) { index in
                    Image("Image_\(index)", bundle: .module)
                        .resizable()
                        .aspectRatio(contentMode: .fit)
                        .clipShape(clippingShape)
                }
            }
            .padding(.horizontal)
        }
        .fancyBlur()
    }

    private var clippingShape: some Shape {
        .rect(cornerRadius: UIScreen.displayCornerRadius - 16)
    }
}

private extension View {
    @ViewBuilder func fancyBlur() -> some View {
        if #available(iOS 15.0, *) {
            roundedRectMask()
                .verticalEdgeMask(height: 32)
                .roundedRectBlur()
                .verticalEdgeBlur(height: 48, maxBlurRadius: 5)
        } else {
            self
        }
    }
}

The library provides four main SwiftUI modifiers (iOS 15+):

• roundedRectBlur(...): An overlay blur shaped like a rounded rectangle or superellipse.
• verticalEdgeBlur(...): A blur applied only to the top and bottom edges of a view.
• roundedRectMask(...): An alpha mask to fade content, shaped as a rounded rectangle or superellipse.
• verticalEdgeMask(...): An alpha mask for the top and bottom edges, perfect for scroll views.

All modifiers come with sensible defaults and can be customized for corner style, transition smoothness, and more.

The Metal shader source files are located in Sources/AemiSDR/Shaders/. If you make any changes to these files, you must recompile them into the AemiSDR.metallib library.

To do so, run the following command from the root of the project:

./.compileShaders.swift

This software is provided under the Mozilla Public License 2.0.