Mercurial > hg > digilib
annotate doc/src/site/markdown/iiif-api.md @ 1427:a244753f8f33
doc update and small cleanups.
author | robcast |
---|---|
date | Tue, 27 Oct 2015 18:44:43 +0100 |
parents | 7a2de95a7b8e |
children | 9429bb9c3a42 |
rev | line source |
---|---|
1396
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
1 # The digilib IIIF API |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
2 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
3 The Scaler servlet provides not only its native [Scaler API](scaler-api.html) but also an API compliant to the standards of the International Image Interoperability Framework http://iiif.io. |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
4 |
1427 | 5 As of version 2.3 digilib supports the [IIIF Image API version 1.1](http://iiif.io/api/image/1.1/) at [compliance level 2](http://iiif.io/api/image/1.1/compliance.html) (since V2.3.3 even for forced w,h sizes where the image will be distorted). |
1396
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
6 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
7 IIIF Image API URLs for an image request have the form: |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
8 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
9 http[s]://server/digilib-webapp/Scaler/iiif-prefix/identifier/region/size/rotation/quality[.format] |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
10 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
11 where `digilib-webapp` is the name of the digilib web application in the servlet container. |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
12 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
13 The value of `iiif-prefix` is defined by the `iiif-prefix` parameter in the [digilib-config](digilib-config.html). The default value is "IIIF". |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
14 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
15 The `identifier` part of the URL must not contain slashes. Since the identifier is mapped to the digilib fn-parameter, which is a filesystem path that likely contains slashes separating subdirectories, all occurrences of a slash have to be replaced by the value of the `iiif-slash-replacement` parameter in [digilib-config](digilib-config.html). The default value of the replacement string is "!", so the fn-path "books/book1/page0002" becomes the identifier "books!book1!page0002". |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
16 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
17 For a definition of the other request parameters `region`, `size`, `rotation`, `quality`, and `format` please see the [IIIF Image API docs](http://iiif.io/api/image/1.1/). |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
18 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
19 A IIIF Image API image request URL could look like: |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
20 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
21 http://www.example.org/digilib/Scaler/IIIF/books!book1!page0002/full/!150,75/0/native.jpg |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
22 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
23 An info request URL for the same image looks like: |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
24 |
7a2de95a7b8e
documentation updated with Ubbo's codec tuning tips and IIIF API info.
robcast
parents:
diff
changeset
|
25 http://www.example.org/digilib/Scaler/IIIF/books!book1!page0002/info.json |