No Description

jst 09f4012229 Add Travis integration		13 years ago
.travis.yml	09f4012229 Add Travis integration	13 years ago
LICENSE	fa6861a5fd Documentation updated	13 years ago
README.md	1169a8bfc3 Include samples in README.md	13 years ago
converter.go	a32116ce4a Add documentation	13 years ago
filters.go	82ab8b977c Make kernel the only dependency of convolution1d	13 years ago
resize.go	852f4a47e7 Merge branch 'no-image-shift' of http://github.com/jsummers/nfnt.resize	13 years ago
resize_test.go	da95f74904 go fmt	13 years ago
sinc.go	428642c9f1 initial commit	13 years ago
sinc_test.go	428642c9f1 initial commit	13 years ago

Resize

Image resizing for the Go programming language that includes a few interpolation methods.

Installation

$ go get github.com/nfnt/resize

It's that easy!

Usage

Import package with

import "github.com/nfnt/resize"

Resize creates a scaled image with new dimensions (width, height) using the interpolation function interp. If either width or height is set to 0, it will be set to an aspect ratio preserving value.

resize.Resize(width, height uint, img image.Image, interp resize.InterpolationFunction) image.Image

The provided interpolation functions are

NearestNeighbor: Nearest-neighbor interpolation
Bilinear: Bilinear interpolation
Bicubic: Bicubic interpolation
MitchellNetravali: Mitchell-Netravali interpolation
Lanczos2: Lanczos resampling with a=2
Lanczos3: Lanczos resampling with a=3

Sample usage:

package main

import (
	"github.com/nfnt/resize"
	"image/jpeg"
	"log"
	"os"
)

func main() {
	// open "test.jpg"
	file, err := os.Open("test.jpg")
	if err != nil {
		log.Fatal(err)
	}

	// decode jpeg into image.Image
	img, err := jpeg.Decode(file)
	if err != nil {
		log.Fatal(err)
	}
	file.Close()

	// resize to width 1000 using Lanczos resampling
	// and preserve aspect ratio
	m := resize.Resize(1000, 0, img, resize.Lanczos3)

	out, err := os.Create("test_resized.jpg")
	if err != nil {
		log.Fatal(err)
	}
	defer out.Close()

	// write new image to file
	jpeg.Encode(out, m, nil)
}

Downsizing Samples

Downsizing is not as simple as it might look like. Images have to be filtered before they are scaled down, otherwise aliasing might occur. Filtering is highly subjective: Applying too much will blur the whole image, too little will make aliasing become apparent. Resize tries to provide sane defaults that should suffice in most cases.