Skip to content

Decode BlurHash strings to SwiftUI MeshGradient or Color with various customization options.

License

Notifications You must be signed in to change notification settings

daprice/BlurHashViews

Repository files navigation

BlurHashViews

Decode BlurHash strings to SwiftUI Color or MeshGradient with various customization options.

Overview

BlurHash (blurha.sh) is a way of representing placeholders for images using a compact string representation. Existing implementations focus on decoding a BlurHash to a small image that can be used as a placeholder. This package allows you to create native SwiftUI views directly from BlurHash encoded strings.

Open Sources/BlurHashViews/Previews.swift in Xcode 16 for an interactive SwiftUI preview with example views of BlurHashes from social media sites, allowing you to try different customization options for how they are displayed, including:

  • Change the punch argument to control the contrast between colors in the BlurHash.
  • Decode the BlurHash at different detail levels for more or less complex mesh gradients.
  • Adjust the smoothing and color space options provided by SwiftUI MeshGradient.

There's also a decoder that returns the mesh points and colors so you can customize it in code however you want – animate the points to make it swirl, find the most intense color in the image, make custom transitions… whatever you can dream up!

Compatibility

  • iOS/tvOS 13+, macOS 10.15+, watchOS 6+ – Create a SwiftUI Color from the average of a BlurHash.
  • iOS/tvOS 18+, macOS 15+, watchOS 11+ – Create a MeshGradient from the colors in a BlurHash.

For previous operating systems, the original BlurHash library provides a UIImage-based decoding implementation.

About

Decode BlurHash strings to SwiftUI MeshGradient or Color with various customization options.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages