Simple service for image processing

Image processing service based on Sharp and Micro.

How to run

$ yarn install
$ yarn run start

Deployment

We recommend to use Now together with Now CDN. See Now CDN documentation for setup.

To deploy this, run the following command.

$ now barnebys/bimp

Enter a secret and a no image url. Leave the env empty to disable signed url's and/or a no image url.

To specify the env upon deployment add the -e flag

$ now barnebys/bimp -e SECRET=MySecret -e NOT_FOUND_IMAGE_URL=https://someurl.com/image.jpg

How to use

https://<your-fqdn>/<url-or-path>?w=<width>&h=<height>&crop=<mode>

Available parameters

| Parameter | Function | | ------------- | ------------- | | w | Image width | | h | Image height | | crop | Cropping mode | | extract | Extract a region of the image | | trim | Trim "boring" pixels from all edges | | pad | Add padding | | bg | Add a color to replace alpha or padded area | | s | Signed hash |

Resizing

Resize image to width x height. When both height and width are use the image will be cropped to the specified size using center as default.

Cropping

Crop the resized image to the exact specified size. Default is center.

Possible attributes are north, northeast, east, southeast, south, southwest, west, northwest, center, centre, entropy and attention.

Other strategies for corpping are:

entropy: focus on the region with the highest Shannon entropy. attention: focus on the region with the highest luminance frequency, colour saturation and presenece of skin tones..

Extract

Extract a region of the image using using left, top, width and height. Set left and top as offset and width and height for dimensions to extract.

extract=<left>,<top>,<width>,<height> extract=0,0,500,200

Trim

Trim "boring" pixels from all edges using a tolerance (maximum of 99).

trim=10

Pad

Add padding to the image

pad=50

Background

Replace alpha channel, or padded area, with a color.

bg=ffffff

bg=000000f1

Clients

Bimp PHP Client

Roadmap

• More sharp features
• Add S3