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.

Play with Parameters

Now we will play with different parameters.

You’ll use this base URI and add the other parameters on: https://iiif.lib.ncsu.edu/iiif/segPap_021

Here’s the URI template you’ll use:

https://iiif.lib.ncsu.edu/iiif/segPap_021/{region}/{size}/{rotation}/{quality}.{format}

In a text editor copy the template above and begin filling in different values for the region, size, rotation, quality, and format.

All the example values below ought to work with this particular image. Links to the standard documentation are given for each of the parameters.

It may be easier to see what’s happening with some of the other parameters if you use a “full” region.

When viewing an image in the Firefox and Chrome web browsers the title bar will tell you the width x height of the image in pixels.

Note not all image servers will support all variations of all parameters. Later we’ll cover levels of compliance to explain why.

Questions

Here are some questions you can ask yourself as you try out the examples:

  • Which parameters might you use to create a thumbnail for a search index or browse view?
  • How would you get the full image to fit within a 500 by 500 pixel space regardless of the orientation of the image?
  • If you were creating a deep zoom viewer that used tiles, how might you go about creating the image URLs you need?
  • How would you create a square image? When might this be useful?

Region

http://iiif.io/api/image/2.1/#region

form examples
full full
square square
x,y,w,h 327,263,4004,4595
319,4855,1079,2847
4348,215,1542,3807
pct:x,y,w,h pct:5,3,66,53

Size

http://iiif.io/api/image/2.1/#size

Try each of the following forms for size to see how images can be scaled.

form examples
full full
max max
w, 600,
125,
,h ,600
,125
pct:n pct:15
w,h 610,859
610,85
!w,h !200,200
!200,300
!610,85

Rotation

http://iiif.io/api/image/2.1/#rotation

To see how rotation works it can be helpful to have a non-rotated version up as well your rotated and/or mirrored version.

form examples
n 0
!90
45
!n !0
!90

Quality

http://iiif.io/api/image/2.1/#quality

Valid values are: color, gray, bitonal, default.

Try changing the server to iiif-staging02.lib.ncsu.edu and using these values for quality: dither, pixelized, negative. These are non-standard, but fun!

Format

http://iiif.io/api/image/2.1/#format

Possible values for this image server: jpg and png.

Other Images

You can also try manipulating these other images. Given is the scheme, server, and prefix then a list of image identifiers.

Start with the base URI add the image identifier and then add on the different Image API parameters.

Try to use the region parameter to get a particular section of the image like a face or a painting in a painting.

NCSU Libraries https://iiif.lib.ncsu.edu/iiif

Getty https://data.getty.edu/museum/api/iiif/`

Art Institute of Chicago https://lakeimagesweb.artic.edu/iiif

Frick Collection http://collections.frick.org/apis/iiif/image/v2/

Bodleian http://iiif.bodleian.ox.ac.uk/iiif/image/

Princeton Libraries https://libimages.princeton.edu/loris/

Wellcome https://dlcs.io/iiif-img/wellcome/1/

Parameters Playground

You may also want to try using this tool to play around with parameters.

Image API Playground

Or use this example image to play with parameters: https://jsfiddle.net/mejackreed/r3a5ayhe/2/. You’ll need to click “run” after you make changes to see the result.