https://github.com/glenrobson/iiif-tiler

Java based static IIIF tile generator
https://github.com/glenrobson/iiif-tiler

Last synced: about 1 month ago
JSON representation

Java based static IIIF tile generator

• Host: GitHub
• URL: https://github.com/glenrobson/iiif-tiler
• Owner: glenrobson
• License: apache-2.0
• Created: 2019-08-07T00:28:41.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-06-21T23:21:27.000Z (6 months ago)
• Last Synced: 2024-11-15T10:43:02.867Z (about 1 month ago)
• Language: Java
• Size: 24.3 MB
• Stars: 21
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-iiif - iiif-tiler - Java library for generating static IIIF tiles (compliant with the V2.1 and 3.0 of the IIIF Image API). (Image API Libraries / Image viewers (Image API only))

README

        
[![Build Status](https://travis-ci.org/glenrobson/iiif-tiler.svg?branch=master)](https://travis-ci.org/glenrobson/iiif-tiler)

# 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:

 1. Download the `iiif-tiler.jar` from the [releases page](https://github.com/glenrobson/iiif-tiler/releases). 

 2. Save the `iiif-tiler.jar` to a directory where you would like to store the image tiles

 3. Drag an image on to the iiif-tiler.jar in the Finder or Windows interface.

 4. 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](https://iiif.io/api/image/2.1/) and [Version 3.0](https://iiif.io/api/image/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         Directory where the IIIF images are generated. Default: iiif

 -identifier     The root of the identifier in the info.json. The filename directory is appended. Default: `http://localhost:8887/iiif/`

 -tile_size      set the tile size. Default is 1024

 -version        set the IIIF version. Default is 2.1.1 and options are 2 or 3

 -zoom_levels    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`.