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 dependecy 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)

Transform

FlipH

result := bild.FlipH(img)

FlipV

result := bild.FlipV(img)