Jakob Voß
and 2 contributors

NAME

IIIF - IIIF Image API implementation

DESCRIPTION

Package IIIF provides an implementation of IIIF ImageAPI based on the ImageMagick command line application: Requests to get a specific segment of an image are mapped to command line arguments of ImageMagick to perform the requested segment extraction. See "EXAMPLES" in i3f for examples.

FEATURES

  • Full IIIF ImageAPI 3.0 level 2 compliance

  • Support abbreviated requests (e.g. 300,200 to select size, 90/gray to select rotation and quality...).

  • Web service (IIIF::ImageAPI) and command line client (i3f)

  • fully passing the IIIF Image API Validator with all Level 2 features (except some inexplicable test failures with PDF, WebP, and JP2 format).

  • works with ImageMagick 6 (tested on Ubuntu Linux) and ImageMagick 7 (tested on Windows)

  • 100% test coverage on statement level, (>90% on branch level and >70% on condition level).

INSTALLATION

See also "REQUIREMENTS" in IIIF::Magick for additional installation for optional features.

UNIX

Most Unixes include system Perl by default. You should also install ImageMagick and cpanminus. For instance at Ubuntu Linux:

  sudo apt-get install imagemagick cpanminus

To speed up installation of Perl dependencies of this package, optionally:

  sudo apt-get install libplack-perl libplack-middleware-crossorigin-perl

And for optional support of WebP format:

  sudo apt-get install webp libwebp-dev

Then install IIIF with Perl package manager:

  cpanm IIIF

WINDOWS

Install ImageMagick and Perl, for instance with Chocolatey:

  choco install imagemagick.tool
  choco install strawberryperl

Then install IIIF with Perl package manager:

  cpanm IIIF

MODULES

IIIF::Request

parse and express an IIIF Image API request build of region, size, rotation, quality, and format

IIIF::Magick

get image information and convert images as specified with IIIF Image API request using ImageMagick

IIIF::ImageAPI

provide a Plack web service to access images via IIIF Image API

SCRIPTS

This module provides the command line script i3f to apply IIIF Image API requests without a web service.

SEE ALSO

https://github.com/IIIF/awesome-iiif
Image::Magick
Plack::App::ImageMagick

LICENSE

Copyright (C) Jakob Voß.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Jakob Voß <voss@gbv.de>