bild

import "github.com/anthonynsimon/bild"

Simple image processing in Go with parallel processing support.

Package bild provides a collection of common image processing functions. The input images must implement the image.Image interface and the functions return an *image.RGBA.

The aim of this project is simplicity in use and development over high performance, but most algorithms are designed to be efficient and make use of parallelism when available. It is based on standard Go packages to reduce dependency use and development abstractions.

Install

bild requires Go version 1.4 or greater.

go get -u github.com/anthonynsimon/bild

Documentation

http://godoc.org/github.com/anthonynsimon/bild

Basic example:

package main

import "github.com/anthonynsimon/bild"

func main() {
	img, err := bild.Open("filename")
	if err != nil {
		panic(err)
	}

	result := bild.Invert(img)

	if err := bild.Save("filename", result, bild.PNG); err != nil {
		panic(err)
	}
}

Output examples

Adjustment

Brightness

result := bild.Brightness(img, 0.25)

Contrast

result := bild.Contrast(img, -0.5)

Gamma

result := bild.Gamma(img, 2.2)

Blend modes

Add

result := bild.Add(bg, fg)

ColorBurn

result := bild.ColorBurn(bg, fg)

ColorDodge

result := bild.ColorDodge(bg, fg)

Darken

result := bild.Darken(bg, fg)

Difference

result := bild.Difference(bg, fg)

Divide

result := bild.Divide(bg, fg)

Exclusion

result := bild.Exclusion(bg, fg)

Lighten

result := bild.Lighten(bg, fg)

LinearBurn

result := bild.LinearBurn(bg, fg)

LinearLight

result := bild.LinearLight(bg, fg)

Multiply

result := bild.Multiply(bg, fg)

Normal

result := bild.Normal(bg, fg)

Opacity

result := bild.Opacity(bg, fg, 0.5)

Overlay

result := bild.Overlay(bg, fg)

Screen

result := bild.Screen(bg, fg)

SoftLight

result := bild.SoftLight(bg, fg)

Subtract

result := bild.Subtract(bg, fg)

Blur

BoxBlur

result := bild.BoxBlur(img, 3.0)

GaussianBlur

result := bild.GaussianBlur(img, 3.0)

Effects

EdgeDetection

result := bild.EdgeDetection(img, 1.0)

Emboss

result := bild.Emboss(img)

Grayscale

result := bild.Grayscale(img)

Invert

result := bild.Invert(img)

Median

result := bild.Median(img, 10.0)

Sharpen

result := bild.Sharpen(img)

Sobel

result := bild.Sobel(img)

Resize

Nearest Neighbor

result := bild.Resize(img, newWidth, newHeight, bild.NearestNeighbor)

Box Interpolation

result := bild.Resize(img, newWidth, newHeight, bild.Box)

Linear Interpolation

result := bild.Resize(img, newWidth, newHeight, bild.Linear)

Transform

FlipH

result := bild.FlipH(img)

FlipV

result := bild.FlipV(img)

License

This project is licensed under the MIT license. Please read the LICENSE file.

Contribute

Want to hack on the project? Any kind of contribution is welcome!
Simply follow the next steps:

• Fork the project.
• Create a new branch.
• Make your changes and write tests when practical.
• Commit your changes to the new branch.
• Send a pull request, by the way you are awesome.