resizer

Specification

• Keeps aspect ratio.
• Doesn't scale up, but scale down.
• Reflect orientation tag in EXIF of JPEG to pixels of resized image.
• Drops meta data.

Installation

Download binary for your environment from latest release, or go get like:

go get -u github.com/syoya/resizer/...

Usage

resizer

Environment variables

• ENVIRONMENT: development or production. In default production
• GOOGLE_AUTH_JSON: The service account JSON of Google Cloud.
• RESIZER_ACCOUNT: Path to the file of Google service account JSON.
• RESIZER_BUCKET: Bucket name of Google Cloud Storage to upload the resized image.
• RESIZER_CONNECTIONS: Max simultaneous connections to be accepted by server. When 0 or less is specified, the number of connections isn't limited.
• RESIZER_DSN: Data source name of database to store resizing information.
• RESIZER_HOST: Hosts of the image that is allowed to resize. When this value isn't specified, all hosts are allowed.
• RESIZER_PORT: Port to be listened.
• RESIZER_PREFIX: Object prefix of Google Cloud Storage.
• RESIZER_VERBOSE: Verbose output.

HTTP(S) API

Examples

curl http://your.host.name/?url=http%3A%2F%2Fexample.com%2Fimage.jpeg&width=800

Endpoint

GET http://your.host.name/

Parameters

• Joint key=value parameters with &.
  • The value should be URL-encoded.

url

The URL of a resizing image. Required. The host of the URL should be specified with hosts in running option.

width, height

The size of resized image in pixel. In default 0.

• An integer greater than or equal to 0.
• Specify 0 to both of width and height isn't allowed.
• When width is 0. width is guessed with height and the aspect ratio of the source image .
• When height is 0. height is guessed with width and the aspect ratio of the source image .
• The specified size is greater than the size of source image, resizer doesn't resize.

method

How to resize. contain or cover. Optional. In default contain.

• When width or height is 0, specified method is ignored and resizer resizes with contain method.
• When specifies contain, resizer resizes image to fall into the specified size and doesn't clip.
• When specifies cover, resizer resizes image to fill all pixels in the specified size and clips the outer of the specified size.

format

The format of the resized image. jpeg or png or gif. In default jpeg.

quality

The quality of the resized image as jpeg. 0〜100. In default 100.

• Ignored, when format isn't jpeg.

Response

Success

• When resizes first time, response resized image data with the code as 2xx.
• When resizes second (or third or forth) time, response with code as 3xx and redirects to the storage URL of that the resized image was saved.

Error

Response with the code as 4xx, and the reason will be written in the body.