Adding `blurhash` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add blurhash

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

blurhash = "0.2.3"

The blurhash library will be automatically available globally. Read the blurhash library documentation.

Back to the crate overview.

Readme

blurhash-rs

A pure Rust implementation of Blurhash.

Blurhash is an algorithm written by Dag Ågren for Wolt (woltapp/blurhash) that encodes an image into a short (~20-30 byte) ASCII string. When you decode the string back into an image, you get a gradient of colors that represent the original image. This can be useful for scenarios where you want an image placeholder before loading, or even to censor the contents of an image a la Mastodon.

🚴 Usage

Add blurhash to your Cargo.toml:

[dependencies]
blurhash = "0.2.3"

By default, the fast-linear-to-srgb is enabled. This improves decoding performance by about 60%, but has a memory overhead of 8KB. If this overhead is problematic, you can disable it by instead specifying the following to your Cargo.toml:

[dependencies]
blurhash = { version = "0.2.3", default-features = false }

Encoding

use blurhash::encode;
use image::GenericImageView;

fn main() {
  // Add image to your Cargo.toml
  let img = image::open("octocat.png").unwrap();
  let (width, height) = img.dimensions();
  let blurhash = encode(4, 3, width, height, &img.to_rgba().into_vec());
}

Decoding

use blurhash::decode;

let pixels = decode("LBAdAqof00WCqZj[PDay0.WB}pof", 50, 50, 1.0);

Licence

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

Adding blurhash library as a dependency

Adding `blurhash` library as a dependency