Skip to content

Commit c8c0d4a

Browse files
author
Rob Sanderson
committed
Update Image Api Selector definition to not rely on existence of a service
1 parent 63fa3d1 commit c8c0d4a

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

source/presentation/4.0/model.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -627,11 +627,10 @@ An Animation Selector _MAY_ have the following properties: [id](#id)
627627
{: #ImageApiSelector}
628628
> `"type": "ImageApiSelector"`
629629
630-
The Image API Selector is used to describe the operations available via the IIIF Image API in order to retrieve a particular image representation. In this case the resource is the abstract image as identified by the [IIIF Image API][image-api] base URI plus identifier, and the retrieval process involves adding the correct parameters after that base URI.
630+
The Image API Selector is used to describe the operations expected to occur via the definitions of the IIIF Image API. This can be used with IIIF Image API services in order to retrieve a particular image representation, but also can be applied client side on static images, such as to process rotation via CSS. In this case the resource is the abstract image as identified by the [IIIF Image API][image-api] base URI plus identifier, and the retrieval process involves adding the correct parameters after that base URI.
631631

632-
The Image API Selector has properties following the parameters from the API, and record the values needed to fill out the URL structure in the request. If the property is not given, then a default should be used.
632+
The Image API Selector has properties following the parameters from the API, and record the values which would be used to fill out the URL structure in the request if a service is available. If the property is not given, then a default should be used.
633633

634-
> TODO: RS thinks this needs `version` to interpret ^ correctly, which changed between 2.1 and 3.0
635634

636635
| Property | Default | Description |
637636
| -------- | --------- | ----------------------------------------------------- |
@@ -640,6 +639,7 @@ The Image API Selector has properties following the parameters from the API, and
640639
| rotation | "0" | The string to put in the rotation parameter of the URI. Note that this must be a string in order to allow mirroring, for example "!90". |
641640
| quality | "default" | The string to put in the quality parameter of the URI. |
642641
| format | "jpg" | The string to put in the format parameter of the URI. Note that the '.' character is not part of the format, just the URI syntax. |
642+
| version | "2.1" | The string representation of a published version number in "major.minor" form of the IIIF Image API. If the version given in the Selector differs from the version exposed by a Image API service, the client is expected to translate between versions as possible. |
643643

644644
__Properties__<br/>
645645
A IIIF Image API Selector _MUST_ have the following properties: [type](#type).<br/><br/>
@@ -2842,6 +2842,10 @@ Embedded CssStylesheet, Selector or TextualBody `value`:
28422842
{ "value": "Example Textual Body" }
28432843
```
28442844

2845+
### version
2846+
2847+
> TODO: write me
2848+
28452849

28462850
### via
28472851

0 commit comments

Comments
 (0)