Write iiif-image tiles using ImageMagick
Project description
magick_tile
This python script relies on Imagemagick to efficiently create derivative tiles of a very large image, and structure them into directories compliant with IIIF Level 0 specification for static sites.
This takes inspiration heavily from https://github.com/zimeon/iiif/blob/master/iiif_static.py, but uses ImageMagick rather than Pillow in order to speed up generation at the expense of a less flexible treatment of images.
Prerequisites
- Python 3
- Imagemagick must be available on your path
Run
python3 magick_tile.py --help
> Usage: magick_tile.py [options] file (-h for help)
>
> IIIF Image API Level-0 static file generator
>
> Options:
> -h, --help show this help message and exit
> -o OUTPUT, --output=OUTPUT
> Destination directory for tiles
> -i IDENTIFIER, --identifier=IDENTIFIER
> Image identifier to be written to final info.json
> (e.g. https://example.com/iiif/my_image)
> -t TILESIZE, --tilesize=TILESIZE
> Tile size to produce [default 256]
python3 magick_tile.py -o apple/ -i "https://example.com/iiif/apple" apple.jpg
This will create and populate the specified output directory with tiles from a given image.
N.b. because several of the Imagemagick utilities called here already utilize multiple cores, returns for running this script in parallel diminish rapidly.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.