Nessuna descrizione

jst bdfbbead13 Merge branch 'anisus-master'		11 anni fa
.travis.yml	09f4012229 Add Travis integration	13 anni fa
LICENSE	fa6861a5fd Documentation updated	13 anni fa
README.md	8aee0d995b Update README.md to mention resize.Thumbnail.	12 anni fa
converter.go	314cea6612 Avoid temporaries to save some cycles.	12 anni fa
filters.go	a83cb40860 Remove some redundancies.	12 anni fa
resize.go	f3cac2f865 Fix to resize correctly when source image.Bounds().Min is not (0,0)	11 anni fa
resize_test.go	446eea2f7b Remove LUT based filters.	12 anni fa
sinc.go	428642c9f1 initial commit	13 anni fa
sinc_test.go	428642c9f1 initial commit	13 anni fa
thumbnail.go	b744503c5c Add: thumbnail helper function	12 anni fa
thumbnail_test.go	b744503c5c Add: thumbnail helper function	12 anni fa

Resize

Image resizing for the Go programming language with common interpolation methods.

Installation

$ go get github.com/nfnt/resize

It's that easy!

Usage

Import package with

import "github.com/nfnt/resize"

The resize package provides 2 functions:

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.Thumbnail downscales an image preserving its aspect ratio to the maximum dimensions (maxWidth, maxHeight). It will return the original image if original sizes are smaller than the provided dimensions.

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

The provided interpolation functions are (from fast to slow execution time)

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

Which of these methods gives the best results depends on your use case.

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.