Hands on with IIIF in InvenioRDM

You will need:

• An account on this InvenioRDM instance - you can create an account here.
• Some images to test with:
  • 3-5 relatively large images (up to 100MB). GIF, JPEG, JPEG2000, PNG or TIFF format.
  • Sample images are provided, or you can use your own

Note: Any images you upload will be available publicly on this instance -

• Please do not create any rights issues
• Please do not enter any metadata you don’t wish to be publicly viewable (use a false name if you wish.)

Upload and publish a record with images

• Click on the + icon in the top-right and select New upload
• Add some image files to the record by dragging and dropping (or use the Upload files button)
  • The files should be named in the order you wish them to be presented, eg “page-001.jpg”, “page-002.jpg”…
• While the files upload, add basic metadata. InvenioRDM requires at a minimum:
  • Title
  • Creator
  • Resource Type
  • Publication date
• For this exercise, it doesn’t matter what metadata you enter - but the required fields must be completed. It is suggested you enter your own name as creator so you can easily search for your record later.
• Once the images have completed uploading, you can click Publish. You will redirected to the published record’s view.

View in InvenioRDM

This instance has been customised with an embedded Mirador plugin, used to view images. It supports pan+zoom of large images - use your mouse/trackpad to zoom in and move around the image.

Note that on first viewing, images may take a short time to be generated. This effect may be worsened by many users attempting this at once!

View using the IIIF Image API

• All images in a public record are available via IIIF - look at the list of attached files and click IIIF link to open the Image in a new tab via IIIF.
• Note the form of the IIIF API URL
  • https://or2023.hasdai.org/api/iiif/record:3bm5q-yms24:BAU_1_000178568_1734_0001.tif/full/800,/0/default.jpg
  • full represents the region of the image
  • 800, signifies the image should be reduced to 800px wide, maintaing aspect ratio.
    • Try changing to a larger/smaller value.
    • Try changing to pct:10 or pct:80
  • 0 represents the rotation of the image
    • Try changing the value to 180
    • Try changing the value to 45
  • default is the image quality (colour depth)
  • try gray
  • jpg IIIF can also be used to change the output image format
    • try gif and/or png

View in an external viewer application

• All records with images attached are available as an IIIF Presentation manifest. This is used to describe a set of images to an IIIF enabled viewer such as Mirador or Universal Viewer
  • Go back to your record page.
  • In the right hand column, click on IIIF Manifest to view the manifest.
  • The URL can be copied from the address bar into external IIIF viewers, eg
    • Go to the Mirador demo site
      • click Add Resource (top-left)
      • click + Add Resource (bottom-right)
      • paste in the manifest URL and click add
      • the manifest will be loaded alongside the other preconfigured manifests in the Mirador menu
    • Go to the Universal Viewer demo site
      • click VIEW IIIF MANIFEST
      • paste your manifest URL into this box
      • Click View