IIIF Image API

Overview

The Image API provides for a standardized way to request and deliver images. Having this standardization allows both browser and server applications to reuse software and provide a consistent experience for requesting images.

Presentation available on SlideShare.

Presenter

Glen Robson, IIIF Technical Coordinator

National Library of Wales links:

• Digitisation
• Newspapers

Pre-IIIF Viewers

Example from Ben Albritton's blog Fellow Travelers: The Canterbury Tales and IIIF

Image API

Latest version of the Image API is available at http://iiif.io/api/image/2.1/.

Image API demonstration

Many of these examples are from Tom Crane's excellent blog series.

• Original oil painting from the Wellcome Trust
• Example API calls
• Tile Explorer
• Example info.json

Image API Exercises

Look at the following and play around with the parameters:

• Jason Ronallo's detailed example
• Tom Cranes example
• UCD image cropper

Questions

In pairs answer the following questions:

1. Given the following image URL: https://iiif.lib.ncsu.edu/iiif/mc00198-008-ff0051-000-001_0001/full/512,/0/default.jpg what would be the URL for the info.json?
2. What is the width and height of the biggest size image?
3. Construct a URL that:
   • Shows the full image
   • is 512px wide
   • is upside down
   • gray scale
   • has a format of png
4. What formats can you request for this image?

Looking at the IIIF API Specification https://iiif.io/api/image/2.1/

1. What status code should be returned if you ask for a format the image server doesn't support?
2. What does max image size mean? How does it differ to full? When might you use this?

Given the following info.json:

{
    "@context": "http://iiif.io/api/image/2/context.json",
    "@id": "http://example.com/iiif/image/2",
    "@type": "iiif:Image",
    "protocol": "http://iiif.io/api/image",
    "width": 400,
    "height": 400,
}

and image:

HINT: remember 0,0 is the top left of the image.

1. What would the URL be to cut out the green quarter?
2. What would the URL be to cut out the white quarter?

Bonus points:

Given the following info.json: https://iiif.lib.ncsu.edu/iiif/mc00198-008-ff0051-000-001_0001/info.json

1. How many tiles would you need to show the full image?

If you finish have a look at http://puzzle.mikeapps.me/