Skip to content
This repository has been archived by the owner on Jan 6, 2022. It is now read-only.
/ magick_tile Public archive

Script to quickly tile a large image into IIIF-0 compliant images

License

Notifications You must be signed in to change notification settings

cmu-lib/magick_tile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

magick_tile

PyPi version

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

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.


Matthew Lincoln

About

Script to quickly tile a large image into IIIF-0 compliant images

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages