stackblur-go

Go port of Mario Klingemann's Stackblur algorithm.

Stackblur is a compromise between Gaussian blur and Box blur, but it creates much better looking blurs than Box blur and it is ~7x faster than Gaussian blur.

Comparing to the Javascript implementation the Go version is at least 50% faster (depending on the image size and blur radius), applied on the same image with the same bluring radius.

Benchmark

Installation

$ go install github.com/esimov/stackblur-go/cmd/stackblur@latest

CLI example

The provided CLI example supports the following flags:

$ stackblur --help

Usage of stackblur:
  -gif
    	Output Gif
  -in string
    	Source
  -out string
    	Destination
  -radius int
    	Radius (default 20)

$ stackblur -in image/sample.png -out image/output.png -radius 10

API

The usage of the API is very simple: it exposes a single public Process function which requires a destination and a source image together with a blur radius. The blured image will be encoded into the destination image.

stackblur.Process(dst, src, blurRadius)

Results

| Original image | Blurred image | |:--:|:--:| | | |

License

This project is under the MIT License. See the LICENSE file for the full license text.