This is a beta version of migrating these workshop materials to a new platform. If you run into issues please file an issue or click on the edit link above and submit a pull request. You can use the previous version of the workshop materials as a fallback.

Image Annotation

http://iiif.io/api/presentation/2.1/#image-resources

An image is associated with a canvas via an annotation.

images

First create an images property in your canvas and make the value a list/array:

{
  "@type": "sc:Canvas",
  "@id": "http://localhost:3000/segPap_022/canvas/1",
  "label": "22",
  "width": 6099,
  "height": 8599,
  "images": [ ]
}

Add an Annotation

IIIF uses the Open Annotation Data Model in version 2 of the Presentation API. (Presentation 3 will use Web Annotation.)

Here are the properties and values we’ll add to each annotation in the images list. While in this case we’ll only add one image, it is possible to add more than one.

The image itself will be linked to from the resource property of the annotation.

property value
@type oa:Annotation
motivation sc:painting
on The URI for the canvas
resource an image object (see next section) 
{
  "@type": "sc:Canvas",
  "@id": "http://localhost:3000/segPap_022/canvas/1",
  "label": "22",
  "width": 6099,
  "height": 8599,
  "images": [
    {
      "@type": "oa:Annotation",
      "motivation": "sc:painting",
      "on": "http://localhost:3000/segPap_022/canvas/1",
      "resource": {}
    }
  ]
}

Manifest with Canvas with Painting Annotation

And here’s what our whole manifest looks like with the canvas expanded in this way.

{
  "@context": "http://iiif.io/api/presentation/2/context.json",
  "@type": "sc:Manifest",
  "@id": "http://localhost:3000/manifest.json",
  "label": "Papillons",
  "description": "Four patterns inspired by butterflies.",
  "attribution": "Special Collections Research Center at NCSU Libraries",
  "logo": "http://localhost:3000/logo.jpg",
  "sequences": [
    {
      "@type": "sc:Sequence",
      "canvases": [
        {
          "@type": "sc:Canvas",
          "@id": "http://localhost:3000/segPap_022/canvas/1",
          "label": "22",
          "width": 6099,
          "height": 8599,
          "images": [
            {
              "@type": "oa:Annotation",
              "motivation": "sc:painting",
              "on": "http://localhost:3000/segPap_022/canvas/1",
              "resource": {}
            }
          ]
        }
      ]
    }
  ]
}