Awesome
iiif-tiler
A Java based static IIIF tile generator. Static IIIF Tiles can be stored on a web service and provide a zoomable service with a compatible IIIF image viewers. This is known as a level 0
image service.
Usage:
By default and without configuration the iiif-tiler will generate version 2.0 image tiles in the iiif directory. To run this program do the following:
- Download the
iiif-tiler.jar
from the releases page. - Save the
iiif-tiler.jar
to a directory where you would like to store the image tiles - Drag an image on to the iiif-tiler.jar in the Finder or Windows interface.
- This will generate the IIIF tiles in a
iiif
directory.
Alternatively from the command line you can run the following:
java -jar target/iiif-tiler.jar images/67352ccc-d1b0-11e1-89ae-279075081939.jpg
Options
This generates tiles that are compatible with IIIF Version 2 and Version 3.0. This can be configured from the command line by passing -version 3
parameter. A full list of parameters is below:
$ java -jar target/iiif-tiler.jar -help
usage: iiif-tiler
-help Show this help message
-output <arg> Directory where the IIIF images are generated. Default: iiif
-identifier <arg> The root of the identifier in the info.json. The filename directory is appended. Default: `http://localhost:8887/iiif/`
-tile_size <arg> set the tile size. Default is 1024
-version <arg> set the IIIF version. Default is 2.1.1 and options are 2 or 3
-zoom_levels <arg> set the number of zoom levels for this image. The default is 5
Releases
The releasable jar file with all of the dependencies is in target/iiif-tiler.jar
. The basic code without dependencies is in target/iiif-tiler-$version.jar
.
To release a new version to maven central create a new release on Github or run mvn clean deploy
.