content-aware-santa

Flask service for liquid-rescaling images using ImageMagick inspired by http://contentawaresatan.com/, deployable on AWS API Gateway/Lambda.

Examples

->

Requirements

• ImageMagick 6 built with liblqr support.
  • On macOS these can be installed together with Homebrew by running brew install imagemagick@6 --with-liblqr.

Usage

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 rescaled
• image_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
}

Deploying to AWS

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.