Flask service for liquid-rescaling images using ImageMagick inspired by http://contentawaresatan.com/, deployable on AWS API Gateway/Lambda.
- ImageMagick 6 built with liblqr support.
- On macOS these can be installed together with Homebrew by running
brew install imagemagick@6 --with-liblqr.
- On macOS these can be installed together with Homebrew by running
Building Dockerfile.debian will result in an image with the service and its dependencies installed. This can be done with run_debian.sh. Alternately, the service can be run locally with python app.py after installing its dependencies. This starts an HTTP server, and you can begin making requests. Requests are POSTs to the root of the service, e.g. http://localhost:5000/, and are JSON blobs with the following fields:
One of:
image_base64(string) - base64 string of the image to be rescaledimage_url(string) - URL of the image to be rescaled
Any of:
rescale_width(positive int) - optional final width percentage (relative to original width) for the image, default 50%rescale_height(positive int) - optional final height percentage (relative to original height) for the image, default 50%start_width(positive int) - valid only for animated GIFs, optional starting width percentage (relative to original width) for the image, default 100%start_height(positive int) - valid only for animated GIFs, optional starting height percentage (relative to original height) for the image, default 100%
An example request might look like:
{
"image_url": "https://i.imgur.com/NyuJLXs.gif",
"rescale_width": 75,
"rescale_height": 75,
"start_width": 20,
"start_height": 20
}The service can also be deployed to AWS as an API Gateway/Lambda service via Zappa.
The Dockerfile in this repo will download and compile ImageMagick with liblqr support for use with Lambda. Run build_lambda.sh to build the docker image and copy the build contents to the current directory before using Zappa to deploy.
NOTE: sufficiently large images can time out due to API Gateway's maximum timeout, see the issue for a potential solution.