Div | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
...
In production IDS: https://ids.lib.harvard.edu/ids/view/[prod DRS file ID]
E.g.: https://ids.lib.harvard.edu/ids/view/1639647In qa/test IDS: https://ids-qa.lib.harvard.edu/ids/view/[qa DRS file ID]
E.g.: https://ids-qa.lib.harvard.edu/ids/view/402065473
Note: All still images deposited to DRS with role=delivery are automatically assigned a delivery URN that points to an IDS static url. It is recommended that you use the IDS urn to refer to still images in catalog records and web sites.
For example, a static view of still image #1639647 can be delivered using an IDS url or preferably, a persistent IDS urn. The following image links:
https://ids.lib.harvard.edu/ids/view/1639647
https://nrs.lib.harvard.edu/urn-3:fhcl.hough:408019
will deliver a static image to the browser:
...
w (width), h (height) in pixels:
https://ids.lib.harvard.edu/ids/view/50784373?width=1200 (height is calculated proportionally)
https://ids.lib.harvard.edu/ids/view/50784373?width=150&height=150 (thumbnail-sized)
https://nrs.lib.harvard.edu/urn-3:rad.schl:14434437?width=150&height=150 (parameter appended to IDS urn)rotation (rotate image 90, 180, or 270 degrees to the right):
https://ids.lib.harvard.edu/ids/view/452251552?rotation=90
https://nrs.lib.harvard.edu/urn-3:hul.guest:37292872?rotation=90html=y (wraps image within HTML table; disables browser auto-scaling to window size) https://ids.lib.harvard.edu/ids/view/50784373?html=y
https://nrs.lib.harvard.edu/urn-3:hul.guest:37292872?html=yCombining parameters:
https://ids.lib.harvard.edu/ids/view/452251552?rotation=90&width=1000&html=y
https://nrs.lib.harvard.edu/urn-3:hul.guest:37292872?rotation=90&width=1000&html=ybuttons=y (displays image in the HL Viewer; can’t be combined with other url parameters)
https://ids.lib.harvard.edu/ids/view/50784373?buttons=y
https://nrs.lib.harvard.edu/urn-3:hul.guest:37292872?buttons=y
Both links above resolve to this iiif url:
https://iiif.lib.harvard.edu/manifests/view/ids:50784373
Linking to a dynamic image in the HL Viewer
...
To create a dynamic IDS url, append the buttons=y parameter to a static IDS url or IDS urn, e.g.:
https://ids.lib.harvard.edu/ids/view/1639647?buttons=y
https://nrs.lib.harvard.edu/urn-3:fhcl.hough:408019?buttons=y
Below is a screenshot of still image #1639647 displaying in the HL Viewer:
...
Notice that the dynamic IDS url resolves to a different url format:
https://iiif.lib.harvard.edu/manifests/view/ids:1639647
The “iiif.lib.harvard.edu” url is the address of the backend iiif server that provides the HL Viewer user interface. While this address can be bookmarked and is reasonably persistent, it is recommended that permanent links to a dynamic image in a catalog record or web site use the IDS urn, e.g.:
https://nrs.lib.harvard.edu/urn-3:fhcl.hough:408019?buttons=y will resolve to https://iiif.lib.harvard.edu/manifests/view/ids:1639647
Note that the “iiif.lib.harvard.edu” url format for a dynamic image does not accept IDS url parameters.
...
IDS also supports links that conform to the International Image Interoperability Framework (IIIF) Image API.
IIIF is a set of community supported APIs that allow any image viewing application that supports the standard to embed digital image content from any supporting institution in their applications. The HL Viewer for still images uses this API to display highly zoomable images from the DRS.
See Linking to images using the IIIF Image API for more information.
Captions for still images
...
By default, this caption will include the owning organization’s name (prefixed by “Harvard University”), a comma and the DRS file object owner supplied name of the image. Even if caption display is turned off in DRS metadata, this default caption will display in the HL Viewer. If custom caption text is defined in DRS metadata, IDS will use it instead of the default.
...