Feature #1426

API: display image smaller size

Added by Bernhard Koschicek 5 months ago. Updated 25 days ago.

In Progress
Target version:
Start date:
Estimated time:


Some images can be very large in file size. Since the API should also provide data for different front-ends, it can be useful, that API clients can forcefully downsize images. One idea is, that the normal display path will show the full image. With parameters the client can demand a 30% size version of the image. Or the image pixel size will be downsized to a number like 1200px. The path will be /api/display/image.jpg?size=30 or /api/display/hsize=1200 or /api/display/vsize=1200 (horizontal and vertical size)

If python can not do it by itself, maybe the Pillow package can do this.

Related issues

Related to Feature #1280: Picture PreviewAssigned2021-04-02Actions
Follows Feature #1492: Image Processing In Progress2021-04-01Actions



Updated by Alexander Watzinger 5 months ago


Updated by Alexander Watzinger 5 months ago

My take on this is that we will need some image processing in OpenAtlas sooner or later anyway. I linked a related issue about previews and although nobody wrote a ticket so far some people mentioned they would like a slideshow and similar. Once we have solved this for OpenAtlas (thumbnails, previews, slideshows, ...) we could decide if this is sufficient for the API too or if we would need extra functionality there.

What would be needed now is a volunteer who delves into this topic and drafts a solution proposal which we can than discuss together ;)
I started a draft and everybody is welcomed to join/take over: Image processing


Updated by Bernhard Koschicek 4 months ago

I tried to play around with Pillow, but sadly couldn't make it work on my machine.


Updated by Bernhard Koschicek 4 months ago

pillow has no buster package... I looked into pythonmagick ( and found Wand ( with following documentation:
Alex, can you look at the package and tell me, if this will work with OA installations?


Updated by Bernhard Koschicek about 2 months ago

If now more and more projects asks for IIIF standard, maybe it is better to got straight to IIIF implementation?


Updated by Bernhard Koschicek about 1 month ago

  • Follows Feature #1492: Image Processing added
  • Start date changed from 2020-12-01 to 2021-04-02

Updated by Bernhard Koschicek 25 days ago

  • Status changed from Acknowledged to In Progress

Feature is done, testing and mypy in progress

Also available in: Atom PDF