Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pierrre/imageserver

Image server toolkit in Go
https://github.com/pierrre/imageserver

golang image server toolkit

Last synced: about 2 months ago
JSON representation

Image server toolkit in Go

Host: GitHub
URL: https://github.com/pierrre/imageserver
Owner: pierrre
License: mit
Created: 2013-04-09T19:30:48.000Z (over 11 years ago)
Default Branch: main
Last Pushed: 2024-04-19T12:17:22.000Z (8 months ago)
Last Synced: 2024-04-19T13:36:41.451Z (8 months ago)
Topics: golang, image, server, toolkit
Language: Go
Homepage:
Size: 15.7 MB
Stars: 2,034
Watchers: 71
Forks: 199
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome - pierrre/imageserver - Image server toolkit in Go (Go)

README

        # Image Server

An image server toolkit in Go (Golang)

[![GoDoc](https://godoc.org/github.com/pierrre/imageserver?status.svg)](https://godoc.org/github.com/pierrre/imageserver)

[![Build Status](https://travis-ci.org/pierrre/imageserver.svg?branch=master)](https://travis-ci.org/pierrre/imageserver)

[![Go Report Card](https://goreportcard.com/badge/github.com/pierrre/imageserver)](https://goreportcard.com/report/github.com/pierrre/imageserver)

:warning: This repository is not maintained anymore.

## Features

- HTTP server

- Resize ([GIFT](https://github.com/disintegration/gift), [nfnt resize](https://github.com/nfnt/resize), [Graphicsmagick](http://www.graphicsmagick.org/))

- Rotate

- Crop

- Convert (JPEG, GIF (animated), PNG , BMP, TIFF, ...)

- Cache ([groupcache](https://github.com/golang/groupcache), [Redis](https://github.com/garyburd/redigo), [Memcache](https://github.com/bradfitz/gomemcache), in memory)

- Gamma correction

- Fully modular

## Examples

- [Simple](https://github.com/pierrre/imageserver/blob/master/examples/simple/simple.go)

- [Advanced](https://github.com/pierrre/imageserver/blob/master/examples/advanced/advanced.go)

- [Cache](https://github.com/pierrre/imageserver/blob/master/examples/cache/cache.go)

- [Groupcache](https://github.com/pierrre/imageserver/blob/master/examples/groupcache/groupcache.go)

- [HTTP Source](https://github.com/pierrre/imageserver/blob/master/examples/httpsource/httpsource.go)

- [Mandelbrot](https://github.com/pierrre/mandelbrot/blob/master/examples/httpserver/httpserver.go) ([see interactive demo](https://mandelbrot.pierredurand.fr)) 

## Demos

These demos use the "advanced" example.

*Click the images to see the URL parameters.*

### Resize

	

		

			Options

			Result

		

	

	

		

			width=200
(preserve aspect ratio)

			

		

		

			height=200
(preserve aspect ratio)

			

		

		

			width=200&height=200
(change aspect ratio)

			

		

		

			width=200&height=200&mode=fit
(fit in 200x200)

			

		

		

			width=200&height=200&mode=fill
(fill 200x200 and crop)

			

		

	

### Rotate

	

		

			Options

			Result

		

	

	

		

			rotation=90
(counterclockwise)

			

		

		

			rotation=45&background=ffaa88
(background)

			

		

	

### Crop

Format: `min_x,min_y|max_x,max_y`

	

		

			Options

			Result

		

	

	

		

			crop=556,111|2156,1711

			

		

		

			crop=956,511|1756,1311

			

		

		

			crop=1252,799|1460,1022

			

		

	

### Animated GIF

	

		

			Original

			Resized

		

	

	

		

			Animated

			

		

		

			Spaceship

			

		

	

### Gamma correction ([more info](http://www.ericbrasseur.org/gamma.html))

	

		

			Original

			Disabled

			Enabled

		

	

	

		

			Dalai Gamma

			

			

		

		

			Gray squares

			

			

		

		

			Random

			

			

		

		

			Rings

			

			

		

		

			Rules / sucks

			

			

		

	

### Resampling

	

		

			Resampling

			Rings

			Large

		

	

	

		

			Nearest neighbor

			

			

		

		

			Box

			

			

		

		

			Linear

			

			

		

		

			Cubic

			

			

		

		

			Lanczos

			

			

		

	

### Quality

	

		

			JPEG quality

			Result

		

	

	

		

			5%

			

		

		

			10%

			

		

		

			50%

			

		

	

### Convert (JPEG to GIF)



## Backward compatibility

There is no backward compatibility promises.

If you want to use it, vendor it.

It's always OK to change things to make things better.

The API is not 100% correct in the first commit.