|
1 |
| -# imaginary [](https://travis-ci.org/h2non/imaginary) [](https://hub.docker.com/r/h2non/imaginary/) [](https://hub.docker.com/r/h2non/imaginary/) [](https://goreportcard.com/report/h2non/imaginary) [](https://fly.io/launch/github/h2non/imaginary) |
| 1 | +# imaginary [](https://travis-ci.org/h2non/imaginary) [](https://hub.docker.com/r/h2non/imaginary/) [](https://hub.docker.com/r/h2non/imaginary/) [](https://goreportcard.com/report/h2non/imaginary) [](https://fly.io/launch/github/h2non/imaginary) |
2 | 2 |
|
3 | 3 | **[Fast](#benchmarks) HTTP [microservice](http://microservices.io/patterns/microservices.html)** written in Go **for high-level image processing** backed by [bimg](https://github.com/h2non/bimg) and [libvips](https://github.com/jcupitt/libvips). `imaginary` can be used as private or public HTTP service for massive image processing with first-class support for [Docker](#docker) & [Fly.io](#flyio).
|
4 | 4 | It's almost dependency-free and only uses [`net/http`](http://golang.org/pkg/net/http/) native package without additional abstractions for better [performance](#performance).
|
@@ -83,7 +83,7 @@ go get -u github.com/h2non/imaginary
|
83 | 83 |
|
84 | 84 | Also, be sure you have the latest version of `bimg`:
|
85 | 85 | ```bash
|
86 |
| -go get -u gopkg.in/h2non/bimg.v1 |
| 86 | +go get -u github.com/h2non/bimg |
87 | 87 | ```
|
88 | 88 |
|
89 | 89 | ### libvips
|
@@ -219,7 +219,7 @@ Assuming that you want to provide a high availability to deal efficiently with,
|
219 | 219 | |==============|
|
220 | 220 | | Balancer |
|
221 | 221 | |==============|
|
222 |
| - | | |
| 222 | + | | |
223 | 223 | / \
|
224 | 224 | / \
|
225 | 225 | / \
|
@@ -305,7 +305,7 @@ Options:
|
305 | 305 | -forward-headers Forwards custom headers to the image source server. -enable-url-source flag must be defined.
|
306 | 306 | -enable-url-signature Enable URL signature (URL-safe Base64-encoded HMAC digest) [default: false]
|
307 | 307 | -url-signature-key The URL signature key (32 characters minimum)
|
308 |
| - -allowed-origins <urls> Restrict remote image source processing to certain origins (separated by commas). Note: Origins are validated against host *AND* path. |
| 308 | + -allowed-origins <urls> Restrict remote image source processing to certain origins (separated by commas). Note: Origins are validated against host *AND* path. |
309 | 309 | -max-allowed-size <bytes> Restrict maximum size of http image source (in bytes)
|
310 | 310 | -certfile <path> TLS certificate file path
|
311 | 311 | -keyfile <path> TLS private key file path
|
@@ -546,7 +546,7 @@ Image measures are always in pixels, unless otherwise indicated.
|
546 | 546 | - **url** `string` - Fetch the image from a remote HTTP server. In order to use this you must pass the `-enable-url-source` flag.
|
547 | 547 | - **colorspace** `string` - Use a custom color space for the output image. Allowed values are: `srgb` or `bw` (black&white)
|
548 | 548 | - **field** `string` - Custom image form field name if using `multipart/form`. Defaults to: `file`
|
549 |
| -- **extend** `string` - Extend represents the image extend mode used when the edges of an image are extended. Allowed values are: `black`, `copy`, `mirror`, `white` and `background`. If `background` value is specified, you can define the desired extend RGB color via `background` param, such as `?extend=background&background=250,20,10`. For more info, see [libvips docs](http://www.vips.ecs.soton.ac.uk/supported/8.4/doc/html/libvips/libvips-conversion.html#VIPS-EXTEND-BACKGROUND:CAPS). |
| 549 | +- **extend** `string` - Extend represents the image extend mode used when the edges of an image are extended. Defaults to `copy`. Allowed values are: `black`, `copy`, `mirror`, `white`, `lastpixel` and `background`. If `background` value is specified, you can define the desired extend RGB color via `background` param, such as `?extend=background&background=250,20,10`. For more info, see [libvips docs](http://www.vips.ecs.soton.ac.uk/supported/8.4/doc/html/libvips/libvips-conversion.html#VIPS-EXTEND-BACKGROUND:CAPS). |
550 | 550 | - **background** `string` - Background RGB decimal base color to use when flattening transparent PNGs. Example: `255,200,150`
|
551 | 551 | - **sigma** `float` - Size of the gaussian mask to use when blurring an image. Example: `15.0`
|
552 | 552 | - **minampl** `float` - Minimum amplitude of the gaussian filter to use when blurring an image. Default: Example: `0.5`
|
|
0 commit comments