暫無描述
nfnt 891127d8d1 Fix alpha pre-multiplication. 8 年之前
.travis.yml Go >=1.1 is needed for this package. 10 年之前
LICENSE Documentation updated 12 年之前
README.md Mention optimized access for image.NRGBA, image.NRGBA64 in README. 9 年之前
converter.go Fix alpha pre-multiplication. 8 年之前
converter_test.go Add unit tests for converter.go 10 年之前
filters.go Dst pixel coordinate fix 9 年之前
nearest.go Add functions for nearest-neighbor resize of NRGBA, NRGBA16. 9 年之前
nearest_test.go Optimize YCbCr image resize 10 年之前
resize.go Use RGBA, RGBA64 image types as output. 9 年之前
resize_test.go Use RGBA, RGBA64 image types as output. 9 年之前
thumbnail.go Add: thumbnail helper function 11 年之前
thumbnail_test.go Add: thumbnail helper function 11 年之前
ycc.go Fix YCC SubImage. 10 年之前
ycc_test.go Fix error in YCC PixOffset and SubImage. 10 年之前

README.md

Resize

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

Build Status

Installation

$ go get github.com/nfnt/resize

It’s that easy!

Usage

This package needs at least Go 1.1. 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)

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

Caveats

  • Optimized access routines are used for image.RGBA, image.NRGBA, image.RGBA64, image.NRGBA64, image.YCbCr, image.Gray, and image.Gray16 types. All other image types are accessed in a generic way that will result in slow processing speed.
  • JPEG images are stored in image.YCbCr. This image format stores data in a way that will decrease processing speed. A resize may be up to 2 times slower than with image.RGBA.

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.

Artificial sample

Original image Rings


Nearest-Neighbor

Bilinear

Bicubic

Mitchell-Netravali

Lanczos2

Lanczos3

Real-Life sample

Original image
Original


Nearest-Neighbor

Bilinear

Bicubic

Mitchell-Netravali

Lanczos2

Lanczos3

License

Copyright © 2012 Jan Schlicht janschlicht@gmail.com Resize is released under a MIT style license.