django-imagequery

Image manipulation written like well known QuerySet operations


Keywords
django, imagequery, PIL
License
BSD-3-Clause
Install
pip install django-imagequery==0.3.1

Documentation

With ImageQuery you are able to write image manipulations without needing
to learn some low-level API for the most use cases. It allows you to:
 * simple manipulation like rescaling
 * combining images
 * handling text (note: fonts must be available locally)
 * even more like creating drop shadows (using the alpha mask)

ImageQuery basicly provides an API similar to the well known QuerySet API,
which means:
 * Most methods just return another ImageQuery
 * Every bit of your image manipulation chain can be used/saved
 * Image manipulations are lazy, they are only evaluated when needed

Some examples:

# load the image
iq = ImageQuery('some/file.png')
# scale it to 100x200 max
iq = iq.scale(100, 200)
iq.save('scaled/version.png')
# save the scaled version including a simple watermark
# note: this does not chenge "iq"
iq.paste('watermark.png', 'center', 'center').save('watermarked/version.png')
# create a grayscale version (without watermark of course)
iq = iq.grayscale()
iq.save('scaled_grayscale/version.png')

In addition ImageQuery provides some nice tools to make handling images
even more easy:
 * support for Django storage API
 * base class to manage multiple image formats
 * included template tags (using formats) and filters (lowlevel)