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.
Radius | Javascript | Go |
---|---|---|
20 | ~15ms | ~7.4ms |
First, install Go, set your GOPATH, and make sure $GOPATH/bin is on your PATH.
$ export GOPATH="$HOME/go"
$ export PATH="$PATH:$GOPATH/bin"
Next download the project and build the binary file.
$ go get -u -f github.com/esimov/stackblur-go
$ cd cmd && go build -o $GOPATH/bin/stackblur
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)
The command below will generate the blurred version of the source image.
$ stackblur -in image/sample.png -out image/output.png -radius 10
The cli command supports a -gif
flag, which if set as true it visualize the bluring process by outputting the result into a gif file.
The usage of the API is very simple: you need to expose an image file and a blur radius to the Process
function. This will return the blurred version of the original image.
stackblur.Process(src, blurRadius)
Original image | Blurred image |
---|---|
This project is under the MIT License. See the LICENSE file for the full license text.