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.
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
servertoiiif-staging02.lib.ncsu.eduand 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.
Challenge: 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
- 7a6a2b0c-45be-488e-57f5-7e053950dffb
- df09d399-a5ff-703f-fb3b-eb4997292dab
- c4918c92-8ba7-ff0e-f231-c91cbb843b42
- 3a8b3bbd-9bd2-43b5-aec2-f22b6d55cdf1
- 6b49e314-cd19-4f7d-b4c8-67f83c8ce4a0
- 163e36f8-ae93-898a-a79c-9410e899053a
- d8b6266f-2137-899b-f54a-633f34f922b2
- e12ad718-70ed-98e2-24ab-829696f68a01
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.
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.